InfraNestInfraNest
Sicherheit

Bei InfraNest mit einem anderen Identitätsanbieter anmelden

InfraNest bietet Schritt-für-Schritt-Anleitungen für [Okta](connect-okta.md), [Microsoft Entra ID](connect-microsoft-entra-id.md) und [Google…

EnterpriseAktualisiert am 9. November 20269 Min. Lesezeit

Verbinde InfraNest mit einem Identitätsanbieter, der OpenID Connect unterstützt, damit sich dein Team mit dem Konto anmeldet, das es bereits nutzt. Dies richtet sich an Workspace-Administratoren mit Enterprise-Tarifen, die auch Administratorzugriff bei ihrem Identitätsanbieter haben.

#Überblick

  • InfraNest hat eigene Anleitungen für Okta, Microsoft Entra ID und Google Workspace. Für jeden anderen Anbieter — einschließlich JumpCloud, OneLogin, Keycloak, Authentik und Auth0 — nutze Another provider (OpenID Connect).
  • Du benötigst eine Anwendung, die bei deinem Anbieter eingerichtet ist (eine Client-ID, ein Client-Geheimnis und eine Discovery-Adresse), sowie ein paar Minuten sowohl in InfraNest als auch in der Admin-Konsole deines Anbieters.
  • Für Einstellungen, die bei allen Anbietern gleich sind, sieh dir „Connect your own identity provider“ an.

NoteDiese Funktion ist nur in Enterprise-Tarifen verfügbar, und du musst sowohl bei deinem Identitätsanbieter als auch in InfraNest Administrator sein.

#Was dein Anbieter unterstützen muss

Die meisten modernen Identitätsanbieter unterstützen das alles, aber prüfe die Einstellungen deines Anbieters auf Folgendes:

  • Eine OpenID-Connect-Anwendung für eine Web-App (manchmal confidential client oder regular web application genannt), mit einer Client-ID und einem Client-Geheimnis.
  • Eine Redirect-URL (auch Redirect-URI oder Callback-URL genannt), in die du InfraNests Redirect URL einfügst.
  • Den Authorization-Code-Flow (manchmal standard flow genannt). InfraNest benötigt weder Implicit-, Refresh-Token- noch Client-Credentials-Flows.
  • Eine Discovery-URL, die auf /.well-known/openid-configuration endet. InfraNest liest alles Weitere von dieser Adresse.
  • Die E-Mail-Adresse jeder Person, enthalten in dem, was der Anbieter sendet. InfraNest fordert openid, profile und email an.
  • Mit einem Schlüsselpaar signierte Anmeldetokens (die normale Einstellung). Ein Anbieter, der stattdessen mit dem Client-Geheimnis signiert, wird abgelehnt — das betrifft insbesondere Authentik.

#Die Verbindung einrichten

#In InfraNest beginnen

  1. Gehe zu Settings, dann Sign-in, und wähle Set up single sign-on.
  2. Wähle Another provider (OpenID Connect).
  3. Prüfe die von InfraNest vorgeschlagene Email domain. Das Verifizieren wird empfohlen, damit sich Personen mit ihrer geschäftlichen Adresse anmelden können und neue Personen automatisch beitreten können. Du kannst diesen Schritt überspringen — dein Team nutzt dann stattdessen den Anmeldelink deines Workspace, und neue Personen treten per Einladung bei. Wenn die Domain noch nicht verifiziert ist, zeigt InfraNest den hinzuzufügenden DNS-Eintrag. Wenn InfraNest diese DNS-Zone bereits verwaltet, wähle Add it for me; andernfalls füge den Eintrag dort hinzu, wo dein DNS gehostet wird, und wähle Check now.
  4. Kopiere im Schritt Create the app die Redirect URL. Lass diesen Tab geöffnet.

#Die App bei deinem Anbieter erstellen

  1. Erstelle in einem zweiten Tab die Anwendung bei deinem Anbieter und verwende InfraNests Redirect URL als dessen Redirect-URL. Die genauen Bildschirme findest du in den anbieterspezifischen Abschnitten unten.
  2. Halte die client ID, das client secret und die discovery URL der App bereit.
  3. Stelle sicher, dass du die App selbst nutzen kannst, sonst schlägt der spätere Testschritt bei deinem Anbieter fehl.

#Die Verbindung in InfraNest abschließen

  1. Trage in InfraNest im Schritt Create the app die Felder Discovery URL, Client ID und Client secret ein. InfraNest liest alles Weitere von deinem Anbieter.
  2. Wenn InfraNest die Discovery-URL nicht erreichen kann, wird nichts gespeichert, und die Meldung erklärt, was schiefgelaufen ist.

Die Verbindung wird nach deinem Anbieter benannt, und dieser Name erscheint für dein Team auf der Anmeldeseite als Continue with …. InfraNest erkennt JumpCloud, OneLogin und Auth0 namentlich; bei jedem anderen Anbieter wird dessen Adresse angezeigt, etwa sso.acme.com.

Bei InfraNest mit einem anderen Identitätsanbieter anmelden

#Testen, festlegen, wer Zugang erhält, und einschalten

  1. Wähle im Schritt Try it Sign in with deinem Anbieter to test. Ein neuer Tab öffnet sich bei deinem Anbieter — melde dich mit deinem eigenen Konto an. Wenn es funktioniert, wird der Schritt grün. Ein Test ist erforderlich, bevor du die Verbindung einschalten kannst.
  2. Wähle im Schritt Who gets in, was When somebody new signs in passiert:
    • Add them straight away ist bereits ausgewählt. Neue Personen treten mit der unter Role for new members festgelegten Rolle bei, die standardmäßig Member (nur lesen) ist. Nutze dies nur, wenn dein Anbieter den Zugriff auf die App auf die richtigen Personen beschränkt — prüfe die Hinweise zu deinem Anbieter weiter unten.
    • Ask an admin macht aus der Anmeldung jedes Neuankömmlings eine Beitrittsanfrage, die ein Administrator genehmigt.
    • Do nothing bedeutet, dass Personen weiterhin eine Einladung benötigen.
  3. Wähle Switch on. Der Status der Verbindung sollte nun lauten: Connected to your provider · Email domain verified · Test sign-in passed · Switched on.

#Optional: Personen Rollen anhand ihrer Gruppen zuweisen

Wenn dein Anbieter die Gruppen jeder Person senden kann, kann InfraNest deren Rolle automatisch festlegen.

  1. Öffne die Verbindung, dann Credentials and claim names.
  2. Setze Groups claim auf den Feldnamen, unter dem dein Anbieter Gruppen sendet (siehe den Abschnitt für deinen Anbieter unten).
  3. Füge für jede Gruppe eine Zeile hinzu: Trage unter Group at your provider deren Namen genau so ein, wie der Anbieter ihn sendet; wähle unter Role here die Rolle, die sie erhalten soll. Rollen, die Dinge ändern oder löschen können, lassen sich auf diese Weise nicht zuordnen.

#JumpCloud

  1. Gehe im JumpCloud Admin Portal zu Access → SSO Applications und wähle + Add New Application.
  2. Wähle Custom Application, dann Next. Wähle Manage Single Sign-On (SSO) und Configure SSO with OIDC, dann Next.
  3. Gib ein Display Label ein, etwa InfraNest, und gehe weiter zum Tab SSO.
  4. Füge unter Redirect URIs InfraNests Redirect URL ein.
  5. Setze Client Authentication Type auf Client Secret Basic.
  6. Gib die Login URL ein — die Adresse der InfraNest-Anmeldeseite, so wie sie in deinem Browser erscheint.
  7. Hake unter Attribute Mapping die Standard-Scopes Email und Profile an. Ohne diese sendet JumpCloud keine E-Mail-Adressen.
  8. Wähle im Tab User Groups die Gruppen aus, die InfraNest nutzen dürfen. Nur deren Mitglieder können sich anmelden.
  9. Wähle Activate. JumpCloud zeigt Client ID und Client Secret einmalig an — kopiere beide sofort.

Discovery-URL: https://oauth.id.jumpcloud.com/.well-known/openid-configuration (EU-Region: https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration; Indien-Region: https://oauth.id.in.jumpcloud.com/.well-known/openid-configuration).

Gruppen: Hake unter Attribute Mapping include group attribute an und benenne es groups. Setze in InfraNest Groups claim auf groups.

NoteDas Starten von InfraNest aus dem JumpCloud User Portal wird nicht unterstützt — Personen melden sich über die InfraNest-Anmeldeseite an.

#OneLogin

  1. Gehe in OneLogin zu Applications → Applications und wähle Add App.
  2. Suche nach OpenId Connect, wähle OpenId Connect (OIDC), gib einen Display Name wie InfraNest ein und wähle Save.
  3. Füge im Tab Configuration InfraNests Redirect URL unter Redirect URI's ein. Lasse Login Url leer — InfraNest unterstützt kein Starten der Anmeldung aus dem OneLogin-Portal. Wähle Save.
  4. Setze im Tab SSO Application Type auf Web und die Authentifizierungsmethode des Token-Endpunkts auf Basic. Wähle Show client secret und kopiere Client ID und Client Secret.
  5. Gib Personen Zugriff auf die App, üblicherweise über eine Rolle, die sie enthält. Nur Personen mit der App können sich anmelden.

Discovery-URL: https://<your subdomain>.onelogin.com/oidc/2/.well-known/openid-configuration.

Gruppen: Öffne im Tab Parameters der App Groups. Setze Default if no value auf User Roles und wähle Semicolon Delimited input (Multi-value output). Setze in InfraNest Groups claim auf groups und ordne die Rollennamen zu.

#Keycloak

  1. Wähle in der Keycloak Admin Console den Realm, in dem sich deine Personen befinden, gehe zu Clients und wähle Create client.
  2. Belasse Client type auf OpenID Connect, gib eine Client ID wie infranest ein und fahre fort.
  3. Schalte Client authentication ein und lasse Standard flow angehakt.
  4. Füge unter Valid redirect URIs InfraNests Redirect URL exakt ein, ohne Platzhalter. Speichern.
  5. Kopiere im Tab Credentials des Clients das Client Secret.

Discovery-URL: https://<your Keycloak address>/realms/<realm name>/.well-known/openid-configuration (ältere Versionen fügen /auth vor /realms ein).

Gruppen: Öffne im Tab Client scopes des Clients den Scope, der auf -dedicated endet, und wähle Configure a new mapper → Group Membership. Benenne ihn, setze Token Claim Name auf groups, schalte Full group path aus und stelle sicher, dass Add to ID token eingeschaltet ist. Setze in InfraNest Groups claim auf groups.

WarningKeycloak lässt standardmäßig jeden Benutzer im Realm sich bei jedem Client anmelden, sofern du das nicht selbst einschränkst. Wähle, sofern du keine Einschränkung hinzugefügt hast, Ask an admin statt Add them straight away.

#Authentik

  1. Gehe in der Authentik Admin-Oberfläche zu Applications → Applications und wähle New Application.
  2. Gib einen Namen wie InfraNest ein und notiere den Slug.
  3. Wähle den Provider-Typ OAuth2/OpenID Connect.
  4. Wähle einen Authorization-Flow und kopiere Client ID und Client Secret. Füge eine Redirect URI vom Typ Strict, Authorization, mit InfraNests Redirect URL hinzu. Wähle unter Signing Key einen Schlüssel — dies ist erforderlich, sonst signiert Authentik mit dem Client-Geheimnis und InfraNest lehnt es ab.
  5. Verknüpfe die Gruppen oder Personen, die InfraNest nutzen dürfen. Ohne Verknüpfungen kann sich jeder Authentik-Benutzer anmelden.
  6. Wähle Submit.

Discovery-URL: https://<your Authentik address>/application/o/<slug>/.well-known/openid-configuration.

Gruppen: Authentiks Standardprofil enthält die Gruppen der Person in einem Feld namens groups. Setze in InfraNest Groups claim auf groups und ordne die Gruppennamen zu.

#Auth0

  1. Gehe im Auth0 Dashboard zu Applications → Applications und wähle Create Application.
  2. Gib einen Namen wie InfraNest ein, wähle Regular Web Applications und wähle Create.
  3. Füge im Tab Settings InfraNests Redirect URL unter Allowed Callback URLs ein und wähle Save Changes. Kopiere Domain, Client ID und Client Secret.
  4. Setze im Tab Credentials die Authentifizierungsmethode auf Client Secret (Basic).

Discovery-URL: https://<your Auth0 domain>/.well-known/openid-configuration (verwende deine eigene Domain, falls vorhanden).

Gruppen: Auth0 sendet Rollen oder Gruppen standardmäßig nicht. Füge eine Post-Login-Action hinzu, die die Rollen der Person als benutzerdefinierten Claim hinzufügt, und setze dann Groups claim in InfraNest auf den exakten Namen dieses Claims — oft eine vollständige Adresse wie https://example.com/roles.

Wer sich anmelden kann: Jeder, der sich über die für diese Anwendung aktivierten Auth0-Verbindungen anmelden kann, kann sich bei InfraNest anmelden. Schränke diese Verbindungen ein, oder wähle Ask an admin.

#Tipps

  • Starte die Anmeldung über die InfraNest-Anmeldeseite, nicht über das Dashboard deines Anbieters — das Starten von InfraNest aus dem Portal eines Anbieters wird nicht unterstützt.
  • InfraNest verwendet keine Abmelde-(Post-Logout-)Redirect-URL. Lasse dieses Feld leer, falls dein Anbieter eines verlangt.

#Fehlerbehebung

  • Beim Eingeben der Discovery-URL wird nichts gespeichert: InfraNest konnte sie nicht lesen. Öffne die Adresse in deinem Browser — sie sollte Text mit \"issuer\" und der Adresse deines Anbieters anzeigen. Wenn nicht, ist die Adresse falsch.
  • Der Anbieter zeigt einen Redirect- oder Callback-Fehler: Die Redirect-URL bei deinem Anbieter stimmt nicht exakt mit InfraNests Redirect URL überein. Kopiere sie erneut.
  • Der Test schlägt nach der Anmeldung bei deinem Anbieter fehl: Prüfe, ob das Client-Geheimnis aktuell ist und ob die App es auf die Basic-Art sendet (bei JumpCloud, OneLogin und Auth0). Prüfe bei Authentik, ob ein Signing Key ausgewählt ist.
  • Jemand meldet sich beim Anbieter an, aber InfraNest lässt die Person nicht hinein: Die E-Mail-Adresse fehlt in dem, was der Anbieter sendet, oder sie gehört nicht zu einer in InfraNest verifizierten Domain.
  • Alle landen in der Standardrolle, obwohl du Gruppen zugeordnet hast: Prüfe, ob Groups claim genau dem Feldnamen entspricht, den dein Anbieter verwendet, und ob die Gruppennamen genau so geschrieben sind, wie der Anbieter sie sendet.
  • Administratoren können jeden fehlgeschlagenen Versuch mit dem Grund unter Settings, dann Audit Log, einsehen.

TipErneuerst du das Client-Geheimnis deines Anbieters? Füge das neue in die Verbindung unter Credentials and claim names ein und wähle Replace. Bis dahin kann sich niemand über deinen Anbieter anmelden.

Verwandte Artikel

In Sekunden startklar

Bring deine gesamte Infrastruktur in ein modernes Dashboard.

Kostenloser Plan · Keine Kreditkarte nötig · In Minuten eingerichtet