Configurar SSO con Microsoft Entra ID

Permite que tu equipo inicie sesión en Circleback con Microsoft Entra ID

Puedes conectar Microsoft Entra ID a Circleback creando una aplicación SAML personalizada en el centro de administración de Entra.

Necesitas permisos para administrar aplicaciones empresariales en Entra y ser administrador de tu espacio de trabajo de Circleback. Antes de empezar, revisa los requisitos en Configurar el inicio de sesión único.

1. En Circleback, ve a Configuración → General (en Espacio de trabajo).

2. En Inicio de sesión único, selecciona Conectar junto a Proveedor de identidad. Elige SAML y luego selecciona Continuar. Mantén este formulario abierto.

3. En otra pestaña, abre el centro de administración de Entra y ve a Enterprise applications.

Microsoft Entra ID: Enterprise applications

4. Selecciona New application → Create your own application.

Microsoft Entra ID: New application

5. Ingresa Circleback como nombre y elige integrar una aplicación que no encuentras en la galería.

6. Selecciona Create.

Microsoft Entra ID: Create your own application

7. Abre la aplicación, selecciona Single sign-on en Manage y luego elige SAML.

Microsoft Entra ID: elegir el inicio de sesión único con SAML

8. En Entra, en Basic SAML Configuration, selecciona Edit. Copia el ID de entidad y la URL de ACS del formulario abierto de Circleback en los campos siguientes:

Microsoft Entra ID: editar Basic SAML Configuration

CampoValor
Identifier (Entity ID)https://circleback.ai/api/sso/metadata
Reply URL (Assertion Consumer Service URL)https://circleback.ai/api/sso/oauth/saml

9. Selecciona Save.

Microsoft Entra ID: campos Identifier y Reply URL; usa las URL de Circleback indicadas arriba

10. En Attributes & Claims, selecciona Edit.

Microsoft Entra ID: editar Attributes and Claims

11. Establece Unique User Identifier (Name ID) en el correo electrónico que el miembro de tu equipo usa en Circleback, con el formato Email address. Usa user.mail si contiene ese correo para cada usuario asignado. Usa user.userprincipalname solo si coincide con su correo de Circleback.

12. Revisa estas notificaciones y agrega las que falten:

NotificaciónAtributo de origen
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddressuser.mail
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givennameuser.givenname
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surnameuser.surname

La notificación de correo electrónico también debe coincidir con el correo de Circleback del miembro. Si usas otro atributo de origen para su correo, úsalo tanto para la notificación de correo electrónico como para el Name ID.

13. Guarda los cambios.

Microsoft Entra ID: ejemplo de notificaciones de atributos; sigue las instrucciones de asignación del correo indicadas arriba

14. Vuelve a Single sign-on en Entra. En SAML Signing Certificate, descarga Federation Metadata XML.

Microsoft Entra ID: descargar Federation Metadata XML

15. En el formulario abierto de Circleback, en Fuente de metadatos, elige Subir archivo XML y sube el archivo que descargaste.

16. En Entra, abre Users and groups en la aplicación.

17. Selecciona Add user/group y elige las personas o los grupos que deben usar Circleback.

18. Selecciona Assign.

19. Vuelve a Circleback y selecciona Continuar. Deja seleccionado Sin sincronización de directorio para usarlo solo para iniciar sesión, o selecciona Microsoft Entra ID si planeas configurar el aprovisionamiento SCIM. Selecciona Conectar.

Si seleccionaste Microsoft Entra ID para la sincronización de directorio, usa las credenciales que se muestran en Circleback para configurar la sincronización de directorio.

Asignar roles del espacio de trabajo

Si configuraste la sincronización de directorio, Entra también puede establecer el rol de cada miembro en Circleback.

1. En el centro de administración de Entra, ve a App registrations → All applications y abre Circleback.

2. Selecciona App roles → Create app role. Crea estos tres roles y permite Users/Groups en cada uno:

Nombre para mostrarValor
AdminAdmin
MemberMember
ViewerViewer

3. Ve a Enterprise applications → Circleback → Users and groups. Asigna a cada usuario o grupo el rol que debe tener. Dale a cada persona un solo rol.

4. Selecciona Provisioning → Attribute mapping → Users.

5. Selecciona Add New Mapping, elige el tipo de asignación Expression e ingresa:

CampoValor
ExpressionSingleAppRoleAssignment([appRoleAssignments])
Target attributeroles[primary eq "True"].value

6. Selecciona OK y luego Save.

7. En Settings, establece Scope en Sync only assigned users and groups.

Para exigir que todos en tu espacio de trabajo inicien sesión con SSO, sigue Imponer el SSO en tu espacio de trabajo.

Artículos relacionados