Press CTRL+K to open search

Lokalisatie is bezig: Sommige inhoud wordt mogelijk nog in het Engels weergegeven terwijl we de vertaling afronden.

OpenID Single Sign On

  • Gepubliceerd op Sep 22, 2026
  • 4 Gelezen minuut(en)
  • LH
 Prev Next

OpenID single sign-on (SSO) providerconfiguratie

Quinyx ondersteunt Single Sign-On (SSO) via de OpenID Connect-specificatie (versie 1.0). Dit stelt gebruikers in staat om in te loggen op Quinyx met hun bestaande inloggegevens van de Identity Provider (IdP) van uw organisatie.

Deze gids behandelt de configuratie voor zowel web- als mobiele app SSO.

Vereisten

Voordat je met de configuratie begint, zorg ervoor dat je:

  • Toegangsrechten: Je moet de rol Account Manager in Quinyx hebben om toegang te krijgen tot de authenticatie-instellingen.

  • Identiteitsaanbieder (IdP): Een Identity Provider-setup die het OpenID Connect-framework ondersteunt (bijv. Azure AD, Okta, Google Workspace).

  • Klantgegevens: De Client ID en Client Secret gegenereerd door je identiteitsprovider.

1. Voeg een nieuwe aanbieder toe

Om een nieuwe configuratie aan te maken of een bestaande te bewerken:

  1. Ga naar Accountinstellingen > Authenticatie-instellingen > OpenID-providers.

  2. Klik op Toevoegen om een nieuwe configuratie aan te maken.

2. Algemene informatie

Configureer de details van de kernverbinding. Deze waarden komen overeen met de instellingen in je Identity Provider.

  • Naam: De weergavenaam van deze inlogmethode (bijv. "Okta Login"). Deze naam is zichtbaar voor beheerders en, indien Global Login Alias wordt gebruikt, voor eindgebruikers.

  • Naam van het attribuut: De specifieke claim in het OpenID-token die fungeert als de unieke identificatie van de gebruiker (bijv. email, sub, , of upn). Dit is hoofdlettergevoelig en moet exact overeenkomen met je IdP.

  • Scopes: De toestemmingen die Quinyx aanvraagt.

    • Vereist: openid

    • Veelvoorkomende toevoegingen: profile, email (afzonderlijke meerdere scopes met ruimtes).

  • Identificatietype: Selecteer welk veld in het Quinyx-gebruikersprofiel overeenkomt met de attribuutnaam van de provider.

    • Voorbeeld: Als je E-mail selecteert, koppelt Quinyx de email claim van de IdP aan het e-mailadres van de gebruiker in Quinyx.

  • Klant-ID: De publieke identificatie voor de Quinyx-applicatie die door jouw IdP wordt verstrekt.

  • Klantgeheim: De privésleutel/wachtwoord die door je IdP is verstrekt.

  • Logout URI: De URL waar gebruikers worden doorgestuurd nadat ze uitloggen bij Quinyx. Dit wijst meestal naar het uitlog-endpoint van je IdP.

3. Configuratieopties

Deze selectievakjes regelen specifiek authenticatiegedrag.

  • Globale inlogalias:

    • Ingeschakeld: Hiermee kunnen gebruikers de naam van deze provider (bijv. "MyCompanyLogin") invoeren in het gebruikersnaamveld van de Quinyx Mobile App. Ze worden automatisch doorgestuurd naar je SSO-inlogpagina zonder dat je een specifieke regio hoeft te selecteren.

    • Opmerking: De naam moet wereldwijd uniek zijn binnen Quinyx (EU en VS). Gevalideerd bij het opslaan.

  • Gebruik PKCE:

    • Ingeschakeld: Activeert Proof Key for Code Exchange (PKCE) voor verbeterde beveiliging. Zorg ervoor dat je IdP dit ondersteunt voordat je dit activeert.

  • Uitloggen van IDP:

    • Ingeschakeld: Wanneer een gebruiker uitlogt bij Quinyx, wordt hij ook uitgelogd uit zijn Identity Provider-sessie.

  • Activeer debugmodus:

    • Ingeschakeld: Toont gedetailleerde foutlogboeken op de inlogpagina. Aanbeveling: Schakel alleen in tijdens de eerste installatie/probleemoplossing en schakel uit voor productie.

Klik op Doorgaan om naar de Geavanceerde instellingen te gaan.

4. Geavanceerde voorafgestelde waarden

Deze sectie definieert de technische eindpunten. Je kunt dit automatisch of handmatig invullen.

De meeste identiteitsproviders bieden een metadata-URL (Discovery URL) aan.

  1. Plak de metadata-URL van je IdP in het veld Preset URL .

    • Voorbeeld: https://login.microsoftonline.com/{tenant}/v2.0/.well-known/openid-configuration

  2. Klik op Fetch preset.

  3. Quinyx vult automatisch de onderstaande velden in.

Methode B: Handmatige configuratie

Als je de vooraf ingestelde fetcher niet kunt gebruiken, voer dan handmatig de waarden in op basis van je IdP-documentatie:

  • AutorisatieURI: De URL van de inlogpagina.

  • RedirectURI: De Quinyx-URL waar de IdP de gebruiker naartoe stuurt na het inloggen.

    • Belangrijk: Kopieer deze URL na het opslaan en voeg deze toe aan de "Toegestane callback-URL's" van je IdP.

  • Methode voor clientauthenticatie: Hoe de clientgegevens worden verzonden (bijv. geen of client_secret_basic of .client_secret_post

  • Einde van de sessie: De URL die wordt gebruikt om de IdP-sessie te beëindigen.

  • Subsidietype: Kan worden ingesteld op Refresh tokenof Client credentialsmaar meestal ingesteld op Authorization Code

  • IssuerURI: De unieke identificatie van de identiteitsprovider.

  • JWK set URI: De URL bevat publieke sleutels voor handtekeningverificatie.

  • Token URI: Het eindpunt voor het uitwisselen van de autorisatiecode voor een toegangstoken.

  • Gebruikersinformatie-eindpunt: De URL om gebruikersprofielgegevens op te halen.

5. Afronding van de installatie (redirect URI)

  1. Sla je configuratie op in Quinyx.

  2. Open de configuratie opnieuw (klik op het hangslotpictogram als de geavanceerde sectie gesloten is).

  3. Zoek het RedirectURI-veld in het gedeelte Geavanceerde voorafgestelde waarden.

  4. Kopieer deze URL.

  5. Log in op het beheerdersportaal van je Identity Provider en plak deze URL in de instellingen voor Toegestane Redirect URI's (soms Reply URLs of Callback URLs genoemd) van de Quinyx-applicatie.

Appendix: Example setup (Azure AD)

Opmerking: Dit is een algemene gids voor Azure Active Directory. Interfaces kunnen veranderen.

1. Initiële opstelling in Azure AD

  1. Ga naar Azure Active Directory > App-registraties > Nieuwe registratie.

  2. Noem de app (bijvoorbeeld "Quinyx").

  3. Voor de Redirect URI selecteer je Web en voer je een tijdelijke tijdelijke plaatsvervanger in (bijv. https://localhost). Je zult dit later bijwerken.

  4. Klik op Registreren.

2. Verzamel geloofsbrieven

  1. Klant-ID: Kopieer op de pagina Overzicht de Application (client) ID.

  2. Huurder-ID: Kopieer de Directory (tenant) ID.

  3. Klantgeheim: Ga naar Certificaten & geheimen > Nieuw klantgeheim. Maak er een aan en kopieer de waarde direct (je kunt hem later niet bekijken).

3. Configureer Quinyx

  1. Maak in Quinyx een nieuwe OpenID-provider aan.

  2. Plak de Client ID en Client Secret uit Azure.

  3. Voer in Preset URL het volgende in (vervang {your-tenant-id} door de ID die in stap 2.2 is gekopieerd):
    https://login.microsoftonline.com/{your-tenant-id}/v2.0/.well-known/openid-configuration

  4. Klik op Fetch preset.

  5. Stel scopes in op: openid profile.

  6. Klik op Doorgaan of Opslaan.

  7. Belangrijk: In de Geavanceerde instellingen kopieer je de RedirectURI die door Quinyx wordt gegenereerd.

4. Finalize in Azure AD

  1. Keer terug naar je appregistratie in Azure > Authentication.

  2. Voeg de RedirectURI toe die je van Quinyx hebt gekopieerd.

  3. Verwijder de tijdelijke tijdelijke URL die je in stap 1 hebt aangemaakt.

  4. Zorg ervoor dat het selectievakje voor ID-tokens is aangevinkt (indien vereist door jouw specifieke flow, hoewel standaard OIDC het Token Endpoint gebruikt).

  5. Wijzigingen opslaan.

gerelateerde artikelen