Swipeguide: Eenmalige aanmelding (SSO)

Last updated: June 19, 2026

Algemeen gebruik​

We bieden een OAuth2-authenticatie-integratie voor het platform, die kan worden gebruikt om in te loggen op het Web CMS, de Web Frontline App, de SwipeGuide Native Apps (iOS en Android) voor offline toegang en de Slimme vaardigheden-app.

Hiermee kunnen uw gebruikers zich authenticeren via de OAuth2-provider die door uw bedrijf wordt beheerd.

Houd er rekening mee dat autorisatieniveaus binnen het platform nog steeds binnen het platform worden beheerd om een gebruiksvriendelijk en begrijpelijk systeem te behouden.

We bieden de flexibiliteit om verschillende soorten inlogmethoden op het CMS en de Frontline Apps te configureren, afhankelijk van de behoeften van de Workspace, zoals e-mail en wachtwoord, evenals SSO. U kunt uw gebruikers ook verplichten om ALLEEN met SSO in te loggen.

Als u deze functie op uw platform wilt inschakelen, neem dan contact op met SwipeGuide Support voordat u deze documentatie gebruikt.

Vereisten​

  1. Uw platform moet al over ingeschakelde inlogopties beschikken (in plaats van een openbaar platform te zijn).
  2. De OAuth2-provider die u wilt gebruiken om u aan te melden bij SwipeGuide moet al door uw IT-teams worden beheerd en ingesteld met geldige inloggegevens of certificaten. SwipeGuide moet al als een van de applicaties in uw systemen zijn toegevoegd.

OAuth2 instellen​

Raadpleeg voor basisdocumentatie de OAuth-website. Om uw platform in te stellen, hebben we bepaalde informatie nodig die bij uw OAuth2-authenticatieservice moet worden ingediend en is er informatie nodig om de services met elkaar te verbinden. We hebben een callback-URL die binnen de OAuth2-authenticatieservice moet worden ingesteld en we hebben OAuth2-autorisatietokens van de service nodig. Deze verschillen per service.

We ondersteunen momenteel direct:

  • Microsoft Entra ID (voorheen Azure AD)
  • Google

Microsoft Entra ID​

Om de configuratie van Microsoft Entra ID (voorheen Azure AD) te laten werken, hebben we het volgende nodig: clientID, clientSecret, resource en tenant. Meer informatie hierover vindt u in de OAuth-documentatie voor Azure Entra ID.

Callback-URL

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

Het platform in de URL is het hoofddomein van het platform waarnaar moet worden verwezen. Houd er rekening mee dat deze callback-URL werkt voor zowel platforms met één domein als platforms met meerdere domeinen en dat de gebruiker dienovereenkomstig wordt doorgestuurd.

Google​

Om de configuratie van Google te laten werken, hebben we het volgende nodig: clientID, clientSecret en hostedDomain. Meer informatie hierover vindt u in de OAuth-documentatie voor Google.

Callback-URL

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

Het platform in de URL is het hoofddomein van het platform waarnaar moet worden verwezen. Houd er rekening mee dat deze callback-URL werkt voor zowel platforms met één domein als platforms met meerdere domeinen en dat de gebruiker dienovereenkomstig wordt doorgestuurd.

SAML 2.0 instellen​

Om de SAML-configuratie te laten werken, hebben we uw metadatabestand nodig of:

entryPoint: SSO-service-URL cert: Het openbare ondertekeningscertificaat dat wordt gebruikt om de handtekeningen van de binnenkomende SAML-antwoorden te valideren, indien gebruikt.

De claims die we van u nodig hebben: displayName, ID, Email

URL van de Assertion Consumer Service

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

SAML-metadata

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

Entiteits-ID: swipe-guide

Het platform in de URL is het hoofddomein van het platform waarnaar moet worden verwezen. Houd er rekening mee dat deze callback-URL werkt voor zowel platforms met één domein als platforms met meerdere domeinen en dat de gebruiker dienovereenkomstig wordt doorgestuurd.

Automatische sessie-time-out​

Als aanvullende platformservice en configuratie kunt u via uw Manager klantsucces verzoeken om sessies automatisch te laten verlopen na X minuten inactiviteit (het ontbreken van verzoeken aan de server).

Veelgestelde vragen

1. Lees wat u moet doen wanneer de SSO-authenticatiefout wordt weergegeven nadat u probeert in te loggen bij SwipeGuide

U kunt een authenticatiefout ontvangen wanneer u inlogt bij SwipeGuide-platforms vanwege een verlopen geheime sleutel.

Single sign-on (SSO) is een authenticatiemethode waarmee gebruikers zich veilig kunnen authenticeren bij meerdere applicaties en websites door slechts één set inloggegevens te gebruiken.

Momenteel is SSO een Add-On-functie die kan worden aangevraagd door een ticket in te dienen bij Support. De IT-afdeling van uw bedrijf moet de gevraagde informatie aanleveren op basis van de gewenste oplossingsprovider aan het SwipeGuide-engineeringteam om dit in te stellen. We beheren of onderhouden zelf geen sleutels van klanten.

Als u denkt dat uw geheime sleutel is verlopen of binnenkort verloopt, doet u dan het volgende:

  • Informeer uw lokale IT-afdeling hierover en vraag proactief om een nieuw certificaat
  • Neem contact op met SwipeGuide Support met de nieuwe gegevens

Opmerking: We raden uw bedrijf ten zeerste aan om elke 2 jaar een herinnering in te stellen om te voorkomen dat dit uw gebruikers blokkeert bij het inloggen en om de nieuwe inloggegevens met ons te delen.

2. Meerdere gebruikers op een gedeeld apparaat

U kunt in een situatie terechtkomen waarin bijvoorbeeld "Operator A en Operator B een gedeeld apparaat gebruiken, Operator A uitlogt bij de APP en Operator B vervolgens inlogt bij de APP. Operator B ziet nu de Vaardighedenmatrix van Operator A."

Waarom gebeurt dit?

Wanneer een gebruiker inlogt op de app met SSO, controleert deze of er al een actieve SSO-sessie op dat apparaat is. Als Operator A zich afmeldt bij de app maar niet volledig afmeldt bij het SSO-account zelf, wordt de volgende persoon (Operator B) automatisch herkend als Operator A bij het inloggen via SSO. Dit is normaal gedrag bij veel apps die SSO of vergelijkbare services gebruiken, omdat ze vertrouwen op de huidige aanmeldstatus van de browser of het apparaat.
 
Om ervoor te zorgen dat elke gebruiker zijn of haar inloggegevens moet invoeren bij het gebruik van een gedeeld apparaat, volgt u deze stappen:
1. Meld u na het gebruik van de app zoals gewoonlijk af bij de APP.
2. Meld u ook volledig af bij het SSO-account (bijvoorbeeld Google) in de browser of op het apparaat.
3. De volgende gebruiker kan vervolgens inloggen met zijn of haar eigen inloggegevens.
 
Als alternatief kunnen gebruikers, om deze automatische SSO-herkenning te voorkomen, op gedeelde apparaten inloggen met hun e-mailadres en wachtwoord in plaats van SSO.