Configura el aprovisionamiento automático de usuarios con perfiles de SCIM personalizados (beta)

El aprovisionamiento automatizado de usuarios con perfiles de SCIM personalizados es una función beta disponible solo para una cantidad limitada de participantes. Si no ves la opción de aprovisionamiento automático en la página de detalles de la app, significa que aún no está disponible para tu organización.

Puedes configurar y administrar automáticamente cuentas de usuario en una app de SAML preintegrada o personalizada que admita SCIM 2.0 con el aprovisionamiento automático de usuarios con perfiles de SCIM personalizados.

Antes de comenzar

Para configurar un perfil de SCIM personalizado, debes tener lo siguiente:

• Una cuenta de Cloud Identity con un rol de administrador avanzado Para obtener más información, consulta Roles de administrador predefinidos.
• Una app de SAML personalizada o preintegrada configurada y activada para los usuarios en la Consola del administrador

Tu app debe tener un servidor SCIM que cumpla con los siguientes requisitos:

• Admite la versión 2.0 de SCIM
• Usa métodos HTTP estándar, incluidos POST, GET, PATCH con resguardo a PUT y DELETE
• Admite la autenticación con token del portador. No se admite la autenticación con tokens de OAuth.

Configura el aprovisionamiento automático de usuarios con un perfil de SCIM personalizado

1. En la Consola del administrador de Google, ve a Menú Apps Apps web y para dispositivos móviles.

   Ir a Aplicaciones web y para dispositivos móviles

   Debes acceder como administrador avanzado para realizar esta tarea.

2. Haz clic en el nombre de tu app de SAML.
3. En Aprovisionamiento automático, haz clic en Configurar aprovisionamiento automático.
4. Ingresa el token del portador de tu app en Token de acceso y, luego, haz clic en Continuar.
5. Ingresa la URL del extremo de SCIM de tu app en el campo URL del extremo y, luego, haz clic en Continuar. Google se conecta a tu extremo de SCIM para descubrir automáticamente los atributos compatibles.
6. Asigna los atributos de tu directorio de Google a los atributos de la app correspondientes. Si tu app admite el descubrimiento de esquemas, la tabla se prepropaga con los atributos descubiertos. Para asignar atributos personalizados de forma manual, haz clic en Agregar asignación Continuar cuando termines.
7. (Opcional) Si no agregas ningún grupo, se aprovisionarán todos los usuarios que tengan acceso a la app de SAML. Para limitar el aprovisionamiento automático a grupos de usuarios específicos, sigue estos pasos:
   • En Buscar grupos, ingresa una o más letras del nombre del grupo, selecciona el nombre del grupo y elige un alcance.
   • Agrega los grupos adicionales.
   • Para quitar un grupo, haz clic en Quitar (opcional).
     Si un grupo tiene usuarios de un dominio secundario o de fuera de tu organización, no se aprovisionarán esos usuarios.
8. Decide cuánto tiempo los usuarios conservarán el acceso a la app después de que se desactive para ellos o después de que se suspenda o borre su cuenta de Google Workspace. Puedes suspender su cuenta, borrarla de forma definitiva o suspenderla y, luego, borrarla de forma definitiva. Puedes establecer el período de retraso de forma individual para cada acción.
   1. Elige las opciones para cada uno de estos eventos, según sea necesario:
      • Cuando se desactiva una app para un usuario
      • Cuando se suspende a un usuario de Google
      • Cuando se borra un usuario de Google
        Si suspendes una cuenta de usuario, se marcará como desactivada. Si borras de forma definitiva la cuenta de usuario, se quitará de forma permanente de la app. Siempre establece más tiempo antes de borrar de forma definitiva la cuenta de un usuario. Para obtener detalles sobre la suspensión y la eliminación, consulta Cómo editar los plazos de desaprovisionamiento.
   2. Haz clic en Continuar.

9. Prueba la conexión:

   1. En Usuario del Directorio de Google, busca y selecciona un usuario que no tenga una cuenta en tu app.

   2. Haz clic en Probar.
      

      Google crea una cuenta para el usuario en tu app, la actualiza y, luego, la borra. Cada operación muestra Correcto, Con errores o No se ejecutó. En el caso de una operación con errores, revisa el código HTTP, el tipo de error de SCIM y los detalles de Ver respuesta sin procesar de tu app.
      

      Nota: Si tu app no devuelve 201 Created para el usuario nuevo, por ejemplo, porque el usuario ya existe, se produce un error en Crear usuario y Google omite las operaciones de actualización y eliminación. Si falla la opción Borrar usuario, borra la cuenta de prueba en tu app de forma manual.

10. Haz clic en Finalizar.
    Puedes hacer clic en Finalizar incluso si la prueba falló y volver a realizarla más tarde. En este paso, se guarda la configuración, pero no se activa el aprovisionamiento automático. Para activarlo, ve a la página de detalles de la app Aprovisionamiento automático y establece el botón de activación en Activo.
    Nota: El parámetro de configuración se inhabilita si la app no está activada para ningún usuario. Haz clic en Acceso de usuarios y activa la app para habilitar la activación del aprovisionamiento automático.

Editar la información de aprovisionamiento

Desactiva el aprovisionamiento automático y borra la información de configuración

Puedes desactivar el aprovisionamiento automático de la app sin perder la información de configuración. También puedes desactivar el aprovisionamiento automático y quitar toda la información de configuración.

Revisa la información de uso

• Después de activar el aprovisionamiento automático, puedes revisar la información de uso. Para obtener más detalles, consulta Supervisa el aprovisionamiento automático de usuarios.
• Puedes revisar la siguiente información de uso de los últimos 30 días:

Evento de registro de administrador	Descripción
Crear un usuario mediante el aprovisionamiento automático	Usuarios creados por aprovisionamiento automático
Actualizar el usuario aprovisionado automáticamente	Usuarios actualizados por aprovisionamiento automático
Suspender el usuario aprovisionado automáticamente	Usuarios suspendidos por el aprovisionamiento automático
Anular la suspensión del usuario aprovisionado automáticamente	Usuarios reactivados por aprovisionamiento automático
Eliminación definitiva del usuario aprovisionado automáticamente	Usuarios borrados por el aprovisionamiento automático
Errores	Solicitudes con errores

Si el aprovisionamiento automático deja de funcionar

El aprovisionamiento automático deja de funcionar si Google ya no puede conectarse a tu app. Por ejemplo, es posible que el token del portador haya vencido o se haya revocado, o que la URL de SCIM de la app haya cambiado. Para corregirlo, actualiza el token o la URL:

1. En la Consola del administrador de Google, ve a Menú Apps Apps web y para dispositivos móviles.

   Ir a Aplicaciones web y para dispositivos móviles

   Debes acceder como administrador avanzado para realizar esta tarea.

2. Haz clic en el nombre de tu app de SAML.
3. Haz clic en Aprovisionamiento automático.
4. Para actualizar el token del portador, haz lo siguiente:
   1. En Autorización de la app, haz clic en Volver a autorizar.
   2. En Token de acceso, pega un nuevo token del portador de tu app.
   3. Haz clic en Volver a autorizar.
5. Para actualizar la URL base de SCIM, en URL del extremo, haz clic en Editar, ingresa la URL nueva y, luego, haz clic en Actualizar.
6. Para verificar la conexión, en Probar conexión, haz clic en Probar (opcional).

Para obtener detalles sobre otros motivos por los que el aprovisionamiento automático podría dejar de funcionar, consulta la documentación de la app.