Gestión de usuarios de SCIM para tu organización
Después de verificar tu dominio y configurar la autenticación SAML para tu organización, puedes generar un token de la API de SCIM.
En esta página
Características
Proporcionar el token de la API SCIM a tu proveedor de servicios de identidad te permite realizar las siguientes acciones a través de tu proveedor de identidad:
- Crear usuarios
- Asignar o modificar roles de usuario
- Desactivar usuarios
Requisitos
Antes de configurar la gestión de usuarios de SCIM, debes verificar tu dominio y crear una configuración de SAML. Solo puedes gestionar usuarios que estén asociados a un dominio que hayas verificado.
Configurar gestión de usuarios de SCIM
- En el panel de control avanzado de Shopify, ve a Usuarios > Seguridad.
- En la sección Integración SCIM , haz clic en generar token de la API.
- Haz clic en Copiar para copiar el token generado en tu portapapeles.
- Proporciona el token a tu proveedor de servicios de identidad. El procedimiento para agregar el token depende del proveedor de servicios de identidad que utilices.
Completa la configuración de SCIM en Okta
- Abre la aplicación Shopify Plus.
-
Haz clic en la pestaña Iniciar sesión.
- Define el formato de usuario de la aplicación como correo electrónico.
- Haz clic en Guardar.
-
Haz clic en la pestaña Aprovisionamiento.
- Haz clic en Configurar integración de la API.
- Selecciona Activar integración de la APIy, luego, pega el token de la API en el campo indicado.
- Haz clic en Probar credenciales de la API. Si encuentras un error, verifica que hayas copiado correctamente el token de la API de tu panel de control de Shopify Plus. Si sigues encontrando errores, comunícate con atención al cliente de Shopify Plus.
- Haz clic en Guardar.
Completa la configuración de SCIM en OneLogin
- Abre la aplicación Shopify Plus.
-
Haz clic en el elemento del menú de configuración.
- En el campo Token de portador de SCIM, pega el token de la API.
- Haz clic en Guardar.
-
Haz clic en el elemento del menú Parámetros.
- Ajusta el valor predeterminado de nombre de usuario de SCIM a correo electrónico.
- Haz clic en Guardar.
Completar la configuración SCIM en Azure
- Abre la aplicación Shopify Plus.
- Haz clic en el elemento del menú Aprovisionamiento.
- Haz clic en Comenzar.
- En el menú Modo de aprovisionamiento, selecciona Automático.
- En el campo URL de inquilino, introduce la URL base
https://shopifyscim.com/scim/v2/
. - En el campo Token secreto, introduce el token de la API.
- Haz clic en el botón Probar conexión. Si encuentras un error, verifica que hayas copiado correctamente el token de la API de tu panel de control de Shopify Plus. Si sigues encontrando errores, comunícate con atención al cliente de Shopify Plus.
- Haz clic en Guardar.
- Cambia el interruptor de Estado de aprovisionamiento a Activado.
- Haz clic en Guardar.
Después de agregar tu token de la API a tu proveedor de servicios de identidad, puedes agregar o eliminar usuarios a través de ese servicio. Dependiendo del estado de ese usuario dentro de Shopify y de tu proveedor de servicios de identidad, esto puede cambiar la forma en que el usuario inicia sesión en Shopify.
Estado de usuario | Efecto dentro de Shopify |
---|---|
El usuario ya existe en tu organización | Si agregas un usuario en tu proveedor de servicios de identidad, el usuario debe iniciar sesión usando la autenticación SAML si todo lo siguiente es cierto:
|
El usuario existe en Shopify, pero no en tu organización | Si agregas un usuario en tu proveedor de servicios de identidad, el usuario se agrega a tu organización y debe iniciar sesión usando la autenticación SAML si todo lo siguiente es cierto:
|
El usuario no existe en Shopify | Si agregas un usuario en tu proveedor de servicios de identidad, el usuario se agrega a tu organización y debe iniciar sesión usando la autenticación SAML si todo lo siguiente es cierto:
|
Luego de agregar el token de la API, cuando agregues un nuevo usuario que no existía previamente en Shopify, ya sea a través de tu proveedor de servicios de identidad o desde el panel de control de la organización, el estado del nuevo usuario se establecerá como pendiente. Si se solicita al usuario que inicie sesión a través de SAML, su estado se mantendrá como pendiente hasta que inicie sesión usando tu proveedor de servicios de identidad.
Asignación de roles en SCIM
Luego de completar la configuración de SCIM, tienes la opción de asignar roles a los usuarios de SCIM a través de tu proveedor de servicios de identidad. Antes de asignar un rol a un usuario, verifica que dicho rol existe en tu organización. Los usuarios de SCIM ya existentes no se actualizarán si el rol no se creó para tu organización.
Asignar roles en los proveedores de servicios de identidad compatibles
Se agregó compatibilidad con la asignación de roles a las aplicaciones OneLogin y Okta. En el caso de la aplicación Azure, la compatibilidad se agregará más adelante. Para asignar un rol en OneLogin u Okta a un usuario de SCIM o modificar el que tenga actualmente, cambia el nombre de su rol en el portal de aprovisionamiento del proveedor de servicios de identidad.
Asignar roles en proveedores de servicios de identidad no compatibles
Si tu proveedor de servicios de identidad no tiene ninguna aplicación de Shopify Plus, debes modificar manualmente la configuración de SCIM. Antes de comenzar, verifica que tu proveedor de servicios de identidad pueda agregar roles en forma de campo SCIM.
Para asignar o actualizar el rol de un usuario de SCIM, el cuerpo JSON en las solicitudes POST, PUT y PATCH debe incluir lo siguiente:
json
{
"name": {
"givenName": "given_name"
"familyName": "family_name"
},
"userName": "email",
"roles": [{"value": "role_name"}]
}
El cuerpo JSON de SCIM debe incluir una clave llamada roles
. roles
debe ser una matriz que incluya un hash que almacene el nombre del rol. Si se proporcionan varios hashes de nombre de rol, solo se usará el hash del último nombre para asignar un rol. Si el nombre del rol no es válido o el cuerpo JSON de SCIM no coincide con la plantilla anterior, los roles no se asignarán ni se actualizarán.
Anular la asignación de roles
Para anular la asignación de un rol a un usuario, usa el panel de control avanzado de Shopify. Obtén más información sobre cómo anular la asignación de roles a los usuarios en Shopify.
Eliminar la integración SCIM
Si ya no necesitas una integración SCIM, puedes eliminarla. Esta acción no puede deshacerse. Si necesitas reactivar tu integración, debes generar un nuevo token de la API.
Pasos:
- En el panel de control avanzado de Shopify, ve a Usuarios > Seguridad.
- En la sección Integración SCIM, haz clic en ... junto al token de la API.
- Haz clic en Eliminar token.
Restricciones
Los propietarios de tiendas y de organizaciones no pueden eliminarse a través de un proveedor de servicios de identidad. Ambos tipos de propiedad deben transferirse antes de que el usuario pueda eliminarse. Si necesitas cambiar el propietario de la tienda, puedes hacerlo desde tu panel de control de Shopify. Si necesitas cambiar el propietario de la organización, comunícate con atención al cliente de Shopify Plus.