REST

Verifieer je gebruikers tegen een extern systeem, zoals een webservice of enterprise identity provider. Als externe authenticatie is geconfigureerd, worden wachtwoorden van gebruikers nooit op ons platform opgeslagen.

Azure AD wordt hernoemd naar Microsoft Entra ID.

Wanneer je bent ingelogd in de webportal, navigeer je naar Organization & Users > Organization Setup > Integrations > External User Authentication And Provisioning, en de volgende opties zijn beschikbaar:

Okta, Azure AD (Entra ID) en Ping Identity vereisen Enterprise ToolKit.

REST

Wanneer een gebruiker inlogt op onze website of apps, ontvangt ons systeem de loginaanvraag en controleert of het e-mailadres van de gebruiker is geregistreerd op ons platform.

Als het gebruikers-e-mailadres wordt gevonden, geeft ons systeem de inloggegevens vervolgens transparant door aan deze externe webservice URL voor authenticatie.

De externe service MOET een 200 HTTP-statuscode retourneren om als geverifieerd door ons platform te worden beschouwd; elk ander antwoord wordt als loginmisluking aangemerkt.

Organisatie & gebruikers: REST - schermafbeelding 1

Authentication URL

Wanneer een gebruiker inlogt op onze website of apps, ontvangt ons systeem de loginaanvraag en controleert of het e-mailadres van de gebruiker is geregistreerd op ons platform.

Als het gebruikers-e-mailadres wordt gevonden, geeft ons systeem de inloggegevens vervolgens transparant door aan deze externe webservice URL voor authenticatie.
De externe service MOET een 200 HTTP-statuscode retourneren om als geverifieerd door ons platform te worden beschouwd; elk ander antwoord wordt als loginmisluking aangemerkt.

De volgende placeholders kunnen worden gebruikt om de gebruikers-ID, login, organisatie-ID en apparaatbesturingssysteem, naam en IP-adres in de URL, headers en body in te voegen:

{{USERID}}
{{USEREMAIL}}
{{USERPASSWORD}}
{{USEREXTERNALID}}
{{ORGID}}
{{DEVICEOS}}
{{DEVICENAME}}
{{DEVICEIP}}

HTTP Action

Selecteer de requestactie (POST, PUT, GET) en Data As (JSON, URL Encoded, XML).

Data as

Geef het REST API-format op

  • JSON
  • URL Encoded
  • XML

HTTP Auth Type

Als je service HTTP Basic-authenticatie gebruikt, hoef je Headers niet te configureren of placeholders op te geven in de Destination URL. Ons systeem voegt automatisch de vereiste headers toe en codeert het e-mailadres en wachtwoord van de gebruiker naar de gegeven URL.

Lees meer over Basic Auth

Forgot Password URL

Loginprocessen op ons platform bieden een ‘Forgot Password’-optie voor gebruikers om een wachtwoordreset per e-mail aan te vragen.

Ons systeem stuurt deze wachtwoordresetaanvragen door naar de gegeven externe service URL als HTTP GET-actie.
De externe service MOET een 200 HTTP-statuscode retourneren om als succesvol door ons platform te worden beschouwd; elk ander antwoord wordt als misluking aangemerkt.

De volgende placeholders kunnen worden gebruikt om de gebruikers-ID, e-mailadres, organisatie-ID, apparaatbesturingssysteem, naam en IP-adres in de URL in te voegen:

{{USERID}}
{{USEREMAIL}}
{{USEREXTERNALID}}
{{ORGID}}
{{DEVICEOS}}
{{DEVICENAME}}
{{DEVICEIP}}

Okta

Raadpleeg Provisioning Users and Single Sign-On with Okta

Azure Active Directory

Raadpleeg Provisioning Users and Single Sign-On with Azure Active Directory.

Ping Identity

Raadpleeg Single Sign-On with Ping Identity.

Antwoord niet gevonden?

Staat jouw vraag er niet bij? Neem dan direct contact met ons op.

Contact opnemen