Configurar el inicio de sesión único
Esta guía configura el inicio de sesión único (SSO) para un workspace de principio a fin. La configuración se describe en Inicio de sesión único.
Requisitos
Sección titulada «Requisitos»- El rol de administrador en el workspace. Cualquier plan.
- Un administrador de la organización de Okta o del directorio de Entra ID del cliente.
- Alguien que pueda añadir un registro TXT al DNS del dominio de correo del cliente.
- El dominio de correo propio del cliente. Los dominios públicos como gmail.com se rechazan.
1. Elegir el proveedor y copiar la URL de callback
Sección titulada «1. Elegir el proveedor y copiar la URL de callback»- Abra Single sign-on en Workspace.
- Elija Okta o Microsoft Entra ID.
- Copie Callback / redirect URI (configure in your IdP) con el botón de copiar.
2. Crear la aplicación en el proveedor de identidad
Sección titulada «2. Crear la aplicación en el proveedor de identidad»Siga los pasos numerados que muestra la página para el proveedor que ha elegido.
- Okta: cree una aplicación web OIDC, establezca la URI de redirección de inicio de sesión en la URL de callback, asigne los usuarios o los grupos, y copie el ID de cliente y el secreto de cliente.
- Microsoft Entra ID: cree un registro de aplicación, establezca la URI de redirección web en la URL de callback, cree un secreto de cliente, y copie el ID de aplicación (cliente) y el valor del secreto.
3. Crear la conexión
Sección titulada «3. Crear la conexión»- Introduzca la Issuer URL.
- Okta: la URL de la organización, por ejemplo
https://your-org.okta.com, o la URL de un servidor de autorización personalizado. - Entra ID:
https://login.microsoftonline.com/<tenant-id>/v2.0.
- Okta: la URL de la organización, por ejemplo
- Introduzca el Client ID y el Client secret.
- Introduzca el Email domain como un dominio sin más, por ejemplo
client.com. - Elija Create connection.
Verá SSO connection created. Now verify your domain. (conexión SSO creada; ahora verifique su dominio). La insignia dice Awaiting domain verification (a la espera de la verificación del dominio).
4. Verificar el dominio
Sección titulada «4. Verificar el dominio»- En Verify domain ownership, copie Name. Es
_idnguard-verify.seguido del dominio. - Copie Value.
- En el proveedor de DNS, cree un registro TXT con ese nombre y ese valor.
- Elija Verify domain.
Verá Domain verified. SSO is live. (dominio verificado; el SSO está activo) y la insignia cambia a Live.
Si aparece un mensaje TXT record not found (registro TXT no encontrado), espere unos minutos y elija Verify domain de nuevo. Los cambios de DNS tardan un tiempo.
5. Probarlo
Sección titulada «5. Probarlo»- Cierre la sesión, o abra una ventana privada del navegador.
- En la página de inicio de sesión, elija Continue with single sign-on.
- Introduzca una dirección de correo de trabajo del dominio y elija Continue.
- Inicie sesión en el proveedor de identidad. Se abre el panel del workspace.
Pruebe con una segunda persona antes de avisar a todo el equipo.
6. Establecer los roles
Sección titulada «6. Establecer los roles»Las personas que se unen mediante el inicio de sesión único llegan como miembros.
- Abra Members.
- Elija el rol adecuado en el campo Role de la fila de cada persona.
7. Opcional: bloquear las invitaciones por correo
Sección titulada «7. Opcional: bloquear las invitaciones por correo»En la página Single sign-on, elija el botón que hay junto a Restrict membership to SSO para que diga On. Verá Membership is now restricted to SSO. Email invitations are blocked. (la pertenencia está ahora restringida al SSO; las invitaciones por correo están bloqueadas).
A partir de ahora, solo el proveedor de identidad decide quién puede unirse.
Invitar a un invitado externo
Sección titulada «Invitar a un invitado externo»Con Restrict membership to SSO activado, no puede invitar a una dirección de fuera del dominio. Para invitar a un invitado:
- Abra Single sign-on. Junto a Restrict membership to SSO, elija On para que diga Off.
- Abra Members, introduzca la dirección y el rol del invitado, y elija Send Invite.
- Cuando el invitado se haya unido, ponga Restrict membership to SSO de nuevo en On.
Quitar el inicio de sesión único
Sección titulada «Quitar el inicio de sesión único»- Abra Single sign-on y elija Remove connection.
- Confirme la pregunta del navegador.
Las personas conservan sus cuentas y sus pertenencias. Cada persona del dominio configura entonces una passkey desde Create account / set up a passkey en la página de inicio de sesión.
Si no funciona
Sección titulada «Si no funciona»| Qué ve | Qué hacer |
|---|---|
| Bad Request: issuer does not look like a valid … issuer (solicitud incorrecta: el emisor no parece un emisor válido) | Use el formato de emisor que se muestra en el paso 3 para su proveedor. |
| Bad Request: Enter a bare domain like client.com (no scheme or path). (solicitud incorrecta: introduzca un dominio sin más, como client.com, sin esquema ni ruta) | Quite https:// y todo lo que haya después del dominio. |
| Bad Request: Public email provider domains cannot be used for SSO routing. (solicitud incorrecta: los dominios de proveedores públicos de correo no se pueden usar para el enrutamiento del SSO) | Use el dominio propio de la organización. |
| The domain … is already verified by another workspace. (el dominio ya está verificado por otro workspace) | Otro workspace ha reclamado el dominio. Ese workspace quita su conexión, o contacte con soporte. |
| Could not read the identity provider’s OpenID configuration (no se ha podido leer la configuración OpenID del proveedor de identidad) | Compruebe que no hay errores de escritura en la Issuer URL. |
| TXT record not found … | Compruebe el nombre y el valor del registro en el proveedor de DNS. Espere unos minutos. Inténtelo de nuevo. |
| No single sign-on for this domain. (no hay inicio de sesión único para este dominio) al iniciar sesión | El dominio todavía no está verificado. Termine el paso 4. |
| Verify the domain first. SSO-only membership requires a live connection. (verifique primero el dominio; la pertenencia solo por SSO requiere una conexión activa) | Verifique el dominio antes de restringir la pertenencia. |
| Una persona inicia sesión pero recibe You do not have access to this workspace. (no tiene acceso a este workspace) | Compruebe que la persona está asignada a la aplicación en el proveedor de identidad. |
Todos los mensajes se explican en Inicio de sesión único y en Iniciar sesión.