Helpjuice ondersteunt authenticatie van gebruikers via Single Sign On met JWT. Het gaat als volgt:
- De gebruiker kiest ervoor om te authenticeren via SSO
- Helpjuice leidt de gebruiker door naar uw website waar ze zich kunnen authenticeren met een gebruiker / wachtwoord
- Uw website genereert een JSON Web Token met behulp van de gedeelde sleutel die wordt geleverd door Helpjuice en stuurt de gebruiker met het token terug naar Helpjuice
- Helpjuice decodeert het token en verifieert de gebruiker met het door u opgegeven e-mailadres
- Als de gebruiker nieuw is, maken we een nieuw gebruikersaccount voor hem aan
Om het in te stellen, ga je naar je accountinstellingen> Eenmalige aanmelding met JWT
Vul dan het formulier in:
JWT-velden
Dit zijn de velden die Helpjuice zal gebruiken van uw JSON Web Token:
Veld | Verplicht? | Omschrijving |
jti | Ja | Dit veld bevat een uniek token-ID gegenereerd door uw website. Helpjuice zal het gebruiken om replay-aanvallen te voorkomen. |
iat | Ja | Dit veld moet de aanmaaktijd van het token in milliseconden sinds het Unix-tijdperk bevatten. Helpjuice accepteert alleen tokens tot 3 minuten oud. |
Ja | Het e-mailadres van de geauthenticeerde gebruiker zodat Helpjuice de gebruiker kan identificeren. | |
Voornaam | Nee | De voornaam van de gebruiker. |
achternaam | Nee | De achternaam van de gebruiker |
Gebruik https://jwt.io om problemen met uw token op te lossen. Het biedt een hulpmiddel om uw token te analyseren en u te laten zien of het de juiste lay-out gebruikt.
Aanmelden gebruikers
Wanneer Helpjuice een gebruiker Helpjuice aan uw inlogpagina toevoegt, zal het een parameter toevoegen aan de URL genaamd service en deze instellen op helpjuice , zoals: https://my.website.com/login?service=helpjuice . Dit kan handig zijn om de service te identificeren en de lay-out van het authenticatietoken correct te configureren.
Na succesvolle authenticatie, moet u het gegenereerde token ondertekenen met de Shared Secret Helpjuice die u op die instellingenpagina opgeeft. Vervolgens moet u ze omleiden naar https://helpjuice.com/jwt/YOUR_SUBDOMAIN?jwt=YOUR_ENCODED_TOKEN .
Log uit gebruikers
Nadat een gebruiker is Helpjuice , Helpjuice zal Helpjuice ze naar de uitschrijven opgegeven URL (indien aanwezig).