Guía de implementación de SSO de Cintoo

Este artículo describe las ventajas y las opciones disponibles para el inicio de sesión único (Single Sign-On) y qué información se debe proporcionar a Cintoo para configurar correctamente el SSO.


TABLA DE CONTENIDO


Descripción general

 

Cintoo se puede integrar con la solución de inicio de sesión único (SSO) corporativa de su empresa para cumplir los requisitos de seguridad corporativos y simplificar la gestión de usuarios.

Cintoo es compatible con los protocolos OpenID Connect (OIDC) y SAML, y es compatible con los siguientes proveedores de identidad:

  • Azure AD ( proveedor preferido )
  • Microsoft ADFS
  • Okta / Okta MyID
  • Ping Federate

Comuníquese con un representante de ventas de Cintoo o con sales@cintoo.com para contratar la opción de SSO para su cuenta de Cintoo.


Flujo de autenticación

 

La autenticación en Cintoo se realiza en dos pasos:

  • Ingresar el nombre de usuario (dirección de correo electrónico)
  • Según el nombre de dominio (la segunda parte del correo electrónico, después del carácter @), se redirige a la pantalla de autenticación nativa de Cintoo (es decir, con un nombre de usuario y una contraseña de Cintoo) o a la pantalla de inicio de sesión de SSO corporativo.

 

Esto significa que, una vez activado el SSO para el dominio @corp.com, cualquier usuario cuyo nombre de usuario tenga la forma user@corp.com se redirige a la pantalla de inicio de sesión del proveedor de identidad correspondiente y no hay forma de volver a la autenticación nativa de Cintoo.

 

Nota: los clientes que hayan contratado un dominio personalizado de Cintoo (con la forma https://corp.cintoo.cloud) pueden solicitar el uso de su propio proveedor de SSO para todos los usuarios, independientemente del nombre de dominio del usuario. Consulte la sección sobre usuarios externos más abajo.

Aprovisionamiento de usuarios

 

El SSO se utiliza únicamente para la autenticación y no influye en la forma en que se crean los usuarios en una cuenta de Cintoo. Los usuarios siguen debiendo ser invitados por un administrador de la cuenta o por un gestor de proyecto / BIM.

Cualquier usuario que intente autenticarse mediante SSO sin haber sido invitado previamente a la cuenta no podrá iniciar sesión.

Nota: para crear y eliminar usuarios y grupos automáticamente desde Microsoft Entra ID, utilice Microsoft Entra directory sync. Funciona junto con el SSO: los usuarios sincronizados cuyo dominio de correo electrónico utiliza SSO no reciben ningún correo de invitación.

Usuarios externos

 

Si se invita a sus proyectos a usuarios externos (es decir, con un correo electrónico de un dominio que usted no controla), de forma predeterminada estos usuarios no se autenticarán con su SSO, ya que el SSO se configura por nombre de dominio.

Ejemplo:

  • El nombre de dominio de su empresa es corp.com
  • Usted invita a user@guest.com a uno de sus proyectos
  • Si guest.com también es cliente de Cintoo y ha contratado la opción de SSO, user@guest.com se autenticará mediante el SSO de guest.com (no mediante el SSO de corp.com). De lo contrario, este usuario iniciará sesión mediante la autenticación nativa de Cintoo.

 

Para aumentar el control sobre sus usuarios externos, puede:

  • Agregar a todos los usuarios externos como invitados en su propio directorio de usuarios (por ejemplo, user-guest@corp.com)
  • Contratar un dominio de Cintoo personalizado, es decir, https://corp.cintoo.cloud (comuníquese con el equipo de ventas de Cintoo para obtener información). De esta manera tendrá su propio tenant de Cintoo y todos sus proyectos solo serán accesibles a través de https://corp.cintoo.cloud.
  • Pedir al equipo de TI de Cintoo que vincule su dominio personalizado con su proveedor de SSO. Esto significa que cualquier usuario que intente abrir un proyecto en https://corp.cintoo.cloud será redirigido a su propio SSO, aunque no tenga una dirección de correo electrónico @corp.com.

Proceso de implementación del SSO

 

La implementación del SSO siempre sigue estos pasos:

  • Comuníquese con el equipo de ventas de Cintoo para contratar la opción
  • Configure su proveedor de identidad con OIDC o SAML y comunique la información necesaria al equipo de TI de Cintoo a través de support@cintoo.com (consulte los detalles más abajo)
  • Valide la configuración del SSO con unos pocos usuarios, mediante una URL de inicio de sesión temporal
  • Acuerde con el equipo de TI de Cintoo una fecha de transición, a partir de la cual todos los usuarios de su dominio serán redirigidos a su pantalla de inicio de sesión de SSO

 

Advertencia: los usuarios creados en Cintoo antes de la transición ya no podrán conectarse con su contraseña de Cintoo existente.

Configuración del proveedor de identidad

 

Opción 1: OpenID Connect

 

Azure AD mediante una aplicación personalizada

 

Debe crear su propia aplicación en Azure AD.

En Azure AD, seleccione App registrations y, a continuación, New registration

Une image contenant texte Description générée automatiquement

 

Nota: el dominio del URI de redirección debe coincidir con el dominio de su instancia de Cintoo (por ejemplo, eu.cintoo.cloud, us.cintoo.cloud, ca.cintoo.cloud, [corp].cintoo.cloud).

 

Una vez creada la aplicación, edite la configuración de Authentication y habilite la opción ID tokens.

Une image contenant texte, capture d’écran, moniteur, écran Description générée automatiquement

 

Anote el Application (client) ID y el Directory (tenant) ID de la aplicación y comunique estos valores al equipo de soporte de Cintoo.

Une image contenant texte, capture d’écran, moniteur, écran Description générée automatiquement

 

Nota: Cintoo intenta identificar al usuario a partir de su dirección de correo electrónico. Si el campo upn de los usuarios de Azure AD no contiene la dirección de email, configure una notificación (claim) de correo electrónico opcional que contenga la dirección de email del usuario (en ese caso, Cintoo consultará el campo email de la respuesta de OAuth en lugar de upn).

 

Así se agrega esta notificación (claim) opcional.

 

Es obligatorio agregar un permiso de API de Microsoft Graph para leer la dirección de correo electrónico.


Okta

 

En Administration de Okta, cree una nueva aplicación.

 

Seleccione Web / OpenID Connect.

 

Agregue la URL de redirección necesaria.

 

Nota: el URI de redirección depende del nombre de dominio de su instancia de Cintoo. Consulte con el equipo de soporte de Cintoo cuál es el correcto.

 

En la siguiente pantalla, General Settings, haga clic en Edit y agregue el permiso ID Token with implicit grant.

 

Cuando termine, vaya a la pestaña Sign On y anote los campos Issuer y Audience de la sección OpenID Connect ID Token.

 

Estos valores deberán comunicarse al equipo de soporte de Cintoo.


Otros proveedores

 

Esta es la configuración genérica para cualquier otro proveedor de identidad que utilice OpenID Connect:

  • Cree una aplicación Cintoo
  • Configure el URI de redirección: https:///login/oauthcb, donde domain depende de su instancia de Cintoo (por ejemplo, us.cintoo.cloud, eu.cintoo.cloud o ca.cintoo.cloud)
  • Permita el ID token con implicit grant
  • Permita los siguientes scopes: openID email profile
  • Comunique la siguiente información al equipo de soporte de Cintoo:
  1. Client ID
    1. URL de descubrimiento de OpenID Connect (por ejemplo, https:///.well-known/openid-configuration )
Nota: Cintoo identifica el nombre de usuario a partir del campo email de la respuesta de OAuth. Si no hay un campo de correo electrónico, se utiliza en su lugar el campo upn.

Opción 2: SAML

 

Estos son los metadatos del proveedor de servicios (Service Provider Metadata) que deberá configurar en su proveedor de identidad SAML.

<md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" entityID="https://<domain>/saml"> 
    <md:SPSSODescriptor AuthnRequestsSigned="false" WantAssertionsSigned="false" protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol"> 
        <md:NameIDFormat>urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress</md:NameIDFormat> 
        <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://<domain>/saml" index="1"/> 
    </md:SPSSODescriptor> 
</md:EntityDescriptor>

 

Nota: el dominio debe reemplazarse por el nombre de dominio correspondiente a su instancia de Cintoo (por ejemplo, eu.cintoo.cloud, us.cintoo.cloud, ca.cintoo.cloud o your-company.cintoo.cloud).

 

Deberá comunicar al equipo de soporte de Cintoo la URL o el archivo de metadatos de su IdP o, como mínimo, los siguientes datos:

  • IDP entity ID
  • Login URL
  • Signing certificate(s)

 

Nota: Cintoo identifica el nombre de usuario a partir del campo NameID (sujeto SAML) de la respuesta SAML. El NameID debe ser igual al nombre de usuario de Cintoo, es decir, la dirección de email del usuario.

¿Le fue útil este artículo?

¡Qué bueno!

Gracias por sus comentarios

¡Sentimos mucho no haber sido de ayuda!

Gracias por sus comentarios

¡Díganos cómo podemos mejorar este artículo!

Seleccione al menos una de las razones
La verificación de CAPTCHA es obligatoria.

Comentarios enviados

Agradecemos su iniciativa, e intentaremos corregir el artículo