Aprovisionamiento de usuarios SCIM mediante el cliente SCIM de ASP.NET con WordPress
Resumen
El Cliente SCIM de ASP.NET permite el aprovisionamiento y la sincronización automatizados de usuarios entre WordPress y su aplicación ASP.NET. SCIM (Sistema de gestión de identidad entre dominios) Es un estándar abierto que se utiliza para gestionar de forma segura las identidades de los usuarios en diferentes sistemas. Mediante esta integración, las operaciones de usuario, como crear, actualizar y eliminar, se pueden gestionar de forma eficiente. Siga la guía paso a paso que aparece a continuación para configurar el aprovisionamiento de usuarios SCIM mediante el cliente SCIM de ASP.NET.
Requisitos previos: descarga e instalación
- Inicie sesión para http://portal.miniorange.com/ y navegue hasta la sección Descarga pestaña. Desde allí, localice el complemento que compró y haga clic en Descargar Plugin para descargar el archivo zip del complemento.
- Extraiga el archivo zip descargado en su máquina y coloque el archivo del paquete nuget (archivo .nupkg) en una carpeta como "C:\miniOrangePackages"
- Ejecute el siguiente comando en su terminal VS para agregarlo como fuente de paquete:
dotnet nuget add source C:\miniOrangePackages--name miniOrangePackage
- Abra su proyecto en la terminal:
cd C:\Path\To\YourProject
- Instale el paquete en su proyecto usando el siguiente comando:
dotnet add package miniOrange.SCIM.Client --source miniOrangePackage
OR
- Después de colocar el paquete NuGet (archivo .nupkg) en una carpeta local, en lugar de usar la terminal, también puede instalarlo usando Visual Studio siguiendo los pasos a continuación:
- Abra su aplicación .NET en Visual Studio, haga clic en Accesorios en la barra de navegación superior y navegue hasta Administrador de paquetes NuGet → Administrar paquetes NuGet para la solución.
- Se abrirá una nueva ventana; haga clic en el icono de engranaje junto al menú desplegable Fuente del paquete.
- Se abrirá una ventana emergente; seleccione Fuentes de paquetes Desde el panel de navegación izquierdo, haga clic en el signo más (+) icono, introduzca un nombre Para la fuente del paquete, proporcione la ruta de la carpeta donde colocó el paquete NuGet en el Fuente campo, luego haga clic en Actualizar y finalmente haga clic OK para guardar los cambios, como se muestra en la imagen.
- Después de cerrar la ventana emergente, seleccione la fuente del paquete recién agregado desde la Fuente del paquete desplegable.
- Ahora haga clic en Explorar de Elementos, busque miniOrange.SCIM.Cliente, seleccione el paquete de los resultados y haga clic en Instalar.
- Nota: Para integrar el cliente SCIM ASP.NET de miniOrange en su aplicación, deberá agregar los siguientes espacios de nombres, servicios y configuraciones HTTP a su proyecto. A continuación, se muestra una implementación de ejemplo como referencia.
Incluya solo la sección resaltada a continuación en el Program.cs archivo de su solicitud.
using miniOrange.SCIM.Client.DependencyInjection;
using miniOrange.SCIM.Client.Middleware;
var builder=WebApplication.CreateBuilder(args);
builder.Services.AddRazorPages();
builder.Services.AddControllersWithViews();
builder.Services.AddSCIMClientServices();
var app = builder.Build();
if(!app.Environment.IsDevelopment())
{
app.UseExceptionHandler("/Error");
app.UseHsts();
}
app.UseHttpsRedirection();
app.UseRouting();
app.UseAuthorization();
app.MapRazorPages();
app.UseCookiePolicy();
app.UseAuthentication();
#if NET9_0_OR_GREATER
app.MapStaticAssets();
#else
app.UseStaticFiles();
#endif
app.UseSCIMClientMiddleware();();
app.Run();
Pasos de configuración
Guía paso a paso para la configuración del cliente ASP.NET SCIM utilizando WordPress como fuente de aprovisionamiento.
1. Acceda al panel de control del cliente SCIM de .NET.
- Tras la integración, abra su navegador y acceda al panel de control del cliente SCIM mediante la siguiente URL:
https://your-app.com/?scimaction=config
- Si se abre la página de configuración, significa que el cliente SCIM de miniOrange se ha integrado correctamente en su aplicación.
- En la página de configuración de la base de datos del cliente SCIM, encontrará dos métodos de configuración para configurar la conexión a la base de datos. Puede seleccionar entre cadenas de conexión existentes or configurar la conexión manualmente Según la configuración de su aplicación.
Seleccione entre las cadenas de conexión disponibles.
- Seleccione su cuenta en Proveedor de base de datos desde el menú desplegable (p. ej., SQL Server, MySQL, PostgreSQL, SQLite) Según la configuración de su aplicación.
- Elija una Cadena de conexión disponible del menú desplegable (por ejemplo, DefaultConnection) que ya está configurado en su aplicación.
- Haga clic en Guardar configuración y luego en Conexión de prueba para verificar la conectividad de la base de datos. Una vez que la conexión sea exitosa, haga clic en Siguiente para seguir adelante.
OR
Configurar manualmente
- Seleccione su cuenta en Proveedor de base de datos e ingrese los detalles de la base de datos requeridos, como Servidor, Puerto (opcional), Nombre de la base de datos, Nombre de usuario y Contraseña. También puede habilitar Usar Seguridad integrada (autenticación de Windows) si es aplicable.
- Active la característica de “Tengo la cadena de conexión” Active esta opción si desea proporcionar la cadena de conexión completa directamente en lugar de introducir los campos individualmente.
- Haga clic en Guardar configuración y luego en Conexión de prueba para verificar la conectividad de la base de datos. Una vez que la conexión sea exitosa, haga clic en Siguiente para seguir adelante.
- Tras hacer clic en Siguiente, se le redirigirá a la página de inicio de sesión. Inicie sesión con su cuenta miniOrange autorizada para continuar configurando el cliente SCIM.
- Después de iniciar sesión, el Activación de licencia Se abrirá el panel de control. Introduzca la clave de licencia para activar el complemento, que recibirá tras iniciar sesión. portal.miniorange.com y navegando a Administrar licencia → Claves de licencia.
- Luego, marca la casilla "He leído las condiciones anteriores y quiero activar el plugin"., Y haga clic en Activar licencia .
- Una vez que la licencia se haya activado correctamente, se abrirá el panel de configuración de SCIM.
- Abre tu navegador y accede a la página de inicio de sesión de administración de WordPress.
https://your-wordpress-site.com/wp-admin
- Ingrese su Nombre de usuario o correo electrónico y Contraseña, luego haz clic en Iniciar Sesión Botón para acceder al panel de administración de WordPress.
- Después de iniciar sesión, será redirigido al Panel de administración de WordPress. En la barra lateral izquierda, haga clic en Aprovisionamiento de usuarios SCIM para abrir el complemento.
- Una vez dentro del complemento, desplácese hacia abajo hasta el Credenciales API SCIM sección. Copia el URL base de SCIM y Token de portador SCIM y tenlas a mano, ya que las necesitarás en el siguiente paso.
- Ahora, vuelve a tu Cliente SCIM .NET tablero y navegue hasta el Configuración SCIM pestaña. Pegue lo copiado URL base de SCIM dentro del URL del punto final de SCIM campo y el Token de portador SCIM dentro del Token de portador .
- Una vez hecho esto, haga clic en Guardar configuración y luego en Conexión de prueba para verificar la configuración.
- Una vez establecida la conexión correctamente, aparecerá una ventana emergente de confirmación que mostrará: Conexión exitosa. Haga clic en OK para continuar.
3. Mapeo de atributos
- Navegue a la pestaña Asignaciones de atributos pestaña de la barra lateral izquierda. Seleccione la tabla de la base de datos (por ejemplo, Usuarios) del menú desplegable y haga clic Guardar.
- Mapa de cada uno Atributo de origen (usuario) a su correspondiente Atributo objetivo (SCIM) seleccionando la columna de base de datos apropiada de la Buscar o seleccionar columna menú desplegable para cada fila.
- Nota: : El atributo de destino se refiere al campo del esquema SCIM estándar al que se asignará el valor de la columna de su base de datos.
- Para agregar una asignación de atributos personalizada (por ejemplo, Número de teléfono), haga clic en el + Agregar mapeo Pulse el botón y configure los atributos de origen y destino según sea necesario.
- Una vez que se hayan configurado todas las asignaciones, haga clic en Guardar todos los mapas para guardar los cambios.
Asignaciones de grupo
Si su proveedor de identidad admite el aprovisionamiento de grupos, puede configurar asignaciones de grupos para sincronizar los grupos de su aplicación con WordPress.
- Navegue a la pestaña Asignaciones de grupo pestaña de la barra lateral izquierda. Debajo Tabla de gruposSeleccione la tabla de la base de datos que contiene la información de su grupo y haga clic. Guardar.
- Del mismo modo, bajo Columna de identificador de grupoSeleccione la columna que sirve como identificador del nombre del grupo y haga clic. Guardar.
- En la sección Asignaciones de atributos de grupo sección, mapear cada Atributo de origen (grupo) a su correspondiente Atributo objetivo (SCIM), que hace referencia al campo del esquema SCIM estándar al que se asignará el valor de la columna de su grupo.
- Para agregar una asignación de atributos personalizada, haga clic en el + Agregar mapeo botón. Una vez hecho esto, haga clic. Guardar asignaciones para guardar los cambios.
- Desplácese hacia abajo hasta la sección Asignación de nombres de roles sección. Si los nombres de grupo en su aplicación difieren de los del servidor, desactive la Los grupos son iguales a los del servidor. alternar y asignar los nombres de sus grupos locales a los nombres de grupos externos correspondientes en el Asignación de nombres de grupo .
- Escriba el Nombre del grupo local y la correspondiente Nombre del grupo externo en los campos proporcionados. Para agregar más asignaciones, haga clic en el + Agregar mapeo botón, y una vez hecho esto, haga clic Guardar para guardar los cambios.
- Si Los grupos son iguales a los del servidor. Si la opción está habilitada, se usarán los nombres de los grupos locales tal cual y no se requiere ninguna asignación de nombres.
4. Opciones de sincronización
- Navegue a la pestaña Opciones de sincronización pestaña de la barra lateral izquierda.
- En Configuración de sincronización de usuario, establezca el Tamaño del lote para definir el número de registros de usuario que se agruparán por operación masiva.
- También puede habilitar el Sincronizar usuarios por lotes (usar la API SCIM Bulk) toggle, que procesa varios objetos en una sola solicitud de API para una sincronización más rápida.
- Una vez configurado, haga clic en Guardar configuración.
- Nota: El tamaño del lote solo es aplicable cuando se utiliza Sincronización única or Programar sincronización.
- Sincronización en tiempo real: Active el interruptor Habilitar sincronización en tiempo real Active esta opción para permitir la sincronización en tiempo real de los cambios del usuario, como las operaciones de creación, actualización y eliminación, con el servidor SCIM a medida que se producen. Cuando esté desactivada, las operaciones de sincronización en tiempo real serán rechazadas. Haga clic aquí. Guardar configuración para aplicar los cambios.
- Sincronización única: Para realizar una sincronización inmediata y única de todos los usuarios de su Aplicación .NET al servidor SCIM, haga clic en el Realizar una sincronización única .
- Sincronización de programación: Active el interruptor Habilitar sincronización de programación active la opción para sincronizar automáticamente los usuarios de su Aplicación .NET al servidor SCIM a intervalos configurados.
- Una vez habilitado, configure el Fecha y hora de inicio para especificar cuándo debe comenzar la sincronización programada.
- Luego seleccione la sincronización Frecuencia Según sus necesidades: diaria, semanal, mensual o personalizada.
- Si selecciona Personalizado, entrar a Valor personalizado y seleccione el Unidad (p. ej., días) para definir su propio intervalo de sincronización.
- Haga clic en Guardar configuración para aplicar los cambios.
Opciones de sincronización de grupo
- Navegue a la pestaña Opciones de sincronización de grupo pestaña de la barra lateral izquierda.
- Tenga en cuenta que la sincronización de grupos requiere que las asignaciones de grupos estén configuradas en el Asignaciones de grupo pestaña de antemano.
- En Configuración de sincronización de grupo, establezca el Tamaño del lote para definir el número de registros de grupo que se agruparán por operación masiva.
- También puede habilitar el Sincronizar grupos en lotes (usar la API SCIM Bulk) toggle, que procesa varios objetos de grupo en una sola solicitud de API para una sincronización más rápida.
- Haga clic en Guardar configuración para aplicar los cambios.
- En Sincronización de grupo en tiempo real, Enciende el Habilitar sincronización en tiempo real Active esta opción para permitir la sincronización en tiempo real de los cambios de grupo, como las operaciones de creación, actualización y eliminación, con el servidor SCIM a medida que se producen.
- Cuando está desactivada, las operaciones de sincronización en tiempo real serán rechazadas. Haga clic aquí. Guardar configuración para aplicar los cambios.
Artículos Relacionados
