Administration
Authentification unique et SCIM
Connectez le fournisseur d'identité SAML 2.0 d'une organisation (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping), ou directement l'Active Directory d'un serveur auto-hébergé, vérifiez ses domaines de messagerie, imposez l'authentification unique, associez des groupes à des rôles et provisionnez les comptes avec SCIM 2.0.
Sur cette page
- Concepts
- Mode d'emploi
- Vérifier un domaine de messagerie
- Connecter le fournisseur d'identité
- Activer l'authentification unique
- Exiger l'authentification unique
- Provisionner les comptes avec SCIM
- Lorsque le certificat du fournisseur d'identité change
- Connexion de l'entreprise pour plusieurs organisations (auto-hébergé)
- Accès aux projets du service (auto-hébergé)
- Règles de connexion
- Attributs
- SCIM
- Configurer votre fournisseur d'identité
- Annuaire de l'entreprise (Active Directory / LDAP)
- Limites et notes de sécurité
Une organisation peut permettre à ses membres de se connecter à Holarch avec leur compte professionnel. Holarch est le fournisseur de services ; le fournisseur d'identité de votre organisation (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity ou tout fournisseur SAML 2.0) vérifie leur identité. Le fournisseur d'identité peut aussi créer, mettre à jour et désactiver des comptes Holarch via SCIM 2.0.
L'authentification unique est configurée par un administrateur d'organisation sous Paramètres de l'organisation → l'organisation → Accès et connexion → Authentification unique. Elle fonctionne sur le service hébergé et sur les serveurs auto-hébergés, pas dans l'application de bureau. Un serveur auto-hébergé a besoin d'un accès sortant pour vérifier un domaine (une requête DNS) et pour lire des métadonnées depuis une URL. Un serveur auto-hébergé peut aussi vérifier lui-même les comptes d'entreprise avec Active Directory ou un autre annuaire LDAP, sans fournisseur d'identité : voir Annuaire de l'entreprise (Active Directory / LDAP).
Remarque : l'authentification unique et le provisionnement SCIM font partie de l'offre Team (celle de l'organisation). Les organisations qui les utilisaient avant la version 2.29.0 les conservent. Sans l'offre, les paramètres sont conservés, mais les membres se connectent avec leur mot de passe (Mot de passe oublié ? en définit un), Google ou Microsoft, et les requêtes SCIM sont refusées.
Concepts
| Terme | Signification |
|---|---|
| Domaine vérifié | Un domaine de messagerie (comme example.com) dont l'organisation a prouvé qu'elle le contrôle avec un enregistrement DNS TXT. L'authentification unique et SCIM ne fonctionnent que pour les adresses des domaines vérifiés. Un domaine ne peut être vérifié que par une seule organisation. |
| Fournisseur d'identité (IdP) | Le service qui connecte vos membres : son ID d'entité (émetteur), son URL de connexion et son certificat de signature. |
| Fournisseur de services (SP) | Holarch, pour cette organisation. Chaque organisation a son propre ID d'entité, sa propre URL ACS et sa propre URL de métadonnées. |
| Membres gérés | Les membres de l'organisation dont l'adresse e-mail appartient à un domaine vérifié et qui ne sont pas administrateurs d'organisation. Exiger l'authentification unique s'applique à eux. |
| Jeton SCIM | Un secret que le fournisseur d'identité utilise pour appeler l'API SCIM de Holarch pour cette organisation. Il n'est lié à aucune personne. |
Mode d'emploi
Vérifier un domaine de messagerie
- Ouvrez Paramètres de l'organisation, sélectionnez l'organisation, ouvrez Accès et connexion et trouvez Authentification unique.
- Sous Domaines de messagerie, saisissez le domaine des adresses de vos membres et choisissez Ajouter un domaine.
- Publiez l'enregistrement TXT affiché : le nom
_holarch-challenge.<domain>avec la valeurholarch-domain-verification=…. - Choisissez Vérifier. Les modifications DNS peuvent mettre quelques minutes à se propager ; vérifiez de nouveau jusqu'à ce que le domaine affiche Vérifié.
Ajoutez chaque domaine utilisé par vos membres (par exemple example.com et eng.example.com). Jusqu'à 20 domaines par organisation.
Connecter le fournisseur d'identité
- Dans votre fournisseur d'identité, créez une application SAML 2.0 (voir les sections des fournisseurs ci-dessous) avec les valeurs indiquées sous Fournisseur d'identité dans Holarch :
- ID d'entité (audience) :
https://app.holarch.app/api/auth/saml/<organization id>/metadata - URL ACS (URL de réponse) :
https://app.holarch.app/api/auth/saml/<organization id>/acs - URL des métadonnées : la même que l'ID d'entité ; les fournisseurs qui importent les métadonnées SP peuvent l'utiliser.
- ID d'entité (audience) :
- Copiez le XML des métadonnées du fournisseur ou son URL de métadonnées dans la zone en haut et choisissez Lire les métadonnées. Holarch remplit l'ID d'entité, l'URL de connexion et le certificat. Ou saisissez-les vous-même.
- Sous Attributs et rôles, définissez les noms d'attributs si votre fournisseur en utilise d'inhabituels (voir Attributs), le Rôle des nouveaux membres et, si vous le souhaitez, Groupes vers rôles.
- Choisissez Enregistrer le fournisseur d'identité et saisissez votre mot de passe.
Activer l'authentification unique
- Cochez Authentification unique pour cette organisation. Elle nécessite un fournisseur d'identité enregistré et un domaine vérifié.
- Donnez aux membres le Lien de connexion pour les membres, ou dites-leur de choisir Se connecter avec l'authentification unique sur l'écran de connexion et de saisir leur adresse e-mail professionnelle.
- Essayez d'abord avec un seul membre.
À la première connexion d'un membre, Holarch crée le compte (confirmé, sans mot de passe) et l'ajoute à l'organisation, même lorsque l'inscription nécessite une invitation. Lorsqu'un compte avec cette adresse existe, l'authentification unique lui est associée et son titulaire reçoit un e-mail.
Exiger l'authentification unique
Cochez Exiger l'authentification unique pour les membres des domaines vérifiés une fois que l'authentification unique fonctionne.
- Les membres gérés ne se connectent alors que par le fournisseur d'identité. La connexion par mot de passe, clé d'accès, Google et Microsoft répond que l'organisation exige l'authentification unique, avec un bouton qui y mène. Leurs sessions en cours ouvertes par d'autres méthodes de connexion prennent fin aussitôt.
- Les administrateurs d'organisation ne sont pas concernés par l'obligation : ils conservent leur mot de passe ou leur clé d'accès avec la connexion en deux étapes, afin de pouvoir réparer une configuration défectueuse du fournisseur d'identité (accès de secours). Gardez au moins deux administrateurs d'organisation.
- Les membres dont l'adresse est hors des domaines vérifiés (collaborateurs extérieurs) ne sont pas concernés.
- Une réinitialisation du mot de passe définit toujours le nouveau mot de passe mais ne connecte pas le membre ; il se connecte ensuite par le fournisseur d'identité.
- Les jetons API et les applications connectées des membres gérés continuent de fonctionner. Désactivez le compte via SCIM pour y mettre fin.
Provisionner les comptes avec SCIM
- Sous Provisionnement (SCIM 2.0), choisissez Créer un jeton SCIM et saisissez votre mot de passe.
- Copiez le jeton et l'URL de base (
https://app.holarch.app/scim/v2) dans les paramètres de provisionnement de votre fournisseur d'identité. Holarch n'affiche le jeton qu'une seule fois. - Activez la création, la mise à jour et la désactivation des utilisateurs dans le fournisseur.
Jusqu'à 5 jetons par organisation. Révoquer met fin à un jeton aussitôt.
Lorsque le certificat du fournisseur d'identité change
- Collez le nouveau certificat sous l'ancien (deux certificats sont autorisés) et enregistrez.
- Faites passer le fournisseur au nouveau certificat.
- Retirez l'ancien certificat et enregistrez de nouveau.
La liste des certificats affiche le sujet, la date d'expiration et l'empreinte de chaque certificat.
Connexion de l'entreprise pour plusieurs organisations (auto-hébergé)
Un domaine e-mail appartient à une seule organisation. Lorsqu'une entreprise exploite une organisation par service sur un serveur auto-hébergé, une organisation (généralement celle de l'informatique) vérifie le domaine de l'entreprise, connecte le fournisseur d'identité et active l'authentification unique. Les autres organisations associent ensuite des groupes du fournisseur d'identité à leurs propres rôles :
- Dans Paramètres de l'organisation → Accès et connexion → Authentification unique du service, repérez Connexion de l'entreprise. Elle nomme l'organisation qui gère la connexion de l'entreprise.
- Sous Groupes vers rôles, écrivez une association par ligne, par exemple
packs-engineers = memberetpacks-leads = admin, puis choisissez Enregistrer les groupes. - Facultatif : ajoutez l'accès aux projets du service du groupe après une virgule, par exemple
packs-contractors = member, viewer. Voir Accès aux projets du service.
À chaque connexion par la connexion de l'entreprise, une personne d'un groupe associé rejoint cette organisation avec ce rôle, ou y devient administrateur d'organisation. La connexion ne retire ni n'abaisse jamais personne (les groupes SCIM le peuvent : voir Groupes SCIM et services) ; les administrateurs d'organisation retirent les personnes dans les paramètres de l'organisation. Le fournisseur d'identité doit envoyer les groupes (Attribut des groupes de la connexion de l'entreprise).
Les administrateurs de l'organisation qui gère la connexion de l'entreprise contrôlent la connexion pour toutes les adresses du domaine. Réservez cette organisation aux personnes qui gèrent le fournisseur d'identité.
Accès aux projets du service (auto-hébergé)
Chaque association de groupe peut aussi indiquer ce que ses membres obtiennent sur les projets partagés avec l'organisation entière (Partager → Organisations) : viewer, reviewer ou editor (par défaut). Le rôle d'une personne sur un tel projet est le plus bas entre le rôle du partage et l'accès le plus élevé parmi ses groupes associés à cette organisation. Par exemple, avec un projet partagé en tant qu'Éditeur et packs-contractors = member, viewer, un prestataire le consulte ; une personne à la fois dans packs-contractors et packs-engineers = member le modifie. La règle s'applique quelle que soit la provenance des groupes : authentification unique de l'entreprise, groupes SCIM et annuaire de l'entreprise. Les projets partagés directement avec une personne ne sont pas concernés, et un membre ajouté à la main (dans aucun groupe associé) reçoit le rôle du partage. Modifier l'accès d'un groupe s'applique aussitôt à toutes les personnes qu'il a placées.
Sièges d'éditeur. La licence limite les éditeurs ; les lecteurs et les relecteurs sont gratuits. Lorsque l'accès Éditeur d'un groupe ferait de quelqu'un un éditeur et qu'aucun siège n'est libre, cette personne reçoit Lecteur à la place, et la connexion fonctionne toujours. Les paramètres de l'organisation et Admin → Annuaire de l'entreprise indiquent combien de personnes sont maintenues en Lecteur ; la page Annuaire de l'entreprise liste chaque éditeur dont le siège provient d'un groupe, ainsi que chaque personne maintenue. Lorsque des sièges se libèrent, les personnes maintenues reçoivent Éditeur à la vérification suivante, adhésion la plus ancienne d'abord.
Serveurs sur un réseau fermé. Lorsque le serveur ne peut pas interroger le DNS public, un administrateur du site peut choisir Marquer comme vérifié à côté d'un domaine non vérifié au lieu de publier l'enregistrement TXT. Le domaine n'appartient toujours qu'à une seule organisation, et la modification est consignée dans le journal d'audit.
Règles de connexion
Holarch vérifie strictement chaque réponse du fournisseur d'identité. Une connexion est refusée lorsque :
- l'assertion n'est pas signée avec un certificat configuré, ou est signée avec SHA-1 ;
- l'émetteur, l'audience (l'ID d'entité de l'organisation), la destination ou le destinataire (l'URL ACS) ne correspondent pas ;
- l'assertion n'est pas encore valide ou a expiré (2 minutes d'écart d'horloge sont tolérées) ;
- elle répond à une connexion qui n'a pas été lancée dans le même navigateur, ou qui a déjà été utilisée (chaque connexion ne démarre qu'une fois et expire au bout de 10 minutes) ;
- la même assertion arrive une seconde fois (rejeu) ;
- l'adresse e-mail est absente ou hors des domaines vérifiés de l'organisation ;
- le compte est désactivé.
L'écran de connexion indique alors ce qui n'a pas fonctionné, et le journal d'audit de l'organisation l'enregistre comme auth.sso-failed.
La connexion depuis le portail du fournisseur d'identité (initiée par l'IdP, lorsque les membres partent du tableau de bord d'applications du fournisseur) est désactivée par défaut, car une telle réponse n'est liée à aucune connexion lancée par le navigateur. N'activez Autoriser la connexion depuis le portail du fournisseur d'identité que si vos membres en ont besoin. La protection contre le rejeu et tous les autres contrôles s'appliquent toujours.
Connexion en deux étapes
Par défaut, une authentification unique constitue la première étape. Les comptes dont la connexion en deux étapes est activée confirment toujours une clé d'accès ou un code, et le paramètre Exiger la connexion en deux étapes de l'organisation la demande toujours aux membres.
Avec Faire confiance à la connexion multifacteur du fournisseur d'identité activé, une connexion dont l'assertion signale une authentification multifacteur ne nécessite pas de seconde étape Holarch, et elle satisfait l'exigence de connexion en deux étapes de cette organisation pour cette session (pas celle d'autres organisations). Holarch accepte ces contextes d'authentification comme multifacteurs :
| Contexte d'authentification | Envoyé par |
|---|---|
https://refeds.org/profile/mfa | De nombreux fournisseurs, lorsqu'ils sont configurés pour cela |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft Entra ID |
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (et …MobileTwoFactorUnregistered) | Okta et d'autres |
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken | Code à usage unique |
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard et …SmartcardPKI | Cartes à puce |
La revendication http://schemas.microsoft.com/claims/authnmethodsreferences d'Entra ID avec multipleauthn compte aussi. Une connexion avec seulement un mot de passe auprès du fournisseur d'identité n'est pas multifacteur, même avec la confiance activée.
Attributs
| Holarch | Noms d'attributs par défaut (le premier présent est utilisé) |
|---|---|
| E-mail (obligatoire) | email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, le NameID lorsqu'il s'agit d'une adresse e-mail, ou à défaut la revendication UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn) |
| Nom | displayName, name, http://schemas.microsoft.com/identity/claims/displayname, la revendication WS-Federation name, ou le prénom et le nom de famille (givenName/firstName, sn/surname/lastName et leurs formes de revendication) |
| Groupes | L'attribut que vous indiquez dans Attribut des groupes, par exemple groups. Si aucun n'est indiqué : groups, memberOf, Role, le http://schemas.xmlsoap.org/claims/Group d'AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid et …/claims/groups |
Le compte est retrouvé par le NameID du fournisseur d'identité (persistant, e-mail, nom qualifié de domaine Windows ou autre format). Sans NameID (AD FS n'en envoie pas, sauf si une règle de revendication en émet un), c'est l'adresse e-mail qui identifie le compte. Lorsque le NameID change mais que l'adresse e-mail reste la même, le compte est relié à nouveau.
Les noms de groupes sont comparés sans tenir compte de la casse. Un nom qualifié par le domaine, comme CORP\Packs Engineers, correspond aussi à une association pour Packs Engineers, et un SID de groupe (S-1-5-21-…) correspond à une association écrite avec ce SID.
Groupes vers rôles
Écrivez une correspondance par ligne : holarch-admins = admin ou engineering = member. À chaque connexion, un membre d'un groupe associé à admin devient administrateur d'organisation ; sinon, un membre d'un groupe associé devient membre. Les membres qui ne sont dans aucun groupe associé conservent leur rôle. Le dernier administrateur d'organisation n'est jamais rétrogradé.
SCIM
L'API SCIM suit les RFC 7643 et RFC 7644 à https://app.holarch.app/scim/v2 avec Authorization: Bearer hsc_….
| Point de terminaison | Ce qu'il fait |
|---|---|
GET /ServiceProviderConfig, /ResourceTypes, /Schemas | Décrire le service |
GET /Users | Lister les utilisateurs provisionnés de l'organisation et les membres de ses domaines vérifiés ; filter avec eq sur userName, externalId, id, emails.value ou emails[type eq "work"].value ; startIndex et count |
POST /Users | Créer un utilisateur (ou associer un compte existant ayant cette adresse) et l'ajouter à l'organisation |
GET, PUT, PATCH /Users/<id> | Lire, remplacer ou modifier un utilisateur : userName, name, displayName, emails, externalId, active |
DELETE /Users/<id> | Désactiver l'utilisateur et oublier l'ID externe |
/Groups | Serveurs auto-hébergés : lister, créer, lire, remplacer, modifier (PATCH sur members, displayName, externalId, dans les formes d'Okta et de Microsoft Entra ID) et supprimer des groupes ; filter avec eq sur displayName, externalId ou id ; excludedAttributes=members. Voir Groupes SCIM et services. Service hébergé : une liste vide, modifications refusées ; associez plutôt les groupes aux rôles dans l'authentification unique. |
- Seules les adresses des domaines vérifiés de l'organisation peuvent être créées ou modifiées.
- La désactivation (
active: false, ouDELETE) retire la personne de l'organisation, désactive le compte, met fin à toutes ses sessions et révoque ses jetons API et ses applications connectées. La réactivation active le compte et rétablit son rôle dans l'organisation. Un compte que Holarch a désactivé (par exemple après un abus) reste désactivé. - Les attributs de l'extension Enterprise sont acceptés et ignorés.
- Chaque jeton peut effectuer 600 requêtes par minute. Chaque modification est enregistrée dans le journal d'audit de l'organisation (scim.create, scim.deactivate, etc.).
Groupes SCIM et services (auto-hébergé)
Sur un serveur auto-hébergé, le fournisseur d'identité peut envoyer ses groupes au point de terminaison SCIM de l'organisation qui détient le domaine de l'entreprise. Les Groupes vers rôles des services, sous Connexion de l'entreprise, décident alors qui appartient à quel service, avec quel rôle. Une même association sert aux deux : la connexion par l'authentification unique de l'entreprise et les groupes SCIM.
- Une personne ajoutée à un groupe associé rejoint cette organisation avec le rôle associé ; un changement de groupe change le rôle.
- Retirée de tous les groupes associés, une personne quitte les organisations auxquelles les groupes l'avaient ajoutée.
- Les adhésions ajoutées d'une autre manière (par un administrateur d'organisation, une invitation, un import ou une connexion) ne sont jamais retirées ni abaissées par les groupes ; les groupes peuvent seulement les élever au rang d'administrateur d'organisation. Lorsqu'un administrateur d'organisation change à la main le rôle d'un membre, l'adhésion lui appartient dès lors.
- Le dernier administrateur d'une organisation n'est jamais retiré ni abaissé.
- Modifier les Groupes vers rôles d'un service s'applique aussitôt à toutes les personnes des groupes.
- Les membres des groupes doivent être des utilisateurs que ce jeton provisionne ou gère ; les autres identifiants sont ignorés.
- La désactivation d'un utilisateur fonctionne comme avant ; ses services suivent ses groupes.
- Chaque modification est consignée : scim.group-create, scim.group-update et scim.group-delete dans le journal d'audit de l'organisation de l'entreprise, et chaque changement d'adhésion dans le journal du service.
Configurer votre fournisseur d'identité
Okta
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL : l'URL ACS. Laissez Use this for Recipient URL and Destination URL coché. Audience URI (SP Entity ID) : l'ID d'entité.
- Name ID format :
EmailAddressouPersistent. Application username : Email. - Attribute statements :
email→user.email,displayName→user.displayName. Group attribute statements (facultatif) :groups, avec le filtre dont vous avez besoin. - Terminez, puis copiez la Metadata URL depuis l'onglet Sign On dans Holarch et choisissez Lire les métadonnées.
- Pour SCIM : dans l'onglet General de l'application, activez SCIM provisioning ; dans Provisioning, SCIM connector base URL est l'URL de base, Unique identifier field
userName, Authentication Mode HTTP Header avec le jeton SCIM ; activez Create Users, Update User Attributes et Deactivate Users.
Microsoft Entra ID
- Enterprise applications → New application → Create your own application (hors galerie), puis Single sign-on → SAML.
- Identifier (Entity ID) : l'ID d'entité. Reply URL (Assertion Consumer Service URL) : l'URL ACS.
- Attributes & Claims : la revendication
emailaddresspar défaut fonctionne ; ajoutez une revendication de groupe si vous associez des groupes. - Sous SAML Certificates, copiez l'App Federation Metadata Url dans Holarch et choisissez Lire les métadonnées.
- Pour faire confiance à la connexion multifacteur d'Entra, exigez la MFA dans une stratégie d'accès conditionnel pour l'application ; Entra envoie alors
multipleauthn. - Pour SCIM : Provisioning → Automatic ; Tenant URL est l'URL de base et Secret Token le jeton SCIM. Test Connection, puis lancez le provisionnement.
Microsoft AD FS
AD FS (Active Directory Federation Services, Windows Server 2016 ou version ultérieure) connecte les personnes de votre Active Directory local. Dans la console AD FS Management :
- Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online, puis saisissez l'URL des métadonnées de Holarch. Si le serveur AD FS ne peut pas joindre Holarch, enregistrez les métadonnées dans un fichier et choisissez Import data about the relying party from a file. Nom d'affichage : Holarch.
- Access control policy : Permit everyone, ou Permit everyone and require MFA (voir l'étape 6).
- Ouvrez Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims de l'approbation, magasin d'attributs Active Directory :
| Attribut LDAP | Type de revendication sortante |
|---|---|
| E-Mail-Addresses | E-Mail Address |
| Display-Name | Nom |
| Token-Groups – Unqualified Names | Groupe |
Utilisez plutôt Token-Groups – Qualified by Domain Name lorsque deux domaines ont des groupes du même nom ; Token-Groups as SIDs (type de revendication Group SID) lorsque les noms de groupes changent. Holarch lit les revendications Group, Role et Group SID sans Attribut des groupes.
AD FS envoie le pre-Windows 2000 name (nom antérieur à Windows 2000, sAMAccountName) de chaque groupe, pas son nom d'affichage ni son cn, et il inclut le groupe principal (généralement Domain Users). Associez les groupes par ce nom, ou par SID. Sur un serveur où l'annuaire de l'entreprise est connecté, Admin → Annuaire de l'entreprise → Tester un utilisateur affiche les deux pour chacun des groupes d'une personne.
- Facultatif, un NameID stable : Add Rule → Transform an Incoming Claim, entrant E-Mail Address (ou UPN), sortant Name ID, format Email (ou Persistent Identifier). Sans lui, Holarch identifie le compte par son adresse e-mail.
- Dans Properties → Advanced de l'approbation, conservez SHA-256. Laissez l'onglet Encryption vide : Holarch ne déchiffre pas les assertions, et la connexion est en https. AD FS signe l'assertion par défaut (
SamlResponseSignatureAssertionOnly), ce que Holarch exige. - Copiez
https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xmldans l'URL des métadonnées de Holarch et choisissez Lire les métadonnées. Cela remplit l'ID d'entité (http://<host>/adfs/services/trust), l'URL de connexion (https://<host>/adfs/ls/) et le certificat de signature de jetons. Pour faire confiance à la connexion multifacteur d'AD FS, exigez la MFA dans la stratégie de contrôle d'accès et activez Faire confiance à la connexion multifacteur du fournisseur d'identité ; AD FS envoie alorshttp://schemas.microsoft.com/claims/multipleauthn.
Sur un serveur auto-hébergé, l'URL des métadonnées peut être une adresse interne (https://adfs.corp.example.com/…, une IP privée), et son certificat est vérifié par rapport à la CA de l'entreprise dans tls/ldap-ca.pem ainsi qu'aux CA de confiance du système. Le certificat de signature de jetons d'AD FS est renouvelé chaque année : Holarch affiche la date d'expiration ; utilisez à nouveau Lire les métadonnées lorsque AD FS ajoute le nouveau (les deux sont conservés pendant la période de chevauchement). AD FS n'a pas de SCIM ; avec un annuaire d'entreprise sur un serveur auto-hébergé, Holarch vérifie lui-même les comptes (ci-dessous).
Google Workspace
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- Copiez les IdP metadata (téléchargez-les, puis collez le XML dans Holarch).
- ACS URL : l'URL ACS. Entity ID : l'ID d'entité. Name ID format :
EMAIL, Name ID : Basic Information › Primary email. - Attribute mapping : Primary email →
email; First name →givenName; Last name →sn. Group membership →groups(facultatif). - Réglez l'application sur ON for everyone (ou pour une unité organisationnelle).
- Google Workspace n'envoie pas de contexte d'authentification MFA ; laissez Faire confiance à la connexion multifacteur du fournisseur d'identité désactivé. Le provisionnement SCIM de Google ne fonctionne qu'avec les applications de la galerie ; créez plutôt les comptes par l'authentification unique.
Ping Identity
- PingOne : Applications → Add Application → SAML Application (PingFederate : une connexion SP).
- Importez l'URL des métadonnées de Holarch, ou saisissez l'ACS URL et l'Entity ID.
- Attribute mapping :
saml_subject→ Email Address ; ajoutezemailetdisplayName. - Copiez l'URL des métadonnées de l'IdP dans Holarch et choisissez Lire les métadonnées.
- Pour SCIM : provisionnement PingOne avec une connexion SCIM ; l'URL de base et l'authentification OAuth 2 Bearer Token avec le jeton SCIM.
Annuaire de l'entreprise (Active Directory / LDAP)
Sur un serveur auto-hébergé, les personnes peuvent se connecter avec leur nom d'utilisateur et leur mot de passe d'entreprise, vérifiés par l'annuaire de l'entreprise : Active Directory (ses contrôleurs de domaine) ou un autre annuaire LDAP tel qu'OpenLDAP ou FreeIPA. Aucun fournisseur d'identité n'est nécessaire. Un administrateur du site le configure dans Admin → Annuaire de l'entreprise ; le fichier .env du serveur peut fournir les valeurs de départ (HOLARCH_LDAP_*, SIGN-IN.md de la livraison auto-hébergée). Ce n'est pas proposé sur le service hébergé.
Configurer l'annuaire de l'entreprise
Choisissez d'abord le Type d'annuaire en haut de Admin → Annuaire de l'entreprise : Active Directory ou Autre annuaire LDAP (OpenLDAP, FreeIPA, …). Il s'agit d'une seule connexion dans les deux cas ; le type détermine les recherches de groupes proposées, les valeurs que Utiliser les valeurs par défaut d'Active Directory ou Utiliser les valeurs par défaut LDAP placent dans le formulaire, ainsi que les indications et les exemples. Le changer remplace un filtre utilisateur ou une recherche de groupes encore à la valeur par défaut de l'autre type et conserve un filtre que vous avez écrit. La page déduit le type des paramètres enregistrés (des groupes imbriqués ou un filtre Active Directory signifient Active Directory).
- Créez un compte de service en lecture seule dans l'annuaire (par exemple
svc-holarch). Indiquez son nom dans Compte de liaison et son mot de passe dans le fichier.envdu serveur en tant queHOLARCH_LDAP_BIND_PASSWORD, puis redémarrez le serveur. Le mot de passe n'est jamais affiché dans Admin. - Sous Serveurs d'annuaire, saisissez chaque contrôleur de domaine ou serveur LDAP sous la forme
ldaps://dc1.corp.example.com(port 636), un par ligne ; ils sont essayés dans l'ordre.ldap://host:389ne fonctionne qu'avec Utiliser StartTLS activé. Le LDAP en clair est refusé, de sorte qu'un mot de passe ne traverse jamais le réseau sans chiffrement. Utilisez le nom d'hôte de chaque serveur tel qu'il figure dans son certificat. - Placez le certificat de la CA qui a émis les certificats des serveurs dans Certificat de la CA (PEM), ou dans
tls/ldap-ca.pemsur le serveur. Vide signifie les CA de confiance du système. - Saisissez le DN de base (
DC=corp,DC=example,DC=com, oudc=example,dc=comdans un autre annuaire LDAP) et les Domaines e-mail autorisés. - Choisissez Tester la connexion. Le test se connecte avec les valeurs du formulaire, sans les enregistrer, et nomme le problème en cas d'échec (aucun serveur n'a répondu, certificat, compte de liaison, DN de base).
- Sous Tester un utilisateur, saisissez un nom d'utilisateur pour voir ce que la connexion trouverait : l'adresse e-mail, si le compte est actif, ses groupes et les organisations qu'il rejoindrait. Le mot de passe est facultatif ; il est vérifié une fois et jamais stocké.
- Activez Autoriser la connexion avec les comptes d'entreprise et choisissez Enregistrer. L'écran de connexion affiche alors Se connecter avec le compte d'entreprise (ou votre Texte du bouton).
Active Directory : le Filtre utilisateur par défaut trouve les utilisateurs actifs par sAMAccountName, userPrincipalName ou mail, si bien que les personnes peuvent saisir jsmith, [email protected] ou CORP\jsmith. Les comptes désactivés sont exclus. Recherche des groupes propose Active Directory, avec groupes imbriqués (par défaut) et Attribut memberOf (groupes directs uniquement).
Autre annuaire LDAP : Utiliser les valeurs par défaut LDAP place (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) dans Filtre utilisateur, si bien que les personnes saisissent leur uid ou leur adresse e-mail ; tout filtre fonctionne avec {username} à l'endroit du nom saisi. Recherche des groupes propose Attribut memberOf (OpenLDAP avec l'overlay memberof, FreeIPA, 389 Directory Server) et Groupes qui listent la personne comme membre (groupOfNames et groupOfUniqueNames ; DN de base des groupes indique où ils se trouvent). Les groupes imbriqués ne comptent pas.
Services à partir des groupes d'annuaire
Les groupes d'annuaire placent les personnes dans les organisations avec les mêmes Groupes vers rôles sous Connexion de l'entreprise que SAML (voir Connexion de l'entreprise pour plusieurs organisations) : dans la zone Authentification unique de chaque organisation, associez les groupes aux rôles, par exemple Packs Engineers = member et Packs Leads = admin. Les noms sont comparés sans tenir compte de la casse ; le DN d'un groupe fonctionne aussi et, dans Active Directory, son SID. Active Directory, avec groupes imbriqués compte une personne dans un groupe par l'intermédiaire d'autres groupes qu'il contient.
À chaque connexion et à chaque vérification périodique, une personne d'un groupe associé rejoint cette organisation avec ce rôle, et avec l'accès aux projets du service du groupe. Une adhésion donnée par l'annuaire est retirée lorsque la personne quitte tous les groupes associés à celle-ci ; les adhésions ajoutées à la main restent (l'annuaire peut y élever un membre au rang d'administrateur d'organisation, mais ne l'abaisse jamais). Le dernier administrateur d'organisation n'est jamais retiré.
Qui peut se connecter
- Le compte doit être actif dans l'annuaire : les comptes désactivés, verrouillés et expirés sont refusés, de même que les comptes dont le mot de passe a expiré ou doit être changé à la prochaine ouverture de session.
- L'entrée d'annuaire doit avoir une adresse e-mail dans un domaine autorisé. La première connexion crée le compte Holarch, ou relie le compte existant ayant cette adresse. Un compte déjà relié à une autre entrée d'annuaire n'est pas repris.
- Exiger la connexion d'entreprise pour les comptes liés empêche les comptes liés de se connecter avec un mot de passe Holarch. Les administrateurs du site conservent leur mot de passe, de sorte qu'une panne de l'annuaire ne bloque jamais tout le monde.
- Les mots de passe erronés suspendent la connexion de ce compte d'entreprise pendant 15 minutes après Tentatives échouées avant une pause (3 par défaut), quelle que soit la forme du nom saisie (
jsmith,[email protected],CORP\jsmith). Gardez cette valeur en dessous du seuil de verrouillage du domaine afin que Holarch ne verrouille jamais un compte d'entreprise. Les noms d'utilisateur inconnus et les mots de passe erronés reçoivent la même réponse, dans à peu près le même délai.
Vérification périodique
Toutes les Vérifier les comptes toutes les minutes (15 par défaut), le serveur interroge chaque compte lié qui est connecté ou détient des adhésions issues de l'annuaire. Une personne désactivée, verrouillée, retirée de l'annuaire, ou dont le mot de passe a expiré ou doit être changé à la prochaine ouverture de session (souvent une réinitialisation par un administrateur après une compromission présumée) est déconnectée partout et perd les adhésions données par l'annuaire ; les changements de groupes mettent à jour les adhésions. Un compte verrouillé récupère ses adhésions à sa prochaine connexion après son déverrouillage. Lorsque l'annuaire est injoignable, rien ne change. Lorsque la plupart des comptes vérifiés sont introuvables (par exemple après un DN de base erroné), rien n'est terminé et Admin affiche l'avertissement. Vérifier maintenant lance la vérification aussitôt. Admin affiche le résultat de la dernière vérification.
Chaque vérification interroge aussi les membres de chaque groupe associé (les groupes imbriqués comptent avec Active Directory, avec groupes imbriqués) et crée des comptes pour les personnes qui n'en ont pas encore, selon les mêmes règles que la connexion (actif, un domaine e-mail autorisé, aucune reprise d'un compte relié ailleurs). Aucun e-mail n'est envoyé ; la personne se connecte avec son compte d'entreprise lorsqu'elle a besoin de Holarch pour la première fois, et elle se trouve déjà dans ses services, si bien que des projets peuvent être partagés avec elle avant cela. Une vérification crée au plus 200 comptes ; Admin indique combien d'autres attendent la vérification suivante. Les groupes nommés uniquement par SID ne sont pas interrogés de cette manière ; leurs membres sont placés à la connexion.
Connexion en deux étapes avec l'annuaire de l'entreprise
La connexion d'entreprise est la première étape. Les organisations qui exigent la connexion en deux étapes demandent toujours la deuxième étape de Holarch (une clé d'accès ou un code), et les comptes où la connexion en deux étapes est activée la confirment toujours. N'activez Considérer la connexion d'entreprise comme une connexion en deux étapes que lorsque le compte d'entreprise lui-même exige un second facteur ; il satisfait alors l'exigence de connexion en deux étapes de chaque organisation pour cette session.
Chaque connexion par l'annuaire, chaque refus et chaque modification des paramètres figurent dans le journal d'audit (admin.directory-save, admin.directory-test, directory.account-ended) et dans les enregistrements de connexion de chaque compte. Les mots de passe ne sont jamais enregistrés.
Limites et notes de sécurité
Limite : l'authentification unique utilise la liaison HTTP-Redirect vers le fournisseur d'identité et HTTP-POST pour revenir à Holarch. Les demandes d'authentification signées et chiffrées, les assertions chiffrées et la déconnexion unique ne sont pas prises en charge. Les groupes SCIM ne sont pris en charge que sur les serveurs auto-hébergés (Groupes SCIM et services). L'annuaire de l'entreprise connecte avec un nom d'utilisateur et un mot de passe (liaison simple via TLS) ; Kerberos et la connexion intégrée Windows ne sont pas pris en charge.
- Les modifications des paramètres nécessitent une vérification récente du mot de passe, sont envoyées par e-mail à tous les administrateurs d'organisation et sont enregistrées dans le journal d'audit (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
- Les URL de métadonnées doivent utiliser https sur l'internet public (sur un serveur auto-hébergé, les adresses internes sont aussi autorisées) ; Holarch les récupère une seule fois, lorsque vous choisissez Lire les métadonnées.
- Les jetons SCIM ne sont stockés que sous forme de hachage.