AI CodeOps

Configurar el inicio de sesión único (SSO)

Última actualización

Configura el inicio de sesión con SAML 2.0 u OpenID Connect para AI CodeOps en el plan Enterprise: verifica tu dominio, crea una conexión, configura tu IdP y actívala.

El inicio de sesión único permite que tu gente inicie sesión en AI CodeOps a través de tu propio proveedor de identidad (IdP), con SAML 2.0 u OpenID Connect (OIDC). Sirve cualquier IdP que admita uno de los dos protocolos; introduces tú mismo sus datos, así que no hay ajustes predefinidos por proveedor.

Antes de empezar

  • Plan. El SSO forma parte del plan Enterprise, igual que la verificación de dominios. Sin él, la tarjeta muestra "SSO (SAML 2.0 / OIDC) is available on the Enterprise plan." Consulta Enterprise.
  • Quién puede configurarlo. El SSO pertenece a la organización, no a un único espacio de trabajo. Los propietarios y administradores de la organización ven la tarjeta. Solo un propietario puede crear, editar y activar una conexión. Los propietarios y los administradores pueden verificar dominios, fijar el espacio de trabajo por defecto del SSO, y desactivar y eliminar conexiones.
  • Acceso al DNS. Tienes que añadir un registro TXT para tu dominio de correo electrónico.

Los ajustes están en Configure → Settings, en la tarjeta Single sign-on.

1. Verifica tu dominio

  1. En Verified Domains, introduce tu dominio de correo electrónico, por ejemplo example.com, y elige Verify a domain.
  2. Añade a tu DNS el registro TXT que se muestra: - Nombre: _codeopsstudio-verify.example.com - Valor: el token que aparece en pantalla
  3. Elige Check now. Los cambios de DNS pueden tardar en aparecer, así que vuelve a comprobarlo más tarde si todavía no está verificado.

No puedes crear una conexión para un dominio hasta que esté verificado.

2. Crea una conexión

  1. Elige Add SSO connection.
  2. En New SSO Connection, rellena:
CampoSAML 2.0OpenID Connect
ProtocolSAML 2.0OpenID Connect
Display NameUn nombre que reconozcas, como "Okta"Un nombre, como "Azure AD"
Email DomainUn dominio verificadoUn dominio verificado
Default RoleMember, Developer o ViewerMember, Developer o Viewer
Datos del IdPIdP Entity ID, IdP SSO URL, IdP Certificate (PEM)Issuer URL, Client ID, Client Secret
  1. Elige Create Connection.

El client secret de OIDC se cifra en reposo. No hay ningún campo para una URL de metadatos del IdP; copia los valores desde tu IdP.

3. Configura tu proveedor de identidad

La tarjeta de la conexión muestra los valores que necesita tu IdP:

ProtocoloEtiquetaRutaUso
SAMLMetadata URL/sso/saml/<connection-id>/metadataMetadatos del proveedor de servicios, y su entity ID
SAMLACS URL/sso/saml/<connection-id>/acsAssertion Consumer Service (HTTP-POST)
OIDCRedirect URI/sso/oidc/<connection-id>/callbackURI de redirección para tu aplicación OIDC

Las rutas van sobre la dirección de la consola, por ejemplo https://console.aicodeops.dev.

SAML. Envía la dirección de correo electrónico del usuario como NameID (formato de dirección de correo electrónico) o como un atributo email. Las aserciones deben ir firmadas con el certificado que introdujiste. AI CodeOps comprueba la firma, la audiencia, la caducidad y que la respuesta corresponda a un inicio de sesión que él mismo empezó. El inicio de sesión debe empezar en AI CodeOps; un icono en el panel de tu IdP no funcionará.

OIDC. AI CodeOps solicita los scopes openid email profile y usa PKCE.

Una conexión nueva está en pruebas hasta que la activas. Mientras lo está, solo inicia la sesión de personas que ya están en tu organización, y no crea cuentas. Para probarla con tu propia cuenta, abre /sso/saml/<connection-id>/login o /sso/oidc/<connection-id>/login sobre la dirección de la consola.

  1. En la tarjeta de la conexión, elige Activate.
  2. Comparte el enlace de inicio de sesión con tu gente:
https://console.aicodeops.dev/sso/login?domain=example.com

El enlace abre Continue with single sign-on si falta el dominio, de modo que la gente también puede escribir allí su correo electrónico de trabajo. Busca la conexión activa del dominio y los envía a tu IdP.

Usuarios nuevos y roles

El primer inicio de sesión con SSO crea la cuenta de la persona si no tiene una y la añade a tu organización.

Para poner a las personas nuevas directamente en un espacio de trabajo, abre los ajustes de ese espacio de trabajo y elige Set this workspace as SSO default en la tarjeta de la conexión. Se unen a él con el Default Role de la conexión. Sin un espacio de trabajo por defecto, llegan a su propio espacio de trabajo personal hasta que alguien los invita. Puedes cambiar su rol más tarde; consulta Roles y permisos.

Las sesiones se quedan dentro de tu organización

Un inicio de sesión a través de tu SSO solo accede a los espacios de trabajo de tu organización y al espacio de trabajo personal de la propia persona. Los espacios de trabajo de otras organizaciones quedan bloqueados para esa sesión, aunque la persona sea miembro de ellos.

Desactivar o eliminar

  • Deactivate detiene los nuevos inicios de sesión con SSO y conserva la configuración.
  • Delete elimina la conexión después de que confirmes con Delete connection. Sus usuarios inician sesión entonces con una contraseña o con una cuenta social.

Los cambios de SSO se registran como eventos de auditoría sso.connection.* y sso.domain.* para la organización. No aparecen en la página del registro de auditoría de un espacio de trabajo, y se conservan 7 días.

Siguientes pasos

Preguntas frecuentes

¿Qué plan incluye SSO?

Enterprise. En los demás planes, la tarjeta Single sign-on dice que el SSO está disponible en el plan Enterprise.

¿Dónde está la URL de metadatos de SAML?

En la tarjeta de la conexión después de crearla, con la etiqueta Metadata URL. Tiene la forma /sso/saml/<connection-id>/metadata y es también el entity ID del proveedor de servicios.

¿Se puede seguir iniciando sesión con contraseña cuando el SSO está activo?

Sí. El SSO añade una forma de iniciar sesión; no desactiva el inicio de sesión con contraseña ni con cuentas sociales para tu dominio.

¿Te resultó útil esta página?