Typemark Documentation

Inicio de sesión único

Permite que tu equipo inicie sesión a través de tu proveedor de identidad, mediante SAML u OpenID Connect. Disponible en Enterprise.

Actualizado el 19 nov 20263 min de lectura

Con el inicio de sesión único (SSO), tu equipo inicia sesión en Typemark a través del proveedor de identidad de tu organización: Okta, Microsoft Entra ID, Google Workspace, OneLogin, Auth0, Keycloak o cualquier otro que sea compatible con SAML 2.0 u OpenID Connect.

El SSO está disponible en Enterprise. Pertenece a la cuenta que es propietaria de tus proyectos y abarca todos los proyectos que esa cuenta posee. Configúralo en Cuenta > Inicio de sesión único.

1. Demuestra la propiedad de tus dominios de correo

El SSO inicia sesión a personas cuyo correo está en tus dominios, así que Typemark necesita saber que los dominios son tuyos.

  1. En Tus dominios de correo, añade un dominio, por ejemplo acme.com.
  2. Añade el registro TXT que muestra Typemark en tu DNS: el nombre _typemark-sso.acme.com, con un valor que empiece por typemark-sso=.
  3. Haz clic en Verificar. Los cambios en el DNS pueden tardar unos minutos en aparecer.

Un dominio solo puede ser usado por una organización a la vez.

2. Conecta tu proveedor de identidad

Elige SAML 2.0 u OpenID Connect, añade Typemark como aplicación en tu proveedor y copia los datos.

Proporciona a tu proveedor estos dos valores de la página:

  • Entity ID (también llamado audience o identifier)
  • ACS URL (también llamado reply URL o single sign-on URL)

Envía la dirección de correo del usuario como NameID, en el formato emailAddress, o como un atributo llamado email.

Luego pega en Typemark la Single sign-on URL y el certificado de firma de tu proveedor. El Issuer es opcional. Si lo configuras, Typemark rechaza las respuestas de cualquier otro emisor.

Proporciona a tu proveedor el Redirect URI de la página y pide los ámbitos openid email profile.

Luego pega en Typemark la Issuer URL, el Client ID y el Client secret. Typemark encuentra todo lo demás en /.well-known/openid-configuration de tu proveedor. Una vez guardes el secreto, Typemark nunca volverá a mostrarlo.

Haz clic en Guardar y luego en Activar.

Iniciar sesión

Tu equipo inicia sesión en typemark.dev/users/sso o con Inicio de sesión único (SSO) en la página de inicio de sesión. Escriben su correo de trabajo y Typemark los redirige a tu proveedor.

Si alguien inicia sesión con SSO por primera vez y no tiene una cuenta de Typemark, Typemark crea una. Si fue invitado a un proyecto, se une a él.

Si alguien activó la autenticación de dos factores en Typemark, sigue introduciendo su código después del SSO.

Exigir el inicio de sesión único

Una vez que el SSO funcione, puedes hacer que sea la única forma de entrar para las personas de tus dominios. Haz clic en Exigir inicio de sesión único. Debes haber iniciado sesión con SSO al menos una vez antes, para que un error en la configuración no deje a tu equipo fuera.

Cuando el SSO es obligatorio:

  • las personas de tus dominios no pueden iniciar sesión con contraseña, GitHub ni enlace de correo
  • cualquiera que ya haya iniciado sesión de otra forma queda desconectado y se le pide que use SSO
  • los tokens de API y las sesiones de typemark login creadas antes de exigirlo dejan de funcionar, y las personas deben volver a ejecutar typemark login

Las personas cuyo correo no está en tus dominios, como los contratistas, siguen iniciando sesión como antes.

Desactivarlo

Haz clic en Hacer opcional para permitir de nuevo otras formas de entrar, o en Desactivar para detener el SSO. Si tu cuenta deja Enterprise, el SSO se desactiva automáticamente y todos vuelven a iniciar sesión como antes. Si alguien nunca tuvo contraseña, puede establecer una con ¿Olvidaste tu contraseña?.