Centre d'aideAdmin : connexion et paramètres du hive

Authentification unique : ce dont votre service informatique a besoin

Cette page s’adresse à la personne qui gère la connexion de votre organisation. L’Admin de votre hive a commencé la configuration dans Hives et a besoin que vous ajoutiez Hives à votre fournisseur d’identité. Cela prend environ dix minutes. La partie Hives de la configuration est décrite dans Configurer l’authentification unique (SAML).

Ce que Hives prend en charge

  • SAML 2.0, avec un seul fournisseur d’identité par hive.
  • La connexion lancée par votre fournisseur (depuis un portail, un intranet ou une tuile d’application) et la connexion lancée par Hives (un bouton sur la page de connexion du hive). Les deux mènent au même compte.
  • La réponse, l’assertion ou les deux signées en SHA-256 ou plus fort. SHA-1 est refusé.
  • Jusqu’à deux certificats de signature en même temps, pour renouveler un certificat sans interruption.
  • Deux minutes d’écart d’horloge.

Hives ne signe pas ses requêtes et n’utilise pas la déconnexion unique (single logout). Se déconnecter de Hives déconnecte de Hives uniquement.

Les valeurs fournies par Hives

L’Admin de votre hive les copie depuis Admin > Hive > Authentification unique et vous les envoie. Chaque hive a les siennes.

Nom dans Hives Nom possible chez votre fournisseur Exemple
Adresse de connexion (ACS URL) Reply URL, Assertion Consumer Service URL, Single sign-on URL https://api.hives.co/auth/saml/<id>/acs
Entity ID Identifier, Audience URI, SP Entity ID https://api.hives.co/auth/saml/<id>/metadata
Lien des métadonnées Service provider metadata la même adresse que l’Entity ID

Hives demande un format de Name ID non spécifié (unspecified) : tout Name ID envoyé par votre fournisseur convient.

Ce que vous renvoyez

Donnez à l’Admin de votre hive l’un de ces éléments :

  • un lien de métadonnées pour l’application Hives (la meilleure option : il transmet le nouveau certificat quand vous le renouvelez),
  • le fichier de métadonnées,
  • ou l’émetteur (Entity ID), l’adresse de connexion de votre fournisseur et le certificat de signature au format PEM.

Les attributs que Hives lit

Envoyez-les comme attributs SAML. Les noms de gauche sont ceux que Hives attend par défaut. Si vous utilisez d’autres noms, l’Admin de votre hive les modifie dans Hives.

Attribut Contenu Nécessaire
first_name Prénom Oui
last_name Nom Oui
email Adresse e-mail professionnelle Oui, sauf si les personnes sont reconnues par leur matricule
employee_id Matricule ou autre identifiant qui ne change jamais Quand les personnes sont reconnues par leur matricule
job_title Intitulé de poste Quand le hive utilise ce champ de profil
department Service Quand le hive utilise ce champ de profil

Si vous n’envoyez pas d’attribut email, Hives lit l’adresse e-mail dans le Name ID, quand c’en est une.

Choisissez avec l’Admin de votre hive ce qui identifie une personne : son adresse e-mail ou son matricule. Utilisez le matricule quand des personnes n’ont pas d’e-mail professionnel ou partagent un même identifiant, et vérifiez qu’il est toujours envoyé et ne change jamais.

Les noms sont définis à la première connexion de la personne. Le matricule, l’intitulé de poste et le service suivent ce que vous envoyez à chaque connexion.

Qui peut entrer

Attribuez Hives, dans votre fournisseur, aux personnes ou aux groupes qui doivent l’utiliser. Hives laisse entrer toutes les personnes que votre fournisseur laisse passer, comme Membres du hive. Les rôles dans Hives se donnent dans Hives.

Entra ID

  1. Dans le Microsoft Entra admin center, ouvrez Enterprise applications > New application > Create your own application, nommez l’application Hives et choisissez d’intégrer une application qui ne figure pas dans la galerie.
  2. Ouvrez Single sign-on et choisissez SAML.
  3. Sous Basic SAML Configuration, renseignez Identifier (Entity ID) avec l’Entity ID de Hives et Reply URL avec l’Adresse de connexion (ACS URL) de Hives. Laissez Sign on URL vide.
  4. Sous Attributes & Claims, les revendications du prénom, du nom et de l’e-mail sont déjà là, et Hives les lit sous leurs noms Microsoft habituels. Ajoutez les revendications dont Hives a besoin en plus, sans espace de noms : par exemple employee_id depuis user.employeeid, job_title depuis user.jobtitle, department depuis user.department.
  5. Sous SAML Certificates, copiez l’App Federation Metadata Url et envoyez-la à l’Admin de votre hive. Utilisez cette adresse, pas les métadonnées de fédération générales de votre tenant.
  6. Sous Users and groups, attribuez l’application aux personnes ou aux groupes qui doivent utiliser Hives. Hives apparaît alors aussi dans leur portail My Apps.

Okta

  1. Ouvrez Applications > Create App Integration et choisissez SAML 2.0. Nommez l’application Hives.
  2. Renseignez Single sign-on URL avec l’Adresse de connexion (ACS URL) de Hives et Audience URI (SP Entity ID) avec l’Entity ID de Hives.
  3. Réglez Name ID format sur EmailAddress et Application username sur Email, ou sur ce qui correspond à la façon dont les personnes sont reconnues.
  4. Sous Attribute Statements, ajoutez first_name (user.firstName), last_name (user.lastName), email (user.email) et, selon vos besoins, employee_id (user.employeeNumber), job_title (user.title) et department (user.department).
  5. Terminez, ouvrez l’onglet Sign On et copiez la Metadata URL. Envoyez-la à l’Admin de votre hive.
  6. Attribuez l’application aux personnes ou aux groupes qui doivent utiliser Hives.

Google Workspace

  1. Dans la Google Admin console, ouvrez Apps > Web and mobile apps > Add app > Add custom SAML app. Nommez l’application Hives.
  2. Téléchargez les IdP metadata et envoyez le fichier à l’Admin de votre hive.
  3. Renseignez ACS URL avec l’Adresse de connexion (ACS URL) de Hives et Entity ID avec l’Entity ID de Hives. Name ID format : EMAIL, Name ID : primary email.
  4. Sous Attribute mapping, associez First name à first_name, Last name à last_name, Primary email à email et, selon vos besoins, Employee ID à employee_id, Job title à job_title et Department à department.
  5. Activez l’application pour les personnes ou les unités organisationnelles qui doivent utiliser Hives. Google indique que cela peut mettre un certain temps à toucher tout le monde.

Hives propose aussi sa propre option Se connecter avec Google, qui ne demande aucune configuration. Utilisez l’application SAML personnalisée quand vous voulez les matricules, les intitulés de poste ou les services dans Hives, ou une connexion contrôlée par votre organisation.

Autres fournisseurs SAML 2.0

Créez une application SAML avec l’Adresse de connexion (ACS URL) et l’Entity ID de Hives, envoyez les attributs du tableau ci-dessus, et donnez à l’Admin de votre hive votre lien de métadonnées, votre fichier de métadonnées, ou l’émetteur, l’adresse de connexion et le certificat.

Tester

L’Admin de votre hive lance une connexion de test depuis Hives. Elle affiche chaque attribut envoyé par votre fournisseur et le champ de Hives que chacun remplit, ce qui vous permet de vérifier les noms ensemble. Personne d’autre ne peut se connecter tant que le test n’a pas réussi et que votre Admin n’a pas activé l’authentification unique.

En cas de problème

L’Admin de votre hive voit chaque tentative dans le journal des connexions, avec ce qui s’est passé. Les causes les plus fréquentes :

  • Pas pour ce hive : l’Entity ID ou l’adresse de connexion saisis chez votre fournisseur ne correspondent pas exactement aux valeurs de Hives.
  • Signature refusée : le certificat a changé. Envoyez les nouvelles métadonnées ou le nouveau certificat, ou utilisez un lien de métadonnées pour qu’il suive automatiquement.
  • Aucune identité envoyée : l’attribut qui identifie les personnes (e-mail ou matricule) n’est pas envoyé pour cette personne.
  • Lien expiré : les horloges ont plus de deux minutes d’écart, ou la personne a mis trop de temps.

Questions sur la partie Hives : help@hives.co.