Diese Seite ist für die Person, die die Anmeldung Ihrer Organisation betreut. Ihr Admin in Hives hat die Einrichtung in Hives begonnen und braucht Sie, um Hives bei Ihrem Identitätsanbieter hinzuzufügen. Das dauert etwa zehn Minuten. Die Seite von Hives ist in Single Sign-on (SAML) einrichten beschrieben.
Was Hives unterstützt
- SAML 2.0, mit einem Identitätsanbieter pro Hive.
- Anmeldung, die Ihr Anbieter startet (aus einem Portal, dem Intranet oder über eine App-Kachel), und Anmeldung, die Hives startet (eine Schaltfläche auf der Anmeldeseite des Hives). Beide führen ins selbe Konto.
- Response, Assertion oder beide signiert mit SHA-256 oder stärker. SHA-1 wird abgewiesen.
- Bis zu zwei Signaturzertifikate gleichzeitig, damit Sie ein Zertifikat ohne Ausfall wechseln können.
- Zwei Minuten Zeitabweichung.
Hives signiert seine Anfragen nicht und nutzt kein Single Logout. Die Abmeldung bei Hives meldet nur bei Hives ab.
Die Werte von Hives
Ihr Admin in Hives kopiert diese Werte unter Admin > Hive > Single Sign-on und sendet sie Ihnen. Jeder Hive hat eigene Werte.
| So heißt es in Hives | So kann es bei Ihrem Anbieter heißen | Sieht so aus |
|---|---|---|
| Anmeldeadresse (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 |
| Metadaten-Link | Service provider metadata | dieselbe Adresse wie die Entity ID |
Hives fragt ein nicht festgelegtes Name-ID-Format an (unspecified). Jede Name ID, die Ihr Anbieter sendet, ist also in Ordnung.
Was Sie zurücksenden
Geben Sie Ihrem Admin in Hives eines davon:
- einen Metadaten-Link für die Hives-Anwendung (am besten: Er enthält beim Erneuern automatisch das neue Zertifikat), oder
- die Metadaten-Datei, oder
- den Aussteller (Entity ID), die Anmeldeadresse Ihres Anbieters und das Signaturzertifikat (in Hives Zertifikat) im PEM-Format.
Die Attribute, die Hives liest
Senden Sie diese als SAML-Attribute. Die Namen links erwartet Hives standardmäßig. Wenn Sie andere Namen verwenden, ändert Ihr Admin sie in Hives.
| Attribut | Was es enthält | Nötig |
|---|---|---|
first_name |
Vorname | Ja |
last_name |
Nachname | Ja |
email |
Dienstliche E-Mail-Adresse | Ja, außer Personen werden an der Personalnummer erkannt |
employee_id |
Personalnummer oder eine andere ID, die sich nie ändert | Wenn Personen an der Personalnummer erkannt werden |
job_title |
Jobbezeichnung | Wenn der Hive dieses Profilfeld nutzt |
department |
Abteilung | Wenn der Hive dieses Profilfeld nutzt |
Senden Sie kein Attribut email, liest Hives die E-Mail-Adresse aus der Name ID, wenn diese eine ist.
Legen Sie mit Ihrem Admin in Hives fest, woran eine Person erkannt wird: an der E-Mail-Adresse oder an der Personalnummer. Nehmen Sie die Personalnummer, wenn Personen keine dienstliche E-Mail haben oder sich eine Anmeldung teilen, und sorgen Sie dafür, dass sie immer gesendet wird und sich nie ändert.
Namen werden bei der ersten Anmeldung einer Person gesetzt. Personalnummer, Jobbezeichnung und Abteilung folgen bei jeder Anmeldung dem, was Sie senden.
Wer hineinkommt
Weisen Sie Hives bei Ihrem Anbieter den Personen oder Gruppen zu, die es nutzen sollen. Hives lässt alle hinein, die Ihr Anbieter durchlässt, als Mitglied des Hives. Rollen in Hives werden in Hives vergeben.
Entra ID
- Öffnen Sie im Microsoft Entra admin center Enterprise applications > New application > Create your own application, nennen Sie die App Hives und wählen Sie die Integration einer Anwendung, die nicht im Katalog ist.
- Öffnen Sie Single sign-on und wählen Sie SAML.
- Setzen Sie unter Basic SAML Configuration den Identifier (Entity ID) auf die Entity ID von Hives und die Reply URL auf die Anmeldeadresse (ACS URL) von Hives. Lassen Sie Sign on URL leer.
- Unter Attributes & Claims sind Vorname, Nachname und E-Mail schon vorhanden, und Hives liest sie unter ihren üblichen Microsoft-Namen. Fügen Sie die weiteren Claims hinzu, die Hives braucht, ohne Namespace: zum Beispiel
employee_idaususer.employeeid,job_titleaususer.jobtitle,departmentaususer.department. - Kopieren Sie unter SAML Certificates die App Federation Metadata Url und senden Sie sie Ihrem Admin in Hives. Verwenden Sie diese Adresse, nicht die allgemeinen Federation-Metadaten Ihres Tenants.
- Weisen Sie unter Users and groups die Personen oder Gruppen zu, die Hives nutzen sollen. Hives erscheint dann auch in ihrem My-Apps-Portal.
Okta
- Öffnen Sie Applications > Create App Integration und wählen Sie SAML 2.0. Nennen Sie die App Hives.
- Setzen Sie Single sign-on URL auf die Anmeldeadresse (ACS URL) von Hives und Audience URI (SP Entity ID) auf die Entity ID von Hives.
- Setzen Sie Name ID format auf EmailAddress und Application username auf Email, oder auf das, was dazu passt, woran Personen erkannt werden.
- Fügen Sie unter Attribute Statements
first_name(user.firstName),last_name(user.lastName),email(user.email) hinzu und nach Bedarfemployee_id(user.employeeNumber),job_title(user.title) unddepartment(user.department). - Schließen Sie ab, öffnen Sie den Tab Sign On und kopieren Sie die Metadata URL. Senden Sie sie Ihrem Admin in Hives.
- Weisen Sie die Personen oder Gruppen zu, die Hives nutzen sollen.
Google Workspace
- Öffnen Sie in der Google Admin console Apps > Web and mobile apps > Add app > Add custom SAML app. Nennen Sie die App Hives.
- Laden Sie die IdP metadata herunter und senden Sie die Datei Ihrem Admin in Hives.
- Setzen Sie ACS URL auf die Anmeldeadresse (ACS URL) von Hives und Entity ID auf die Entity ID von Hives. Name ID format: EMAIL, Name ID: primary email.
- Ordnen Sie unter Attribute mapping First name
first_namezu, Last namelast_name, Primary emailemailund nach Bedarf Employee IDemployee_id, Job titlejob_titleund Departmentdepartment. - Schalten Sie die App für die Personen oder Organisationseinheiten ein, die Hives nutzen sollen. Laut Google kann es eine Weile dauern, bis das bei allen ankommt.
Hives hat außerdem eine eigene Anmeldung Mit Google anmelden, die keine Einrichtung braucht. Nutzen Sie die eigene SAML-App, wenn Sie Personalnummern, Jobbezeichnungen oder Abteilungen in Hives haben möchten oder eine Anmeldung, die Ihre Organisation steuert.
Andere SAML-2.0-Anbieter
Legen Sie eine SAML-Anwendung mit der Anmeldeadresse (ACS URL) und der Entity ID von Hives an, senden Sie die Attribute aus der Tabelle oben und geben Sie Ihrem Admin in Hives Ihren Metadaten-Link, Ihre Metadaten-Datei oder Aussteller, Anmeldeadresse und Zertifikat.
Testen
Ihr Admin startet in Hives eine Testanmeldung. Sie zeigt jedes Attribut, das Ihr Anbieter gesendet hat, und welches Feld in Hives es füllt. So können Sie die Namen gemeinsam prüfen. Niemand sonst kann sich anmelden, bis der Test funktioniert hat und Ihr Admin Single Sign-on einschaltet.
Wenn etwas schiefgeht
Ihr Admin in Hives sieht jeden Versuch im Anmeldeprotokoll, mit dem, was geschah. Die häufigsten Ursachen:
- Nicht für diesen Hive: Entity ID oder Anmeldeadresse bei Ihrem Anbieter stimmen nicht genau mit den Werten von Hives überein.
- Signatur nicht akzeptiert: Das Zertifikat hat sich geändert. Senden Sie die neuen Metadaten oder das neue Zertifikat, oder nutzen Sie einen Metadaten-Link, dann folgt es von selbst.
- Keine Identität gesendet: Das Attribut, an dem Personen erkannt werden (E-Mail oder Personalnummer), wird für diese Person nicht gesendet.
- Link abgelaufen: Die Uhren weichen um mehr als zwei Minuten voneinander ab, oder die Person hat zu lange gebraucht.
Fragen zur Seite von Hives: help@hives.co.