Single Sign-On (SSO)
Mit Ihrem Identity Provider beim Jamdesk-Dashboard anmelden. SAML oder OIDC auf jedem kostenpflichtigen Tarif selbst einrichten; SSO für Leser der Docs-Seite ist Enterprise.
Jamdesk bietet zwei Arten von Single Sign-On. Dashboard-SSO meldet Ihr Team über Ihren Identity Provider am Dashboard an. Sie konfigurieren es selbst unter den Einstellungen, auf jedem kostenpflichtigen Tarif. Docs-Seiten-SSO meldet Leser Ihrer veröffentlichten Dokumentation über Ihren IdP an, statt eines gemeinsamen Passworts. Unser Team richtet es auf Enterprise-Tarifen ein.
Für benutzerbezogenen Dokumentationszugriff ohne Enterprise-Tarif verwenden Sie JWT-Authentifizierung. Wenn Ihr Produkt eine eigene Anmeldung hat, meldet Ihr Backend Leser an. Sie ist auf jedem Tarif verfügbar.
Was SSO abdeckt
Für wen ist SSO geeignet?
SSO erfordert einen Identity Provider: Okta, Google Workspace, Microsoft Entra ID, Auth0 oder einen beliebigen SAML-2.0- / OIDC-Anbieter.
Dashboard-SSO gibt Ihnen zentrale Kontrolle darüber, wer Projekte verwaltet. MFA wird über Ihren IdP erzwungen. Ist SSO erzwungen, sperrt das Entfernen einer Person aus Ihrem Verzeichnis ihre Dashboard-Anmeldung.
Docs-Seiten-SSO liefert einen Audit-Trail darüber, wer welche Dokumentation gelesen hat. Es ersetzt eine gemeinsame Passphrase durch benutzerbezogenen Zugriff.
Dashboard-SSO aktivieren
Dashboard-SSO ist auf jedem kostenpflichtigen Tarif Self-Service. Verifizieren Sie Ihre E-Mail-Domain, verbinden Sie Ihren Identity Provider und verlangen Sie optional SSO für alle auf dieser Domain.
Bevor Sie beginnen
- Ein kostenpflichtiger Jamdesk-Tarif.
- Owner-Zugriff auf das Projekt. Die SSO-Verbindung gilt für alle Projekte, die Ihnen gehören. Nur der Owner sieht die Single-Sign-On-Einstellungen.
- Zugriff auf die DNS Ihrer Domain, um einen TXT-Eintrag hinzuzufügen.
- Admin-Zugriff auf Ihren Identity Provider (Okta, Microsoft Entra, Google Workspace, Auth0 oder einen beliebigen SAML-2.0- / OIDC-Anbieter).
Verbindung einrichten
Gehen Sie im Dashboard zu Settings → Single Sign-On und geben Sie Ihre Firmen-E-Mail-Domain ein, zum Beispiel acme.com. Jamdesk erstellt eine Verbindung und zeigt einen DNS-TXT-Eintrag zur Domain-Verifizierung an.
Fügen Sie der DNS Ihrer Domain einen TXT-Eintrag mit Name und Wert aus dem Dashboard hinzu. Klicken Sie auf Verify. DNS-Änderungen können bis zu einer Stunde brauchen. Schlägt der erste Versuch fehl, warten Sie und versuchen es erneut. Lassen Sie den Eintrag nach der Verifizierung bestehen. Jamdesk prüft ihn regelmäßig erneut und deaktiviert die Verbindung, wenn er verschwindet.
Kopieren Sie Entity ID und ACS URL aus dem Dashboard in eine neue SAML- oder OIDC-Anwendung in Ihrem IdP. Tragen Sie die Angaben Ihres IdP zurück in Jamdesk ein:
- SAML 2.0: IdP Entity ID, SSO-URL und das X.509-Signaturzertifikat im PEM-Format.
- OIDC: Issuer-URL, Client-ID und Client-Secret.
Wählen Sie Ihren Anbieter aus der Liste für eine anbieterspezifische Einrichtungsanleitung. Klicken Sie auf Save & activate. Die Verbindung wechselt zu Active.
Wenn die Verbindung Active ist, aktivieren Sie Require SSO for all users on your domain. Dann meldet sich jede E-Mail dieser Domain über Ihren IdP an. Passwort- und Google-Anmeldung funktionieren für sie nicht mehr. Ihr Owner-Konto bleibt ausgenommen. Fügen Sie bis zu 20 Break-Glass-E-Mails für Admins hinzu, die ein Passwort als Rückfallebene brauchen, falls Ihr IdP nicht erreichbar ist.
Fügen Sie mindestens eine Break-Glass-E-Mail hinzu, bevor Sie die Erzwingung aktivieren. Ohne sie sperrt ein IdP-Ausfall alle auf der Domain aus dem Dashboard aus.
So melden sich Benutzer an
Die Anmeldung über Dashboard-SSO ist E-Mail-zuerst. Geben Sie auf dem Anmeldebildschirm eine Firmen-E-Mail ein. Hat ihre Domain eine SSO-Verbindung, leitet Jamdesk zu Ihrem Identity Provider weiter. Es gibt keine separate Schaltfläche „Mit SSO anmelden“.
Die Anmeldung über Ihren IdP gewährt keinen Zugriff. Jedes Teammitglied braucht weiterhin eine Einladung zu einem Projekt. Ohne sie sieht es „Ihr Konto ist nicht bereitgestellt“. Eine blockierte Anmeldung landet auf einer SSO-Fehlerseite, die den nächsten Schritt erklärt.
Fehlerbehebung
DNS-Änderungen können bis zu einer Stunde brauchen, bis sie Jamdesk erreichen. Warten Sie und klicken Sie dann erneut auf Verify. Schlägt es weiterhin fehl, prüfen Sie, ob Name und Wert des Eintrags genau dem Dashboard entsprechen. Manche DNS-Anbieter hängen Ihre Domain an den Eintragsnamen an und machen aus _jamdesk etwa _jamdesk.acme.com.acme.com. Entfernen Sie das doppelte Suffix.
Jamdesk prüft den TXT-Eintrag Ihrer Domain nach der Einrichtung erneut. Ein entfernter oder geänderter Eintrag setzt die Verbindung auf Disabled. Anmeldungen werden nicht mehr an Ihren IdP weitergeleitet. Fügen Sie den Eintrag wieder in die DNS ein und klicken Sie auf Re-check status, oder löschen Sie die Verbindung und beginnen von vorn.
Die Person hat sich bei Ihrem Identity Provider authentifiziert, wurde aber nie zu einem Projekt eingeladen. Laden Sie sie unter Settings → Members ein. Lassen Sie sie sich dann erneut anmelden. Siehe Teammitglieder.
Die Erzwingung ist aktiv. Die Person hat versucht, sich mit Passwort oder Google statt über Ihren IdP anzumelden. Lassen Sie sie den E-Mail-zuerst-Ablauf nutzen, der zu Ihrem Anbieter weiterleitet. Für eine Passwort-Rückfallebene (etwa wenn Ihr IdP ausgefallen ist) fügen Sie ihre Adresse der Break-Glass-Liste hinzu.
Docs-Site-SSO aktivieren
Unser Team richtet SSO für Leser der Docs-Seite ein. Wir prüfen Ihre Metadaten, Claim-Zuordnungen und Gruppenfilter, bevor wir Ihre veröffentlichte Dokumentation absichern.
Enterprise-Vertrieb kontaktieren →
Die Preisseite listet die Tarifstufen und den Kontaktweg für Enterprise auf. Unser Team konfiguriert den IdP gemeinsam mit Ihnen, testet auf einer Staging-Subdomain und rollt bei Bereitschaft auf die Produktion aus.
Alternativen
Sichern Sie Ihre Dokumentation ohne Enterprise ab: