Swipeguide: Einmalanmeldung (SSO)

Last updated: June 19, 2026

Allgemeine Verwendung​

Wir bieten eine OAuth2-Authentifizierungsintegration für die Plattform an, die zur Anmeldung im Web CMS, in der Web-Frontline-App, in den nativen SwipeGuide-Apps (iOS und Android) für den Offline-Zugriff sowie in der App „Intelligente Fähigkeiten“ verwendet werden kann.

Dies ermöglicht Ihren Benutzern, sich über den OAuth2-Anbieter zu authentifizieren, der von Ihrem Unternehmen verwaltet wird.

Bitte beachten Sie, dass die Berechtigungsstufen innerhalb der Plattform weiterhin innerhalb der Plattform verwaltet werden, um ein benutzerfreundliches und verständliches System aufrechtzuerhalten.

Wir bieten die Flexibilität, je nach den Anforderungen des Arbeitsbereichs verschiedene Arten von Anmeldemethoden im CMS und in den Frontline-Apps zu konfigurieren, z. B. E-Mail und Passwort sowie SSO. Alternativ können Sie festlegen, dass sich Ihre Benutzer NUR mit SSO anmelden.

Wenn Sie diese Funktion auf Ihrer Plattform aktivieren möchten, wenden Sie sich bitte unbedingt an den SwipeGuide-Support, bevor Sie diese Dokumentation verwenden.

Voraussetzungen​

  1. Ihre Plattform muss bereits über aktivierte Anmeldeoptionen verfügen (im Gegensatz zu einer öffentlichen Plattform).
  2. Der OAuth2-Anbieter, den Sie für die Anmeldung bei SwipeGuide verwenden möchten, sollte bereits von Ihren IT-Teams verwaltet und eingerichtet sein und über gültige Anmeldedaten oder Zertifikate verfügen. SwipeGuide sollte bereits als eine der Anwendungen in Ihren Systemen hinzugefügt worden sein.

OAuth2-Einrichtung​

Für eine grundlegende Dokumentation konsultieren Sie bitte die OAuth-Website. Um Ihre Plattform einzurichten, benötigen wir einige Informationen, die an Ihren OAuth2-Authentifizierungsdienst übermittelt werden müssen, und es gibt einige Informationen, die wir benötigen, um die Dienste zu verbinden. Wir haben eine Callback-URL, die innerhalb des OAuth2-Authentifizierungsdienstes eingerichtet werden muss, und wir benötigen einige OAuth2-Autorisierungstoken von diesem Dienst. Diese unterscheiden sich je nach Dienst.

Wir unterstützen derzeit standardmäßig:

  • Microsoft Entra ID (früher Azure AD)
  • Google

Microsoft Entra ID​

Damit die Einrichtung von Microsoft Entra ID (früher Azure AD) funktioniert, benötigen wir: clientID, clientSecret, resource und tenant. Weitere Informationen zu diesen finden Sie in der OAuth-Dokumentation für Azure Entra ID.

Callback-URL

https://[platform].swipeguide.com/sso/azureadoauth2/callback

Die Plattform in der URL ist die Hauptdomain der Plattform, auf die verwiesen werden muss. Bitte beachten Sie, dass diese Callback-URL sowohl für Plattformen mit einer als auch mit mehreren Domains funktioniert und der Benutzer entsprechend weitergeleitet wird.

Google​

Damit die Google-Einrichtung funktioniert, benötigen wir: clientID, clientSecret und hostedDomain. Weitere Informationen zu diesen finden Sie in der OAuth-Dokumentation für Google.

Callback-URL

https://[platform].swipeguide.com/sso/googleoauth2/callback

Die Plattform in der URL ist die Hauptdomain der Plattform, auf die verwiesen werden muss. Bitte beachten Sie, dass diese Callback-URL sowohl für Plattformen mit einer als auch mit mehreren Domains funktioniert und der Benutzer entsprechend weitergeleitet wird.

SAML 2.0-Einrichtung​

Damit die SAML-Einrichtung funktioniert, benötigen wir Ihre Metadatendatei oder:

entryPoint: SSO-Service-URL cert: Das öffentliche Signaturzertifikat, das zur Validierung der Signaturen der eingehenden SAML-Antworten verwendet wird, falls es genutzt wird.

Die Ansprüche, die wir von Ihnen benötigen: displayName, ID, Email

Assertion Consumer Service-URL

https://[platform].swipeguide.com/sso/saml/consume

SAML-Metadaten

https://[platform].swipeguide.com/sso/saml/metadata

Entitäts-ID: swipe-guide

Die Plattform in der URL ist die Hauptdomain der Plattform, auf die verwiesen werden muss. Bitte beachten Sie, dass diese Callback-URL sowohl für Plattformen mit einer einzelnen als auch mit mehreren Domains funktioniert und der Benutzer entsprechend weitergeleitet wird.

Automatisches Sitzungs-Timeout​

Als zusätzlichen Plattformdienst und Konfiguration können Sie über Ihren Customer Success Manager anfordern, dass Sitzungen nach X Minuten Inaktivität (keine Anfragen an den Server) automatisch beendet werden.

Häufig gestellte Fragen

1. Erfahren Sie, was zu tun ist, wenn nach dem Anmeldeversuch bei SwipeGuide ein SSO-Authentifizierungsfehler angezeigt wird

Beim Anmelden bei SwipeGuide-Plattformen kann aufgrund eines abgelaufenen geheimen Schlüssels ein Authentifizierungsfehler auftreten.

Single Sign-on (SSO) ist eine Authentifizierungsmethode, die es Benutzern ermöglicht, sich sicher bei mehreren Anwendungen und Websites zu authentifizieren, indem sie nur einen einzigen Satz von Anmeldedaten verwenden.

Derzeit ist SSO eine Add-On-Funktion, die durch das Einreichen eines Tickets beim Support angefordert werden kann. Die IT-Abteilung Ihres Unternehmens muss die angeforderten Informationen basierend auf dem gewünschten Lösungsanbieter dem SwipeGuide-Engineering-Team zur Verfügung stellen, damit dies eingerichtet werden kann. Wir verwalten oder pflegen selbst keine Schlüssel des Kunden.

Wenn Sie denken, dass Ihr geheimer Schlüssel abgelaufen ist oder bald abläuft, gehen Sie bitte wie folgt vor:

  • Informieren Sie Ihre lokale IT-Abteilung darüber und bitten Sie proaktiv um ein neues Zertifikat
  • Wenden Sie sich mit den neuen Details an den SwipeGuide-Support

Hinweis: Wir empfehlen Ihrem Unternehmen dringend, alle 2 Jahre eine Erinnerung einzurichten, um zu verhindern, dass Ihre Benutzer sich nicht mehr anmelden können, und uns die neuen Zugangsdaten mitzuteilen.

2. Mehrere Benutzer auf einem gemeinsam genutzten Gerät

Sie könnten auf eine Situation stoßen, in der beispielsweise „Bediener A und Bediener B ein gemeinsam genutztes Gerät verwenden, Bediener A sich von der App abmeldet und sich anschließend Bediener B bei der App anmeldet. Bediener B sieht nun die Fähigkeitsmatrix von Bediener A.“

Warum passiert das?

Wenn sich ein Benutzer über SSO bei der App anmeldet, wird geprüft, ob auf diesem Gerät bereits eine aktive SSO-Sitzung besteht. Wenn sich Operator A aus der App abmeldet, sich aber nicht vollständig von seinem SSO-Konto selbst abmeldet, wird die nächste Person (Operator B) bei der Anmeldung über SSO automatisch als Operator A erkannt. Dies ist ein übliches Verhalten bei vielen Apps, die SSO oder ähnliche Dienste verwenden, da sie sich auf den aktuellen Anmeldestatus des Browsers oder Geräts stützen.
 
Damit jeder Benutzer bei der Verwendung eines gemeinsam genutzten Geräts seine Anmeldedaten eingeben muss, befolgen Sie bitte diese Schritte:
1. Melden Sie sich nach der Nutzung der App wie gewohnt aus der APP ab.
2. Melden Sie sich außerdem vollständig vom SSO-Konto (zum Beispiel Google) im Browser oder auf dem Gerät ab.
3. Der nächste Benutzer kann sich dann mit seinen eigenen Anmeldedaten anmelden.
 
Alternativ können sich Benutzer auf gemeinsam genutzten Geräten mit ihrer E-Mail-Adresse und ihrem Passwort anstelle von SSO anmelden, um diese automatische SSO-Erkennung zu vermeiden.