Alle Integrationen

Single Sign-on mit deinem Identitätsanbieter

Lass dein Team sich über den Identitätsanbieter deiner Organisation bei Guard.ch anmelden: Microsoft Entra ID, Okta oder jeder OpenID-Connect- oder SAML-Anbieter.

Mit Single Sign-on nutzt dein Team das Arbeitskonto, das es schon hat. Guard.ch sieht nie ein Passwort, die Richtlinien deines Anbieters gelten, und wenn jemand geht, stoppt die Sperre beim Anbieter die nächste Anmeldung.

Die Einrichtung hat vier Teile, alle auf einer Seite deiner Workspace-Einstellungen: die eigenen E-Mail-Domains bestätigen, den Anbieter verbinden, eine Testanmeldung durchführen und, wenn du willst, Single Sign-on zum einzigen Zugang machen.

So funktioniert es

Sobald eine Domain bestätigt und die Verbindung gespeichert ist, läuft eine Anmeldung so ab:

  1. Jemand gibt auf der Anmeldeseite von Guard.ch die Arbeitsadresse ein, zum Beispiel ada@acme.com, oder öffnet den Anmeldelink deines Workspace.
  2. Guard.ch leitet zu deinem Identitätsanbieter weiter, wo sich die Person anmeldet, falls sie es nicht schon ist.
  3. Dein Anbieter bestätigt, wer sie ist, und sie landet angemeldet in Guard.ch und in deinem Workspace.

Guard.ch erhält, was es für die Anmeldung braucht: eine Kennung der Person, ihre E-Mail-Adresse und ihren Namen. Angefragt werden die üblichen OpenID-Connect-Scopes openid, email und profile, sonst nichts. Ein SAML-Anbieter sendet dieselben drei: eine dauerhafte Kennung und die Attribute email und name.

Bevor du loslegst

Funktioniert mit
Microsoft Entra ID, Okta und jedem OpenID-Connect- oder SAML-Anbieter
Bei Guard.ch
Business oder Enterprise und die Rolle Workspace-Manager
Beim Anbieter
Die Berechtigung, eine Anwendung zu registrieren
DNS
Die Berechtigung, einen TXT-Eintrag für deine Domain anzulegen
Zeit
Etwa fünfzehn Minuten, plus die DNS-Verteilung

Öffne deine Workspace-Einstellungen und wähle Single Sign-on. Lass diese Anleitung daneben offen; ihre Abschnitte folgen den Karten der Seite.

Schritt 1: Domains bestätigen

Füge jede E-Mail-Domain hinzu, die dein Team nutzt, zum Beispiel acme.com. Für jede zeigt die Seite einen TXT-Eintrag: Lege ihn bei deinem DNS-Anbieter unter dem Namen _guard-verify.acme.com mit dem angezeigten Wert an und wähle dann Jetzt prüfen.

Guard.ch prüft den Eintrag jeden Tag erneut. Fehlt er drei Tage in Folge, ist die Domain nicht mehr bestätigt, und Anmeldungen auf ihr werden nicht mehr zu deinem Anbieter geleitet, bis er wieder da ist.

Schritt 2: Guard.ch beim Anbieter registrieren

Registriere Guard.ch als Webanwendung. Sie braucht die Redirect-URI, die die Einstellungsseite zeigt und die auf deinen Anmeldenamen endet, zum Beispiel https://guard.ch/sso?workspace=acme.

Microsoft Entra ID

  1. Öffne im Microsoft Entra Admin Center App-Registrierungen und wähle Neue Registrierung, nur für Konten in diesem Organisationsverzeichnis.
  2. Füge die Redirect-URI als Plattform Web hinzu.
  3. Erstelle unter Zertifikate & Geheimnisse ein Client-Secret und kopiere seinen Wert. Merk dir, wann es abläuft.
  4. Kopiere die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant). Der Issuer ist https://login.microsoftonline.com/tenant-id/v2.0.

Okta

  1. Erstelle in der Okta-Adminkonsole eine App-Integration vom Typ OIDC und Web Application.
  2. Trag die Redirect-URI als Sign-in redirect URI ein und weise die Personen oder Gruppen zu, die sich anmelden dürfen.
  3. Kopiere Client ID und Client secret. Der Issuer ist die Adresse deiner Org, zum Beispiel https://acme.okta.com.

Jeder andere Anbieter

Jeder Anbieter, der OpenID Connect spricht, funktioniert: Registriere einen vertraulichen Web-Client mit der Redirect-URI und nutze seine Issuer-URL, also die Adresse, unter der /.well-known/openid-configuration antwortet.

Schritt 3: Anbieter verbinden

Gib in der Karte Identitätsanbieter den Anmeldenamen, die Issuer-URL, die Client-ID und das Client-Secret ein und speichere. Guard.ch prüft den Issuer sofort und lehnt eine Adresse ab, die nicht als OpenID-Connect-Anbieter antwortet.

Das Secret wird auf unserem Server verschlüsselt und nie wieder angezeigt. Zum Ersetzen gibst du ein neues ein; lässt du das Feld leer, bleibt das gespeicherte.

SAML statt OpenID Connect

Spricht dein Anbieter SAML 2.0, wähle in der Karte Identitätsanbieter SAML, bevor du die erste Verbindung speicherst. Die Karte zeigt dann die Werte, die dein Anbieter braucht: den Bezeichner (Entity-ID), die Antwort-URL (ACS) und die Anmelde-URL jeder Website. Füg die Metadaten-URL deines Anbieters oder das XML seiner Metadatendatei ein und speichere.

  • Microsoft Entra ID: Erstelle unter Unternehmensanwendungen eine eigene Anwendung (nicht aus dem Katalog), öffne Einmaliges Anmelden und wähle SAML. Trag Bezeichner, Antwort-URL und Anmelde-URL ein, lass die Standardansprüche, weise die Personen zu und kopiere die App-Verbundmetadaten-URL.
  • Okta: Erstelle eine SAML-2.0-App mit der Antwort-URL als Single-sign-on-URL und dem Bezeichner als Audience-URI, Name-ID-Format Persistent, Application username Custom mit user.getInternalProperty("id") (die Okta-Benutzer-ID: Guard.ch lehnt eine Name-ID ab, die eine E-Mail-Adresse ist, weil sich eine Adresse ändern oder an jemand anderen gehen kann) und zwei Attributen, email und name. Weise die Personen zu und kopiere die Metadaten-URL.
  • Jeder andere Anbieter (ADFS, SimpleSAMLphp): Er braucht eine Name-ID im Format Persistent, die eine feste Benutzer-ID ist und nicht die E-Mail-Adresse, die Attribute email und name und mit SHA-256 signierte Assertions. Anbieter, die Service-Provider-Metadaten importieren, finden unsere unter der URL des Bezeichners.

Guard.ch startet jede SAML-Anmeldung selbst und lässt die Verschlüsselung der Assertions aus. Ein Klick auf die Kachel der App im Portal deines Anbieters öffnet die Anmeldeseite von Guard.ch, ein weiterer Klick meldet an. Zum Wechsel zwischen OpenID Connect und SAML löschst du die Verbindung und erstellst die andere.

Schritt 4: Anmeldung testen

Wähle Testanmeldung und melde dich beim Anbieter an, als du selbst oder als jemand aus dem Team. Der Test meldet niemanden an: Er zeigt, was dein Anbieter gesendet hat, die Adresse, den Namen und ob die Domain bestätigt ist.

Ein erfolgreicher Test wird gespeichert. Um Single Sign-on zu verlangen, braucht es einen seit der letzten Änderung der Verbindung.

Konten und Mitglieder

Wer noch kein Guard.ch-Konto hat und sich mit einer Adresse auf einer bestätigten Domain über deinen Anbieter anmeldet, erhält sofort ein Konto und tritt deinem Workspace bei, solange ein Platz frei ist.

Wer unter einer solchen Adresse schon ein Guard.ch-Konto hat, wird bei der ersten Anmeldung mit deinem Anbieter verknüpft. Nutzt das Konto die Zwei-Schritt-Verifizierung, wird sie einmal bestätigt; die Person erhält eine E-Mail zur Verknüpfung und tritt dem Workspace bei.

Entfernst du ein Mitglied in den Workspace-Einstellungen oder verlässt es den Workspace, wird sein Konto zu einem persönlichen Konto ausserhalb des Workspace und ist nicht mehr mit deinem Anbieter verknüpft.

Bereitstellung mit SCIM

Mit SCIM verwaltet dein Identitätsanbieter, wer in deinem Workspace ist: Er legt Konten für die zugewiesenen Personen an, hält Name und Adresse aktuell und entfernt sie, wenn du die Zuweisung aufhebst. Guard.ch stellt nur Benutzer bereit, keine Gruppen; Manager legst du in den Workspace-Einstellungen fest.

Schalte es in der Karte Bereitstellung der Single-sign-on-Einstellungen ein. Du erhältst den SCIM-Endpunkt und ein Token, das nur einmal angezeigt wird; ein neues Token ersetzt das alte sofort.

Microsoft Entra ID

Öffne in der Unternehmensanwendung Bereitstellung, wähle den Modus Automatisch, gib den Endpunkt als Mandanten-URL und das Token als Geheimes Token ein und teste die Verbindung. Setz unter Zuordnungen "Provision Microsoft Entra ID Groups" auf Nein und lass den Bereich auf zugewiesenen Benutzern.

Okta

Wähle im Tab General der App Provisioning SCIM. Gib im Tab Provisioning den Endpunkt als Base URL ein, userName als Unique identifier field, Push New Users und Push Profile Updates sowie den Authentication Mode HTTP Header mit dem Token. Schalte unter To App Create Users, Update User Attributes und Deactivate Users ein.

SCIM übernimmt nie ein bestehendes Konto: Wer schon ein Guard.ch-Konto hat, wird abgelehnt, bis die Person per Einladung oder mit einer Anmeldung über deinen Anbieter beitritt; danach verwaltet dein Anbieter sie. Entfernst du eine Person bei deinem Anbieter, wird sie aus dem Workspace entfernt und ihr Platz frei; ihr Konto bleibt als persönliches Konto, und Browser, die sie gestartet hat, laufen weiter, bis sie sie schliesst.

Single Sign-on verlangen

Schalte Single Sign-on verlangen ein, und jedes Konto auf deinen bestätigten Domains meldet sich nur noch über deinen Anbieter an. Sessions aus anderen Anmeldemethoden enden beim Einschalten.

Workspace-Manager behalten einen Zugang für den Tag, an dem der Anbieter ausfällt oder ein Client-Secret abläuft: Sie dürfen ihre anderen Anmeldemethoden weiter nutzen, aber nur mit Zwei-Schritt-Verifizierung oder einem Passkey, der allein genügt.

Im Team ausrollen

Für dein Team ändert sich erst bei der Anmeldung etwas: Wer auf der Anmeldeseite von Guard.ch die Arbeitsadresse eingibt, landet bei deinem Anbieter. Du kannst auch den Anmeldelink deines Workspace teilen.

Auf verwalteten Geräten kann die IT das Browser-Add-on von Guard.ch mit deinem Workspace-Anmeldenamen verteilen, damit jeder Start aus dem Add-on über deinen Anbieter anmeldet.

Wenn eine Anmeldung fehlschlägt

«Die Anmeldung deiner Organisation gilt nicht für diese E-Mail-Adresse.» Die Adresse, die der Anbieter gesendet hat, liegt auf keiner von deinem Workspace bestätigten Domain. Bestätige die Domain oder prüfe, welche Adresse der Anbieter für diese Person sendet.

«Dein Identitätsanbieter hat keine bestätigte E-Mail-Adresse gesendet.» Der Anbieter hat keine E-Mail-Adresse gesendet oder eine, die er als nicht bestätigt markiert. Stell in Entra ID sicher, dass die Person eine E-Mail-Adresse hat, in Okta, dass ihre primäre E-Mail bestätigt ist.

«Die Anmeldung über Single Sign-on hat nicht geklappt.» Die Anmeldung hat zu lange gedauert, wurde in einem anderen Browser geöffnet oder vom Anbieter abgelehnt. Starte sie auf der Anmeldeseite neu.

«Der Identitätsanbieter deiner Organisation ist gerade nicht erreichbar.» Guard.ch hat deinen Anbieter nicht erreicht, oder er hat unseren Client abgelehnt. Prüf die Issuer-URL und ob das Client-Secret abgelaufen ist.

„Der Identitätsanbieter signiert mit einem Zertifikat, das diese Verbindung nicht kennt.“ Dein SAML-Anbieter hat sein Signaturzertifikat gewechselt. Speichere seine Metadaten in der Karte Identitätsanbieter erneut.

Im Betrieb

Wenn das Client-Secret abläuft

Erstelle beim Anbieter ein neues Secret, gib es in der Karte Identitätsanbieter ein und speichere. Führe den Test erneut durch: Ein neues Secret löscht den gespeicherten Test und schaltet die Pflicht aus, bis du sie wieder einschaltest.

Wenn jemand geht

Sperre die Person bei deinem Anbieter: Ihre nächste Anmeldung schlägt fehl. Entferne sie danach aus den Mitgliedern des Workspace, um ihren Platz freizugeben.

Den Issuer wechseln

Speicherst du einen anderen Issuer, werden die Verknüpfungen der Konten mit dem alten Anbieter entfernt. Bei der nächsten Anmeldung werden die Personen über ihre bestätigte Domain wieder verknüpft.

Single Sign-on ausschalten

Lösch die Verbindung in der Karte Identitätsanbieter. Die Konten bleiben; die Personen melden sich wieder mit ihren anderen Methoden an.

Sicherheit auf einen Blick

  • Passwörter erreichen Guard.ch nie. Sie werden, wenn überhaupt, nur beim Anbieter eingegeben.
  • Jede Anmeldung nutzt PKCE, einen signierten State und eine Nonce und prüft Issuer und Audience des ID-Tokens.
  • Konten werden nur auf Domains erstellt oder verknüpft, die du per DNS bestätigt hast.
  • Die Richtlinien deines Anbieters gelten auch für Guard.ch, inklusive Multi-Faktor-Authentifizierung und bedingtem Zugriff.
  • Das Client-Secret wird verschlüsselt gespeichert und nie wieder angezeigt.

Bereit?

Öffne deine Workspace-Einstellungen und beginne mit deiner ersten Domain. Was Guard.ch sonst noch verbindet, findest du unter alle Integrationen.