Administración
Inicio de sesión único y SCIM
Conecte el proveedor de identidad SAML 2.0 de una organización (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) o, en un servidor autoalojado, directamente su Active Directory, verifique sus dominios de correo electrónico, exija el inicio de sesión único, asigne grupos a roles y aprovisione cuentas con SCIM 2.0.
En esta página
- Conceptos
- Cómo usarlo
- Verificar un dominio de correo electrónico
- Conectar el proveedor de identidad
- Activar el inicio de sesión único
- Exigir el inicio de sesión único
- Aprovisionar cuentas con SCIM
- Cuando cambia el certificado del proveedor de identidad
- Inicio de sesión de la empresa para varias organizaciones (autoalojado)
- Acceso a los proyectos del departamento (autoalojado)
- Reglas de inicio de sesión
- Atributos
- SCIM
- Configurar su proveedor de identidad
- Directorio de la empresa (Active Directory / LDAP)
- Límites y notas de seguridad
Una organización puede permitir que sus miembros inicien sesión en Holarch con su cuenta de trabajo. Holarch es el proveedor de servicios; el proveedor de identidad de su organización (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity o cualquier proveedor SAML 2.0) comprueba quiénes son. El proveedor de identidad también puede crear, actualizar y desactivar cuentas de Holarch mediante SCIM 2.0.
El inicio de sesión único lo configura un administrador de la organización en Ajustes de la organización → la organización → Acceso e inicio de sesión → Inicio de sesión único. Funciona en el servicio alojado y en los servidores autoalojados, no en la aplicación de escritorio. Un servidor autoalojado necesita acceso saliente para verificar un dominio (una consulta DNS) y para leer metadatos desde una URL. Un servidor autoalojado también puede comprobar por sí mismo las cuentas de la empresa con Active Directory u otro directorio LDAP, sin proveedor de identidad: consulte Directorio de la empresa (Active Directory / LDAP).
Nota: el inicio de sesión único y el aprovisionamiento SCIM forman parte del plan Team (el de la organización). Las organizaciones que los usaban antes de la versión 2.29.0 los conservan. Sin el plan, los ajustes se conservan, pero los miembros inician sesión con su contraseña (¿Olvidó su contraseña? define una), Google o Microsoft, y las solicitudes SCIM se rechazan.
Conceptos
| Término | Significado |
|---|---|
| Dominio verificado | Un dominio de correo electrónico (como example.com) que la organización demostró controlar con un registro DNS TXT. El inicio de sesión único y SCIM solo funcionan para direcciones de dominios verificados. Un dominio solo puede verificarlo una organización. |
| Proveedor de identidad (IdP) | El servicio que inicia la sesión de sus miembros: su ID de entidad (emisor), su URL de inicio de sesión y su certificado de firma. |
| Proveedor de servicios (SP) | Holarch, para esta organización. Cada organización tiene su propio ID de entidad, URL de ACS y URL de metadatos. |
| Miembros gestionados | Miembros de la organización cuya dirección de correo electrónico está en un dominio verificado y que no son administradores de la organización. Exigir el inicio de sesión único se les aplica a ellos. |
| Token SCIM | Un secreto que el proveedor de identidad usa para llamar a la API SCIM de Holarch para esta organización. No está ligado a una persona. |
Cómo usarlo
Verificar un dominio de correo electrónico
- Abra Ajustes de la organización, seleccione la organización, abra Acceso e inicio de sesión y busque Inicio de sesión único.
- En Dominios de correo electrónico, introduzca el dominio de las direcciones de sus miembros y elija Añadir dominio.
- Publique el registro TXT mostrado: el nombre
_holarch-challenge.<domain>con el valorholarch-domain-verification=…. - Elija Comprobar. Los cambios de DNS pueden tardar unos minutos en llegar; vuelva a comprobar hasta que el dominio muestre Verificado.
Añada todos los dominios que usan sus miembros (por ejemplo example.com y eng.example.com). Hasta 20 dominios por organización.
Conectar el proveedor de identidad
- En su proveedor de identidad, cree una aplicación SAML 2.0 (consulte las secciones de proveedores más abajo) con los valores de Proveedor de identidad en Holarch:
- ID de entidad (audiencia):
https://app.holarch.app/api/auth/saml/<organization id>/metadata - URL de ACS (URL de respuesta):
https://app.holarch.app/api/auth/saml/<organization id>/acs - URL de metadatos: la misma que el ID de entidad; los proveedores que importan metadatos de SP pueden usarla.
- ID de entidad (audiencia):
- Copie el XML de metadatos del proveedor o su URL de metadatos en el cuadro superior y elija Leer metadatos. Holarch rellena el ID de entidad, la URL de inicio de sesión y el certificado. O introdúzcalos usted mismo.
- En Atributos y roles, defina los nombres de atributo si su proveedor usa nombres poco habituales (consulte Atributos), el Rol de los nuevos miembros y, opcionalmente, Grupos a roles.
- Elija Guardar proveedor de identidad e introduzca su contraseña.
Activar el inicio de sesión único
- Marque Inicio de sesión único para esta organización. Necesita un proveedor de identidad guardado y un dominio verificado.
- Dé a los miembros el Enlace de inicio de sesión para los miembros, o dígales que elijan Iniciar sesión con inicio de sesión único en la pantalla de inicio de sesión e introduzcan su dirección de correo electrónico de trabajo.
- Pruébelo primero con un miembro.
En el primer inicio de sesión de un miembro, Holarch crea la cuenta (confirmada, sin contraseña) y la añade a la organización, también mientras el registro necesite una invitación. Cuando existe una cuenta con esa dirección, el inicio de sesión único se vincula a ella y su propietario recibe un correo electrónico.
Exigir el inicio de sesión único
Marque Exigir el inicio de sesión único a los miembros de los dominios verificados cuando el inicio de sesión único funcione.
- Los miembros gestionados solo inician sesión entonces mediante el proveedor de identidad. El inicio de sesión con contraseña, llave de acceso, Google y Microsoft responde que la organización exige el inicio de sesión único, con un botón que lleva allí. Sus sesiones actuales de otros métodos de inicio de sesión terminan al instante.
- A los administradores de la organización no se les exige: conservan su contraseña o llave de acceso con el inicio de sesión en dos pasos, para poder reparar una configuración del proveedor de identidad que no funciona (acceso de emergencia). Mantenga al menos dos administradores.
- Los miembros cuya dirección está fuera de los dominios verificados (colaboradores externos) no se ven afectados.
- Un restablecimiento de contraseña sigue definiendo la nueva contraseña, pero no inicia la sesión del miembro; después inicia sesión mediante el proveedor de identidad.
- Los tokens de API y las aplicaciones conectadas de los miembros gestionados siguen funcionando. Desactive la cuenta mediante SCIM para terminarlos.
Aprovisionar cuentas con SCIM
- En Aprovisionamiento (SCIM 2.0), elija Crear token SCIM e introduzca su contraseña.
- Copie el token y la URL base (
https://app.holarch.app/scim/v2) en los ajustes de aprovisionamiento de su proveedor de identidad. Holarch muestra el token una sola vez. - Active la creación, actualización y desactivación de usuarios en el proveedor.
Hasta 5 tokens por organización. Revocar termina un token al instante.
Cuando cambia el certificado del proveedor de identidad
- Pegue el nuevo certificado debajo del antiguo (se permiten dos certificados) y guarde.
- Cambie el proveedor al nuevo certificado.
- Quite el certificado antiguo y vuelva a guardar.
La lista de certificados muestra el sujeto, la fecha de caducidad y la huella digital de cada certificado.
Inicio de sesión de la empresa para varias organizaciones (autoalojado)
Un dominio de correo electrónico pertenece a una sola organización. Cuando una empresa tiene una organización por departamento en un servidor autoalojado, una organización (normalmente la de TI) verifica el dominio de la empresa, conecta el proveedor de identidad y activa el inicio de sesión único. Las demás organizaciones asignan entonces los grupos del proveedor de identidad a sus propios roles:
- En Ajustes de la organización → Acceso e inicio de sesión → Inicio de sesión único del departamento, busque Inicio de sesión de la empresa. Indica la organización que gestiona el inicio de sesión de la empresa.
- En Grupos a roles, escriba una asignación por línea, por ejemplo
packs-engineers = memberypacks-leads = admin, y elija Guardar grupos. - Opcional: añada tras una coma el acceso a los proyectos del departamento del grupo, por ejemplo
packs-contractors = member, viewer. Consulte Acceso a los proyectos del departamento.
En cada inicio de sesión a través del inicio de sesión de la empresa, una persona de un grupo asignado se une a esa organización con ese rol, o pasa a ser administrador de la organización allí. El inicio de sesión nunca quita ni rebaja a nadie (los grupos SCIM sí pueden: consulte Grupos SCIM y departamentos); los administradores de la organización quitan personas en Ajustes de la organización. El proveedor de identidad debe enviar los grupos (Atributo de grupos del inicio de sesión de la empresa).
Los administradores de la organización que gestiona el inicio de sesión de la empresa controlan el inicio de sesión de todas las direcciones del dominio. Limite esa organización a las personas que gestionan el proveedor de identidad.
Acceso a los proyectos del departamento (autoalojado)
Cada asignación de grupo también puede indicar cuánto reciben sus personas en los proyectos compartidos con toda la organización (Compartir → Organizaciones): viewer, reviewer o editor (el predeterminado). El rol de una persona en un proyecto así es el menor entre el rol del permiso de compartición y el acceso más alto entre sus grupos asignados allí. Por ejemplo, con un proyecto compartido como Editor y packs-contractors = member, viewer, un contratista lo ve; alguien que está a la vez en packs-contractors y en packs-engineers = member lo edita. La regla se aplica sea cual sea el origen de los grupos: inicio de sesión único de la empresa, grupos SCIM y directorio de la empresa. Los proyectos compartidos directamente con una persona no se ven afectados, y un miembro añadido a mano (en ningún grupo asignado) recibe el rol del permiso de compartición. Cambiar el acceso de un grupo se aplica de inmediato a todas las personas que este colocó.
Puestos de editor. La licencia limita los editores; los lectores y revisores son gratuitos. Cuando el acceso de Editor de un grupo convertiría a alguien en editor y no hay ningún puesto libre, esa persona recibe Lector en su lugar, y el inicio de sesión sigue funcionando. Los Ajustes de la organización y Administración → Directorio de la empresa muestran cuántas personas se mantienen como Lector; la página Directorio de la empresa enumera cada editor cuyo puesto procede de un grupo, y cada persona retenida. Cuando se liberan puestos, las personas retenidas reciben Editor en la siguiente comprobación, por orden de antigüedad de pertenencia.
Servidores en una red cerrada. Cuando el servidor no puede consultar el DNS público, un administrador del sitio puede elegir Marcar como verificado junto a un dominio no verificado en lugar de publicar el registro TXT. El dominio sigue perteneciendo a una sola organización, y el cambio queda registrado en el registro de auditoría.
Reglas de inicio de sesión
Holarch comprueba estrictamente cada respuesta del proveedor de identidad. Un inicio de sesión se rechaza cuando:
- la aserción no está firmada con un certificado configurado, o está firmada con SHA-1;
- el emisor, la audiencia (el ID de entidad de la organización), el destino o el destinatario (la URL de ACS) no coinciden;
- la aserción aún no es válida o ha caducado (se admiten 2 minutos de diferencia de reloj);
- responde a un inicio de sesión que no se inició en el mismo navegador, o a uno que ya se usó (cada inicio de sesión empieza una vez y caduca a los 10 minutos);
- la misma aserción llega una segunda vez (reproducción);
- falta la dirección de correo electrónico o está fuera de los dominios verificados de la organización;
- la cuenta está deshabilitada.
La pantalla de inicio de sesión dice entonces qué falló, y el registro de auditoría de la organización lo registra como auth.sso-failed.
El inicio de sesión desde el portal del proveedor de identidad (iniciado por el IdP, cuando los miembros empiezan desde el panel de aplicaciones del proveedor) está desactivado por defecto, porque esa respuesta no está ligada a un inicio de sesión que haya empezado el navegador. Active Permitir el inicio de sesión desde el portal del proveedor de identidad solo cuando sus miembros lo necesiten. La protección contra la reproducción y todas las demás comprobaciones siguen aplicándose.
Inicio de sesión en dos pasos
Por defecto, un inicio de sesión único es el primer paso. Las cuentas con el inicio de sesión en dos pasos activado siguen confirmando una llave de acceso o un código, y el ajuste Exigir inicio de sesión en dos pasos de la organización sigue pidiéndoselo a los miembros.
Con Confiar en el inicio de sesión multifactor del proveedor de identidad activado, un inicio de sesión cuya aserción indica autenticación multifactor no necesita el segundo paso de Holarch y cumple la exigencia de dos pasos de esta organización para esa sesión (no la de otras organizaciones). Holarch acepta como multifactor estos contextos de autenticación:
| Contexto de autenticación | Enviado por |
|---|---|
https://refeds.org/profile/mfa | Muchos proveedores, si se configuran para ello |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft Entra ID |
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (y …MobileTwoFactorUnregistered) | Okta y otros |
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken | Código de un solo uso |
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard y …SmartcardPKI | Tarjetas inteligentes |
La notificación http://schemas.microsoft.com/claims/authnmethodsreferences de Entra ID con multipleauthn también cuenta. Un inicio de sesión solo con contraseña en el proveedor de identidad no es multifactor, ni siquiera con la confianza activada.
Atributos
| Holarch | Nombres de atributo predeterminados (se usa el primero presente) |
|---|---|
| Correo electrónico (obligatorio) | email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, el NameID cuando es una dirección de correo electrónico, o si no la notificación UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn) |
| Nombre | displayName, name, http://schemas.microsoft.com/identity/claims/displayname, la notificación name de WS-Federation, o el nombre y el apellido (givenName/firstName, sn/surname/lastName y sus formas de notificación) |
| Grupos | El atributo que indique en Atributo de grupos, por ejemplo groups. Si no indica ninguno: groups, memberOf, Role, http://schemas.xmlsoap.org/claims/Group de AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid y …/claims/groups |
La cuenta se encuentra por el NameID del proveedor de identidad (persistente, correo electrónico, nombre calificado de dominio de Windows u otro formato). Sin NameID (AD FS no envía ninguno salvo que una regla de notificación lo emita), la dirección de correo electrónico identifica la cuenta. Cuando el NameID cambia pero la dirección de correo se mantiene, la cuenta se vuelve a vincular.
Los nombres de grupo se comparan sin distinguir mayúsculas y minúsculas. Un nombre calificado con el dominio, como CORP\Packs Engineers, también coincide con una asignación para Packs Engineers, y un SID de grupo (S-1-5-21-…) coincide con una asignación escrita con ese SID.
Grupos a roles
Escriba una asignación por línea: holarch-admins = admin o engineering = member. En cada inicio de sesión, un miembro de un grupo asignado a admin pasa a ser administrador de la organización; si no, un miembro de un grupo asignado pasa a ser miembro. Los miembros que no están en ningún grupo asignado conservan su función. Al último administrador de la organización nunca se le degrada.
SCIM
La API SCIM sigue RFC 7643 y RFC 7644 en https://app.holarch.app/scim/v2 con Authorization: Bearer hsc_….
| Endpoint | Qué hace |
|---|---|
GET /ServiceProviderConfig, /ResourceTypes, /Schemas | Describir el servicio |
GET /Users | Enumerar los usuarios aprovisionados de la organización y los miembros de sus dominios verificados; filter con eq sobre userName, externalId, id, emails.value o emails[type eq "work"].value; startIndex y count |
POST /Users | Crear un usuario (o vincular una cuenta existente con esa dirección) y añadirlo a la organización |
GET, PUT, PATCH /Users/<id> | Leer, reemplazar o cambiar un usuario: userName, name, displayName, emails, externalId, active |
DELETE /Users/<id> | Desactivar el usuario y olvidar el ID externo |
/Groups | Servidores autoalojados: enumerar, crear, leer, sustituir, cambiar (PATCH en members, displayName, externalId, en los formatos de Okta y Microsoft Entra ID) y eliminar grupos; filter con eq en displayName, externalId o id; excludedAttributes=members. Consulte Grupos SCIM y departamentos. Servicio alojado: una lista vacía y los cambios rechazados; asigne en su lugar los grupos a roles en el inicio de sesión único. |
- Solo se pueden crear o cambiar direcciones de los dominios verificados de la organización.
- Desactivar (
active: false, oDELETE) quita a la persona de la organización, deshabilita la cuenta, termina todas sus sesiones y revoca sus tokens de API y aplicaciones conectadas. Reactivar habilita la cuenta y restaura su función en la organización. Una cuenta que Holarch deshabilitó (por ejemplo, tras un abuso) sigue deshabilitada. - Los atributos de la extensión Enterprise se aceptan y se ignoran.
- Cada token puede hacer 600 solicitudes por minuto. Cada cambio queda registrado en el registro de auditoría de la organización (scim.create, scim.deactivate, etc.).
Grupos SCIM y departamentos (autoalojado)
En un servidor autoalojado, el proveedor de identidad puede enviar sus grupos al endpoint SCIM de la organización que tiene el dominio de la empresa. Los Grupos a roles de los departamentos en Inicio de sesión de la empresa deciden entonces quién pertenece a qué departamento y con qué rol. Una misma asignación sirve para ambos: el inicio de sesión mediante el inicio de sesión único de la empresa y los grupos SCIM.
- Una persona añadida a un grupo asignado se une a esa organización con el rol asignado; un cambio de grupo cambia el rol.
- Si se la quita de todos los grupos asignados, una persona deja las organizaciones a las que la añadieron los grupos.
- Las pertenencias añadidas de otro modo (por un administrador de la organización, una invitación, una importación o un inicio de sesión) nunca se quitan ni se rebajan por los grupos; los grupos solo pueden elevarlas a administrador de la organización. Cuando un administrador de la organización cambia a mano el rol de un miembro, la pertenencia pasa a ser suya a partir de entonces.
- El último administrador de una organización nunca se quita ni se rebaja.
- Cambiar los Grupos a roles de un departamento se aplica de inmediato a todas las personas de los grupos.
- Los miembros de un grupo deben ser usuarios que este token aprovisiona o gestiona; los demás ids se ignoran.
- Desactivar un usuario funciona como antes; sus departamentos siguen a sus grupos.
- Cada cambio queda registrado: scim.group-create, scim.group-update y scim.group-delete en el registro de auditoría de la organización de la empresa, y cada cambio de pertenencia en el registro del departamento.
Configurar su proveedor de identidad
Okta
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL: la URL de ACS. Deje marcado Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID): el ID de entidad.
- Name ID format:
EmailAddressoPersistent. Application username: Email. - Attribute statements:
email→user.email,displayName→user.displayName. Group attribute statements (opcional):groups, con el filtro que necesite. - Termine y después copie la Metadata URL de la pestaña Sign On en Holarch y elija Leer metadatos.
- Para SCIM: en la pestaña General de la aplicación, habilite SCIM provisioning; en Provisioning, SCIM connector base URL es la URL base, Unique identifier field
userName, Authentication Mode HTTP Header con el token SCIM; habilite Create Users, Update User Attributes y Deactivate Users.
Microsoft Entra ID
- Enterprise applications → New application → Create your own application (fuera de la galería) y después Single sign-on → SAML.
- Identifier (Entity ID): el ID de entidad. Reply URL (Assertion Consumer Service URL): la URL de ACS.
- Attributes & Claims: la notificación predeterminada
emailaddressfunciona; añada una notificación de grupo si asigna grupos. - En SAML Certificates, copie la App Federation Metadata Url en Holarch y elija Leer metadatos.
- Para confiar en el inicio de sesión multifactor de Entra, exija MFA en una directiva de acceso condicional para la aplicación; Entra envía entonces
multipleauthn. - Para SCIM: Provisioning → Automatic; Tenant URL es la URL base y Secret Token el token SCIM. Test Connection y después inicie el aprovisionamiento.
Microsoft AD FS
AD FS (Active Directory Federation Services, Windows Server 2016 o posterior) inicia la sesión de las personas desde su Active Directory local. En la consola AD FS Management:
- Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online e introduzca la URL de metadatos de Holarch. Si el servidor AD FS no puede llegar a Holarch, guarde los metadatos como archivo y elija Import data about the relying party from a file. Nombre para mostrar: Holarch.
- Access control policy: Permit everyone, o Permit everyone and require MFA (consulte el paso 6).
- Abra Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims de la relación de confianza, almacén de atributos Active Directory:
| Atributo LDAP | Tipo de notificación saliente |
|---|---|
| E-Mail-Addresses | E-Mail Address |
| Display-Name | Nombre |
| Token-Groups – Unqualified Names | Grupo |
Use en su lugar Token-Groups – Qualified by Domain Name cuando dos dominios tienen grupos con el mismo nombre; Token-Groups as SIDs (tipo de notificación Group SID) cuando los nombres de los grupos cambian. Holarch lee las notificaciones Group, Role y Group SID sin Atributo de grupos.
AD FS envía el pre-Windows 2000 name de cada grupo (sAMAccountName), no su nombre para mostrar ni su cn, e incluye el grupo principal (normalmente Domain Users). Asigne los grupos por ese nombre o por SID. En un servidor con el directorio de la empresa conectado, Administración → Directorio de la empresa → Probar un usuario muestra ambos para cada grupo de una persona.
- Opcional, un NameID estable: Add Rule → Transform an Incoming Claim, entrante E-Mail Address (o UPN), saliente Name ID, formato Email (o Persistent Identifier). Sin él, Holarch identifica la cuenta por su dirección de correo electrónico.
- En Properties → Advanced de la relación de confianza, mantenga SHA-256. Deje vacía la pestaña Encryption: Holarch no descifra aserciones, y la conexión es https. AD FS firma la aserción de forma predeterminada (
SamlResponseSignatureAssertionOnly), lo que Holarch exige. - Copie
https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xmlen la URL de metadatos de Holarch y elija Leer metadatos. Rellena el ID de entidad (http://<host>/adfs/services/trust), la URL de inicio de sesión (https://<host>/adfs/ls/) y el certificado de firma de tokens. Para confiar en el inicio de sesión multifactor de AD FS, exija MFA en la directiva de control de acceso y active Confiar en el inicio de sesión multifactor del proveedor de identidad; AD FS envía entonceshttp://schemas.microsoft.com/claims/multipleauthn.
En un servidor autoalojado, la URL de metadatos puede ser una dirección interna (https://adfs.corp.example.com/…, una IP privada), y su certificado se comprueba con la CA de la empresa en tls/ldap-ca.pem además de con las CA de confianza del sistema. El certificado de firma de tokens de AD FS se renueva cada año: Holarch muestra la fecha de caducidad; use Leer metadatos de nuevo cuando AD FS añada el nuevo (ambos se conservan durante el solapamiento). AD FS no tiene SCIM; con un directorio de la empresa en un servidor autoalojado, Holarch comprueba las cuentas por sí mismo (véase más abajo).
Google Workspace
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- Copie los IdP metadata (descárguelos y pegue el XML en Holarch).
- ACS URL: la URL de ACS. Entity ID: el ID de entidad. Name ID format:
EMAIL, Name ID: Basic Information › Primary email. - Attribute mapping: Primary email →
email; First name →givenName; Last name →sn. Group membership →groups(opcional). - Active la aplicación ON for everyone (o para una unidad organizativa).
- Google Workspace no envía un contexto de autenticación MFA; deje desactivado Confiar en el inicio de sesión multifactor del proveedor de identidad. El aprovisionamiento SCIM de Google solo funciona con aplicaciones de la galería; cree las cuentas en su lugar mediante el inicio de sesión único.
Ping Identity
- PingOne: Applications → Add Application → SAML Application (PingFederate: una conexión de SP).
- Importe la URL de metadatos de Holarch, o introduzca la URL de ACS y el ID de entidad.
- Attribute mapping:
saml_subject→ Email Address; añadaemailydisplayName. - Copie la URL de metadatos del IdP en Holarch y elija Leer metadatos.
- Para SCIM: aprovisionamiento de PingOne con una conexión SCIM; la URL base y la autenticación OAuth 2 Bearer Token con el token SCIM.
Directorio de la empresa (Active Directory / LDAP)
En un servidor autoalojado, las personas pueden iniciar sesión con su nombre de usuario y contraseña de la empresa, comprobados por el directorio de la empresa: Active Directory (sus controladores de dominio) u otro directorio LDAP como OpenLDAP o FreeIPA. No se necesita ningún proveedor de identidad. Un administrador del sitio lo configura en Administración → Directorio de la empresa; el .env del servidor puede dar los valores iniciales (HOLARCH_LDAP_*, SIGN-IN.md de la entrega autoalojada). No se ofrece en el servicio alojado.
Configurar el directorio de la empresa
Elija primero el Tipo de directorio en la parte superior de Administración → Directorio de la empresa: Active Directory u Otro directorio LDAP (OpenLDAP, FreeIPA, …). En ambos casos es una sola conexión; el tipo decide qué búsquedas de grupos se ofrecen, los valores que Usar valores predeterminados de Active Directory o Usar valores predeterminados de LDAP ponen en el formulario, y las indicaciones y los ejemplos. Al cambiarlo se reemplaza un filtro de usuarios o una búsqueda de grupos que siga en el valor predeterminado del otro tipo y se conserva un filtro escrito por usted. La página deduce el tipo de los ajustes guardados (los grupos anidados o un filtro de Active Directory significan Active Directory).
- Cree una cuenta de servicio de solo lectura en el directorio (por ejemplo
svc-holarch). Ponga su nombre en Cuenta de enlace y su contraseña en el.envdel servidor comoHOLARCH_LDAP_BIND_PASSWORD, y después reinicie el servidor. La contraseña nunca se muestra en Administración. - En Servidores de directorio, introduzca cada controlador de dominio o servidor LDAP como
ldaps://dc1.corp.example.com(puerto 636), uno por línea; se prueban en orden.ldap://host:389solo funciona con Usar StartTLS activado. El LDAP sin cifrar se rechaza, de modo que una contraseña nunca cruza la red sin cifrar. Use el nombre de host de cada servidor tal como aparece en su certificado. - Ponga el certificado de la CA que emitió los certificados de los servidores en Certificado de CA (PEM), o en
tls/ldap-ca.pemen el servidor. Vacío significa las CA de confianza del sistema. - Introduzca el DN base (
DC=corp,DC=example,DC=com, odc=example,dc=comen otro directorio LDAP) y los Dominios de correo permitidos. - Elija Probar conexión. Se conecta con los valores del formulario, sin guardar, y nombra el problema cuando algo falla (ningún servidor respondió, certificado, cuenta de enlace, DN base).
- En Probar un usuario, introduzca un nombre de usuario para ver lo que encontraría el inicio de sesión: la dirección de correo electrónico, si la cuenta está activa, sus grupos y las organizaciones a las que se uniría. La contraseña es opcional; se comprueba una vez y nunca se almacena.
- Active Permitir iniciar sesión con cuentas de empresa y elija Guardar. La pantalla de inicio de sesión muestra entonces Iniciar sesión con cuenta de empresa (o su Texto del botón).
Active Directory: el Filtro de usuarios predeterminado encuentra a los usuarios activos por sAMAccountName, userPrincipalName o mail, de modo que las personas pueden escribir jsmith, [email protected] o CORP\jsmith. Las cuentas deshabilitadas se excluyen. Búsqueda de grupos ofrece Active Directory, con grupos anidados (el predeterminado) y Atributo memberOf (solo grupos directos).
Otro directorio LDAP: Usar valores predeterminados de LDAP pone (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) en Filtro de usuarios, de modo que las personas escriben su uid o dirección de correo; cualquier filtro funciona con {username} donde va el nombre escrito. Búsqueda de grupos ofrece Atributo memberOf (OpenLDAP con el overlay memberof, FreeIPA, 389 Directory Server) y Grupos que incluyen a la persona como miembro (groupOfNames y groupOfUniqueNames; DN base de grupos indica dónde están). Los grupos anidados no cuentan.
Departamentos a partir de grupos del directorio
Los grupos del directorio colocan a las personas en organizaciones con los mismos Grupos a roles de Inicio de sesión de la empresa que SAML (consulte Inicio de sesión de la empresa para varias organizaciones): en el cuadro Inicio de sesión único de cada organización, asigne grupos a roles, por ejemplo Packs Engineers = member y Packs Leads = admin. Los nombres se comparan sin distinguir mayúsculas y minúsculas; el DN de un grupo también sirve y, en Active Directory, su SID. Active Directory, con grupos anidados cuenta a una persona en un grupo a través de otros grupos que contiene.
En cada inicio de sesión y en cada comprobación periódica, una persona de un grupo asignado se une a esa organización con ese rol, y con el acceso a los proyectos del departamento del grupo. Una pertenencia que dio el directorio se quita cuando la persona deja todos los grupos asignados a ella; las pertenencias añadidas a mano se mantienen (el directorio puede elevar allí a un miembro a administrador de la organización, pero nunca lo rebaja). El último administrador de la organización nunca se quita.
Quién puede iniciar sesión
- La cuenta debe estar activa en el directorio: se rechazan las cuentas deshabilitadas, bloqueadas y caducadas, y también las cuentas cuya contraseña ha caducado o debe cambiarse en el siguiente inicio de sesión.
- La entrada del directorio debe tener una dirección de correo electrónico de un dominio permitido. El primer inicio de sesión crea la cuenta de Holarch o vincula la cuenta existente con esa dirección. Una cuenta ya vinculada a otra entrada del directorio no se usurpa.
- Exigir el inicio de sesión de la empresa en las cuentas vinculadas impide que las cuentas vinculadas inicien sesión con una contraseña de Holarch. Los administradores del sitio conservan su contraseña, de modo que una caída del directorio nunca deja a todo el mundo fuera.
- Las contraseñas erróneas pausan el inicio de sesión de esa cuenta de la empresa durante 15 minutos tras Intentos fallidos antes de una pausa (3 de forma predeterminada), sea cual sea la forma del nombre que se escribió (
jsmith,[email protected],CORP\jsmith). Manténgalo por debajo del umbral de bloqueo del dominio para que Holarch nunca bloquee una cuenta de la empresa. Los nombres de usuario desconocidos y las contraseñas erróneas reciben la misma respuesta, en aproximadamente el mismo tiempo.
Comprobación periódica
Cada Comprobar cuentas cada minutos (15 de forma predeterminada), el servidor consulta cada cuenta vinculada que tiene la sesión iniciada o tiene pertenencias del directorio. Una persona que se deshabilitó, se bloqueó, se quitó del directorio o cuya contraseña caducó o debe cambiarse en el siguiente inicio de sesión (a menudo un restablecimiento por parte de un administrador tras un posible compromiso) cierra la sesión en todas partes y pierde las pertenencias que le dio el directorio; los cambios de grupo actualizan las pertenencias. Una cuenta bloqueada recupera sus pertenencias en su siguiente inicio de sesión tras desbloquearse. Cuando no se puede acceder al directorio, no cambia nada. Cuando falta la mayoría de las cuentas comprobadas (por ejemplo, tras un DN base erróneo), no se finaliza nada y Administración muestra la advertencia. Comprobar ahora ejecuta la comprobación de inmediato. Administración muestra el resultado de la última comprobación.
Cada comprobación también consulta los miembros de todos los grupos asignados (los grupos anidados cuentan con Active Directory, con grupos anidados) y crea cuentas para las personas que aún no tienen ninguna, con las mismas reglas que el inicio de sesión (activa, un dominio de correo permitido, sin usurpar una cuenta vinculada en otro lugar). No se envía ningún correo electrónico; la persona inicia sesión con su cuenta de la empresa cuando necesita Holarch por primera vez, y ya está en sus departamentos, de modo que se pueden compartir proyectos con ella antes. Una comprobación crea como máximo 200 cuentas; Administración muestra cuántas más esperan a la siguiente comprobación. Los grupos indicados solo por SID no se consultan de este modo; sus personas se colocan al iniciar sesión.
Inicio de sesión en dos pasos con el directorio de la empresa
El inicio de sesión de la empresa es el primer paso. Las organizaciones que exigen el inicio de sesión en dos pasos siguen pidiendo el segundo paso de Holarch (una llave de acceso o un código), y las cuentas con el inicio de sesión en dos pasos activado siguen confirmándolo. Active Contar el inicio de sesión de la empresa como inicio de sesión en dos pasos solo cuando la propia cuenta de la empresa necesite un segundo factor; entonces cumple el requisito de dos pasos de todas las organizaciones durante esa sesión.
Cada inicio de sesión del directorio, cada rechazo y cada cambio de ajustes figuran en el registro de auditoría (admin.directory-save, admin.directory-test, directory.account-ended) y en los registros de inicio de sesión de cada cuenta. Las contraseñas nunca se registran.
Límites y notas de seguridad
Límite: el inicio de sesión único usa el enlace HTTP-Redirect hacia el proveedor de identidad y HTTP-POST de vuelta a Holarch. No se admiten las solicitudes de autenticación firmadas y cifradas, las aserciones cifradas ni el cierre de sesión único. Los grupos SCIM solo se admiten en servidores autoalojados (Grupos SCIM y departamentos). El directorio de la empresa inicia sesión con nombre de usuario y contraseña (enlace simple sobre TLS); no se admiten Kerberos ni el inicio de sesión integrado de Windows.
- Los cambios de ajustes necesitan una comprobación reciente de la contraseña, se notifican por correo electrónico a todos los administradores de la organización y quedan registrados en el registro de auditoría (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
- Las URL de metadatos deben usar https en la Internet pública (en un servidor autoalojado también se permiten direcciones internas); Holarch las obtiene una vez, cuando elige Leer metadatos.
- Los tokens SCIM solo se guardan como hash.