SSO (Empresa)
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
¿Qué es SSO?
Sección titulada “¿Qué es SSO?”El inicio de sesión único (SSO) permite a tu equipo iniciar sesión en Capgo usando el proveedor de identidad (IdP) de tu empresa. Capgo utiliza SAML 2.0 a través de Supabase Auth. Cuando el dominio de email de un usuario coincide con un proveedor SSO activo, puede autenticarse con tu IdP y se le da de alta en la organización durante el callback de SSO.
SSO no cambia lo que los usuarios pueden hacer. Los permisos se controlan mediante roles de organización. SSO solo cambia cómo se autentican.
Requisitos
Sección titulada “Prerrequisitos”Antes de empezar:
- Suscripción Enterprise activa en la organización de Capgo.
- Un proveedor de identidades que admita SAML 2.0 y expone un IdP URL de metadatos (HTTPS).
- Capacidad para publicar un registro DNS TXT para el dominio de correo (p. ej.
company.compara usuarios que inician sesión comouser@company.com). - Un miembro de la organización Capgo con permiso para actualizar la configuración de la organización.
- Una Admin de IdP contacto en tu equipo de TI/seguridad.
Dónde encontrar la configuración de SSO
Sección titulada «Dónde encontrar la configuración de SSO»- Abrir https://console.capgo.app/
- Haz clic Configuración en la barra lateral izquierda
- Selecciona el Organización pestaña
- Selecciona el Seguridad pestaña
- Desplázate a configuración de SSO. El formulario solo está disponible cuando la organización tiene el plan Enterprise.
Paso 1 - Configura tu IdP
Sección titulada “Paso 1: Configura tu IdP”En tu proveedor de identidad, crea una nueva aplicación SAML 2.0. Necesitarás lo siguiente: Proveedor de servicio valores mostrados en el panel de configuración de SSO de Capgo:
| Campo | Dónde usarlo |
|---|---|
| URL de ACS | Assertion Consumer Service URL en tu app SAML del IdP |
| ID de la entidad | Identificador de la entidad del Service Provider |
| URL de metadatos del SP | Opcional: importa si tu IdP permite importar metadatos del SP por URL |
| Formato de NameID | Formato esperado para el SAML Name Identifier |
Your IdP must release the user’s dirección de email del usuario en la aserción. Capgo usa el dominio del email para resolver el proveedor de SSO activo y asociar cuentas existentes.
Paso 2 - Añade el proveedor SSO en Capgo
Sección titulada “Paso 2: Agregar el proveedor de SSO en Capgo”- En el panel de configuración de SSO, haz clic para agregar un nuevo proveedor
- Introduce el dominio de correo electrónico (p. ej.
company.com). Debe coincidir con la parte de dominio de los correos de inicio de sesión de tus usuarios - Introduce tu IdP URL de metadatos (HTTPS)
- Enviar
El proveedor se crea con el estado Pendiente de verificación.
Paso 3 - Verificación del dominio DNS
Sección titulada “Paso 3 - Verificación del dominio DNS”Capgo verifica que controlas el dominio antes de que el SSO pueda activarse.
Añade una TXT registro en tu proveedor de DNS:
| Campo | Valor |
|---|---|
| Tipo | TXT |
| Nombre / host | _capgo-sso.<your-domain> (p. ej. _capgo-sso.company.com) |
| Valor | El token de verificación mostrado en el panel del dashboard |
Una vez que el registro esté publicado (la propagación del TTL de DNS suele tardar de unos minutos a una hora), haz clic Verificar DNS en el dashboard. Si tiene éxito, el proveedor pasará a Verificado.
Paso 4 - Activa el proveedor
Sección titulada “Paso 4 - Activar el proveedor”Tras la verificación de DNS, haz clic Activar. El estado del proveedor pasa a ser Activo. Solo Activo se usan los proveedores durante el flujo de login SSO.
Puedes elegir Desactivar en el dashboard en cualquier momento. Eso pasa el proveedor a Desactivado, lo que pausa el SSO para ese dominio sin borrar la configuración.
Paso 5 - Probar y asignar roles
Sección titulada “Paso 5 - Probar y asignar roles”Cuando un usuario inicia sesión vía SSO por primera vez y no tiene una membresía existente en esa organización, Capgo le asigna el rol de lectura role.
Después de que los usuarios piloto inicien sesión:
- Ve a Configuración → Organización → Miembros
- Encuentra a cada usuario provisionado por SSO
- Ajusta su role al nivel adecuado (Subir, Escribir, Administrador, etc.)
Consulta la desglose completo de permisos lo que cada rol puede hacer.
Opcional - Forzar SSO
Sección titulada “Opcional - Forzar SSO”En un Activo proveedor puedes activar Forzar SSO. Cuando está activado, Capgo marca como solo SSO los usuarios de autenticación existentes de ese dominio de email y el flujo de login requiere autenticación con el IdP para ese dominio. Al configurar el proveedor como Desactivado (Desactivar) o desactivar la obligatoriedad elimina ese flag de solo SSO para el dominio.
Referencia de estado del proveedor
Sección titulada «Referencia de estado del proveedor»| Estado | Significado |
|---|---|
| Pendiente de verificación | Registro DNS TXT aún no verificado |
| Verificado | Propiedad del dominio confirmada; listo para activar |
| Activo | SSO activo para este dominio |
| Desactivado | Set by Desactivar en el dashboard; SSO no se usa para ese dominio; usa Reactivar para volver a Activo |
Checklist de despliegue
Section titled “Rollout checklist”- Plan Enterprise confirmado
- App SAML creada en el IdP con la ACS URL y el Entity ID de Capgo
- IdP configurado para emitir un claim de email estable
- Registro DNS TXT publicado y Verificar DNS correcto
- Proveedor activado
- Usuarios piloto iniciaron sesión con éxito
- Roles elevados desde el valor por defecto lectura as needed
- Decisión de enforcement tomada (y comunicada si está habilitado)
Documentación relacionada
Sección titulada “Documentación relacionada”Continuar desde SSO (Enterprise)
Sección titulada «Continuar desde SSO (Enterprise)»Si estás usando SSO (Empresa) para planificar los flujos de autenticación y de cuenta, conéctalo con @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores, y 5 pasos para implementar OAuth2 en apps Capacitor para el contexto práctico en 5 pasos para implementar OAuth2 en apps Capacitor.