Saltar al contenido

SSO (Empresa)

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.

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.com para usuarios que inician sesión como user@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.
  1. Abrir https://console.capgo.app/
  2. Haz clic Configuración en la barra lateral izquierda
  3. Selecciona el Organización pestaña
  4. Selecciona el Seguridad pestaña
  5. Desplázate a configuración de SSO. El formulario solo está disponible cuando la organización tiene el plan Enterprise.

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:

CampoDónde usarlo
URL de ACSAssertion Consumer Service URL en tu app SAML del IdP
ID de la entidadIdentificador de la entidad del Service Provider
URL de metadatos del SPOpcional: importa si tu IdP permite importar metadatos del SP por URL
Formato de NameIDFormato 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.

  1. En el panel de configuración de SSO, haz clic para agregar un nuevo proveedor
  2. 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
  3. Introduce tu IdP URL de metadatos (HTTPS)
  4. Enviar

El proveedor se crea con el estado Pendiente de verificación.

Capgo verifica que controlas el dominio antes de que el SSO pueda activarse.

Añade una TXT registro en tu proveedor de DNS:

CampoValor
TipoTXT
Nombre / host_capgo-sso.<your-domain> (p. ej. _capgo-sso.company.com)
ValorEl 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.

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.

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:

  1. Ve a Configuración → Organización → Miembros
  2. Encuentra a cada usuario provisionado por SSO
  3. Ajusta su role al nivel adecuado (Subir, Escribir, Administrador, etc.)

Consulta la desglose completo de permisos lo que cada rol puede hacer.

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.

EstadoSignificado
Pendiente de verificaciónRegistro DNS TXT aún no verificado
VerificadoPropiedad del dominio confirmada; listo para activar
ActivoSSO activo para este dominio
DesactivadoSet by Desactivar en el dashboard; SSO no se usa para ese dominio; usa Reactivar para volver a Activo
  • 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)

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.