⚑ Requisito previo: acceso de Superusuario.
Este artículo explica cómo aplicar el protocolo SCIM.
Una vez activada la integración SCIM, su departamento de TI podrá controlar directamente desde su sistema de administración de identidades:
- La creación, modificación y desactivación de usuarios;
- El nivel de acceso de estos usuarios, asignándoles proyectos y perfiles (ambos son grupos en el protocolo SCIM).
Configuración en Borealis
1. Desde el Menú principal, diríjase a Usuarios > Configuración de autenticación:
2. Seleccione SCIM a la izquierda. En el recuadro, haga clic en el lápiz para editar:
3. Marque la casilla para habilitar el aprovisionamiento SCIM y haga clic en el botón Guardar:
4. Estos dos elementos de información aparecerán en la parte inferior de la página:
- La confirmación de que el aprovisionamiento SCIM está habilitado;
- La URL de aprovisionamiento en el banner, junto con un token de autenticación. Este token debe copiarse de inmediato, ya que estos valores serán necesarios al configurar el servicio de administración de identidades.
ⓘ Nota: Si se pierde el token, debe deshabilitar el aprovisionamiento SCIM y volver a habilitarlo. Se le proporcionará entonces un nuevo token. Esto también significa que el anterior quedará deshabilitado, por lo que cualquier integración configurada previamente con el token anterior dejará de funcionar.
Configuración en el servicio de administración de identidades
Diríjase a su servicio de administración de identidades (por ejemplo, Entra ID - Microsoft Azure Active Directory) y siga las instrucciones para completar la configuración. Estas instrucciones pueden variar según su servicio de administración de identidades.
-
Configure la conectividad
- Ingrese:
- URL de inquilino (URL base de SCIM)
- Token secreto
- Seleccione Probar conexión para verificar la comunicación entre Microsoft Entra ID y la aplicación.
- Guarde la configuración.
- Ingrese:
-
Asigne usuarios y grupos
- Abra el servicio de administración de identidades.
- Seleccione Usuarios y grupos.
- Elija Agregar usuario o grupo.
-
Asigne los usuarios y grupos que deben aprovisionarse en la aplicación.
Microsoft Entra ID
-
Configure las asignaciones de atributos
- Abra el servicio de administración de identidades.
- Seleccione Asignación de atributos.
- Agregue las asignaciones para usuarios y grupos.
- Asigne una precedencia de coincidencia a sus atributos. La precedencia de coincidencia determina el orden en que Microsoft Entra ID comprueba los atributos de usuario para encontrar una cuenta existente en la aplicación de destino, lo que ayuda a evitar cuentas duplicadas.
| Atributo SCIM asignado | Atributo de Microsoft Entra ID | Precedencia de coincidencia |
| userName | userPrincipalName | 1 |
| name.givenName | givenName | |
| name.familyName | surName | |
| emails[type eq "work"].value | ||
| manager | manager | |
| active | isSoftDeleted (valor calculado que no se almacena en el usuario) |
Atributo SCIM asignado |
Atributo de Microsoft Entra ID | Precedencia de coincidencia |
| externalId | objectId | 1 |
| displayName | displayName | |
| members | members |
ⓘ Nota:
1. La asignación anterior puede variar según su servicio de administración de identidades.
2. El objectID del grupo representa el identificador único de SCIM en Borealis.
-
Habilite el aprovisionamiento
Antes de habilitar el aprovisionamiento automático, utilice Aprovisionar a petición para probar sus asignaciones de atributos y verificar que los usuarios se puedan aprovisionar correctamente en la aplicación.
Una vez finalizadas las pruebas, habilite el aprovisionamiento automático:
- Abra el servicio de administración de identidades.
- Seleccione Aprovisionamiento.
- Seleccione Automático como Modo de aprovisionamiento.
- Establezca el Estado de aprovisionamiento en Activado.
- Guarde la configuración.
ⓘ Nota: Microsoft Entra ID comenzará a programar trabajos de sincronización para aprovisionar usuarios y grupos.
Lista de operaciones compatibles
| Punto de conexión | Operación | Detalles |
| /Users | GET |
GET /Users: Recuperar la lista completa de usuarios GET /Users/{id}: Recuperar el usuario con el ID correspondiente GET /Users?filter=userName eq “XXXXXXX”: Recuperar el usuario con el userName correspondiente |
| /Users | POST | Crear un nuevo usuario |
| /Users | DELETE | DELETE /Users/{id}: Eliminar el usuario con el ID correspondiente |
| /Users | PUT/PATCH | PATCH o PUT /Users/{id}: Actualizar el usuario con el ID correspondiente |
| /Groups | GET |
GET /Groups: Recuperar la lista completa de grupos GET /Groups/{id}: Recuperar el grupo con el ID correspondiente.
|
| /Groups | PATCH | PATCH /Groups/{id}: Utilizar las operaciones add o remove para agregar miembros al grupo o quitar usuarios de él. |
| /ServiceProviderConfig | GET | Recuperar la configuración |
| /ResourceTypes | GET | Recuperar la lista de tipos de recursos compatibles |
| /Schemas | GET | Recuperar la lista de esquemas |
ⓘ Nota:
Todos los perfiles y todos los accesos a proyectos serán grupos en SCIM.
Por ejemplo, estos son grupos:
• SE - Data Entry
• Transmission line (Read-only)
• Transmission line (Full access)
Para obtener más información, consulte los artículos sobre Perfiles y proyectos y sobre cómo crear perfiles personalizados.