Saltearse al contenido

SSO (SAML) y SCIM

El single sign-on permite que las personas inicien sesión en NamiDB Cloud con tu proveedor de identidad (IdP), se unan automáticamente a tu organización y pierdan el acceso cuando las desaprovisionas. Está disponible en Scale y Enterprise.

Todo está en Settings → Single sign-on (owners y admins).

Conecta tu proveedor de identidad

  1. Crea una app SAML en tu IdP (Okta, Microsoft Entra ID, Google Workspace, OneLogin, JumpCloud, …). Copia la ACS URL, el entity ID y, si tu IdP la importa, la SP metadata URL desde la sección Identity provider de la página de Single sign-on. Asegúrate de que la app envíe la dirección de email del usuario.

  2. Dale a NamiDB los metadatos del IdP: su URL de metadatos (https) o el XML de metadatos pegado. Guardar de nuevo más adelante los actualiza, por ejemplo después de que el IdP rote su certificado de firma.

  3. Verifica tus dominios. Agrega cada dominio de email (acme.com) y publica el registro TXT que muestra la página:

    _namidb-verification.acme.com. TXT "namidb-verification=<token>"

    Luego presiona Verify. Un dominio puede pertenecer a una sola organización, y solo las direcciones de dominios verificados pueden usar SSO, unirse mediante él o ser aprovisionadas.

  4. Elige las reglas de inicio de sesión (Sign-in and roles): el rol por defecto para las personas que se unen mediante SSO y, opcionalmente, un atributo de rol y sus mapeos.

Iniciar sesión

Las personas inician sesión en app.namidb.com/login/sso (o con Sign in with SSO en la página de login) ingresando su dirección de trabajo. NamiDB encuentra tu IdP a partir del dominio y las envía allí.

Los usuarios nuevos de SSO aceptan los Términos como todos los demás, la primera vez.

Membresía y roles just-in-time

El primer inicio de sesión por SSO de una persona de un dominio verificado la agrega a la organización con el rol por defecto. Para definir los roles desde el IdP, nombra el atributo de rol (normalmente groups) y agrega un mapeo por línea:

Engineering = developer
Finance = billing
Platform Admins = admin

Cuando coinciden varios valores, gana el rol con más privilegios. El mapeo se vuelve a aplicar en cada inicio de sesión, así que cambiar los grupos de alguien en el IdP cambia su rol en NamiDB. SSO nunca otorga ni cambia el rol de owner, y nunca modifica a un owner.

Exigir SSO

Activa Require SSO para que los miembros cuya dirección está en un dominio verificado lleguen a la organización solo a través de tu IdP. Sus inicios de sesión con contraseña, magic link y redes sociales siguen abriendo su cuenta, pero no esta organización: la consola los envía a SSO.

  • Solo puedes activarlo desde una sesión de SSO, así que no puedes quedarte afuera por error.
  • Los tokens de gestión creados por alguien a quien la exigencia deja afuera dejan de funcionar (403 token_inactive), y las exportaciones también lo verifican.
  • Los miembros fuera de tus dominios verificados (por ejemplo, contratistas) no se ven afectados.
  • Si la organización deja Scale, SSO, SCIM y la exigencia se desactivan; la configuración se conserva para cuando vuelvas.

Aprovisionamiento con SCIM

SCIM 2.0 permite que tu IdP cree, actualice y desactive miembros.

URL basehttps://app.namidb.com/api/scim/v2
AutenticaciónBearer token nmdb_scim_…
RecursosUsers, Groups, más ServiceProviderConfig, ResourceTypes, Schemas
Filtroseq sobre userName, externalId y emails.value
PATCHTal como lo envían Okta y Microsoft Entra ID

Crea tokens en la sección SCIM provisioning (se muestran una vez; hasta 5 activos por organización), y pega la URL base y el token en la configuración de aprovisionamiento de tu IdP.

  • Los grupos son roles: admin, developer, billing, member, viewer. Nombres como “NamiDB Developers” se mapean al rol que contienen.
  • Una persona aprovisionada se vincula a su cuenta de SSO en ese momento, o en su primer inicio de sesión por SSO.
  • Desactivar o eliminar a una persona en el IdP quita su membresía y cierra todas sus sesiones. No puede volver mediante el inicio de sesión just-in-time hasta que el IdP la reactive.
  • Los owners nunca se quitan mediante SCIM (409, owner_protected): solo un owner quita a un owner.
  • Cada cambio de SCIM queda en el registro de auditoría con el actor “SCIM”.

Solución de problemas

SíntomaRevisa
El inicio de sesión por SSO no encuentra tu IdPEl dominio de la dirección está verificado, el IdP está conectado y el plan es Scale o Enterprise
Inició sesión, pero no está en la organizaciónLa dirección está en un dominio verificado; el IdP envía la dirección de email; SCIM no desactivó a la persona
Rol incorrectoEl nombre y los valores del atributo de rol coinciden exactamente con tus líneas de mapeo
El dominio no se verificaEl registro TXT está en _namidb-verification.<domain> y ya se propagó (dig TXT _namidb-verification.acme.com)

¿Sigues con problemas? Abre un ticket con la categoría Account & access: consulta Soporte.