> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-nl/beveiligen-en-beheren/identity-providers/okta.md).
# Okta
Gebruik Okta als uw identiteitsprovider, zodat gebruikers zich bij Dispel aanmelden met hun Okta-gegevens via OAuth (OIDC) of SAML.
## Overzicht
Koppel Okta — het enterprise-identiteitsplatform van Okta — als de identiteitsprovider van uw organisatie. Zodra de koppeling is gemaakt, melden uw gebruikers zich bij Dispel aan met hun Okta-gegevens via single sign-on. U kunt Okta koppelen via **OAuth (OIDC)** of **SAML**.
Deze pagina behandelt de specifieke Okta-instelling. Voor het gedeelde gedrag dat voor elke provider geldt — hoe gebruikers zich aanmelden, groepskoppeling, MFA en ontkoppelen — zie [Identiteitsproviders](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md).
{% hint style="info" %}
**Waar u het kunt vinden.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties** (of de speciale **Instellingen → Authenticatie** pagina). Okta verschijnt in de **Identiteit & Authenticatie (IdP / SSO)** sectie. Klik **Verbinden** op de kaart om te beginnen.
{% endhint %}
## Voordat u begint
* U configureert de IdP-zijde in het **Okta-beheerdersconsole**, dus u hebt daar beheerdersrechten nodig.
* Kies een protocol — **OAuth (OIDC)** of **SAML**. Zie [Een protocol kiezen](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#choosing-a-protocol).
* Zorg ervoor dat de gebruikers die zich via Okta gaan aanmelden al **zijn uitgenodigd voor uw organisatie** in Dispel. SSO verifieert gebruikers, maar creëert op zichzelf geen toegang.
{% hint style="warning" %}
**Eén provider tegelijk.** Als uw organisatie al is gekoppeld aan een andere identiteitsprovider, ontkoppel die dan voordat u Okta koppelt.
{% endhint %}
## Verbinden met OAuth (OIDC)
#### In Okta
1. In de Okta-beheerdersconsole, ga naar **Applicaties → App-integratie maken** en kies **OIDC — OpenID Connect**.
2. Stel de **omleidings-URI voor aanmelden** in op uw Dispel-adres gevolgd door `/oauth/login-callback` — bijvoorbeeld `https://app.dispel.com/oauth/login-callback`. Bevestig het exacte adres voor uw omgeving bij uw Dispel-contactpersoon als u het niet zeker weet.
3. Wijs de app toe aan de gebruikers of groepen die toegang zouden moeten hebben.
4. Vanaf de **Algemeen** tabblad, kopieer de **Client ID** en **Clientgeheim**, en noteer uw Okta-domein / issuer.
#### In Dispel
1. Klik op **Verbinden** op de Okta-kaart en **Selecteer Authenticatieprotocol → OAuth**.
2. Vul de velden in:
| Veld | Waarde uit Okta |
| ------------------ | ------------------------------------------------------------------------------- |
| **Client-URL** | Uw Okta OAuth/OIDC-eindpunt (issuer), bijvoorbeeld `https://your-org.okta.com`. |
| **Client ID** | Het **Client ID**. |
| **Client Secret** | Het **Clientgeheim**. |
| **Organisatie-ID** | Een unieke identifier die u kiest; gebruikers typen deze in op het inlogscherm. |
3. Klik op **Instellingen opslaan**.
## Verbinden met SAML
#### In Okta
1. In de Okta-beheerdersconsole, ga naar **Applicaties → App-integratie maken** en kies **SAML 2.0**.
2. Plak in de SAML-instellingen de waarden die Dispel bovenaan het SAML-formulier toont:
* **Single sign-on-URL / Ontvanger / Bestemming** ← Dispel's **Assertion Consumer Service-URL**.
* **Audience-URI (SP-entiteits-ID)** ← Dispel's **Entiteits-ID van de serviceprovider (SP)**.
3. Rond het maken van de app af en open daarna het **Aanmelden** tabblad en verzamel:
* **URL voor eenmalige aanmelding van de identiteitsprovider** → Dispel's **SSO-URL**.
* **Issuer van de identiteitsprovider** → Dispel's **Entiteits-ID van de identiteitsprovider**.
* De **X.509-/ondertekeningscertificaat** → Dispel's **Base64-ondertekeningscertificaat**.
4. Wijs de app toe aan de gebruikers of groepen die toegang zouden moeten hebben.
#### In Dispel
1. Klik op **Verbinden** op de Okta-kaart en **Selecteer Authenticatieprotocol → SAML**.
2. Kopieer de **Entiteits-ID van de serviceprovider (SP)** en **Assertion Consumer Service-URL** die bovenaan het formulier wordt weergegeven (gebruik **ID kopiëren** / **URL kopiëren**) in Okta, zoals hierboven.
3. Vul de velden in:
| Veld | Waarde uit Okta |
| ------------------------------------------- | --------------------------------------------------------------------------------- |
| **SSO-URL** | De **URL voor eenmalige aanmelding van de identiteitsprovider**. |
| **Entiteits-ID van de identiteitsprovider** | De **Issuer van de identiteitsprovider**. |
| **Base64-ondertekeningscertificaat** | Het Okta-ondertekeningscertificaat. Plak het of gebruik **Certificaat uploaden**. |
| **Organisatie-ID** | Een unieke identifier die u kiest; gebruikers typen deze in op het inlogscherm. |
4. Klik op **Instellingen opslaan**.
5. Klik op **Verbinding testen**. Dispel stuurt u door naar Okta om u aan te melden en toont vervolgens het e-mailadres en de naam die het heeft ontvangen. Als de test mislukt, controleer dan of de waarden overeenkomen met uw Okta-app en of de testgebruiker is uitgenodigd voor uw organisatie.
## Na het verbinden
* **Gebruikers melden zich aan** door uw Organisatie-ID in te voeren op het inlogscherm van Dispel en u te authenticeren met Okta. Zie [Hoe gebruikers zich aanmelden](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#how-users-sign-in).
* **Okta-groepen koppelen aan Dispel-groepen** zodat het lidmaatschap synchroon blijft — zie [OIDC-groepskoppeling](/documentation/documentation-nl/integreren-en-beheren/integrations/oidc-group-mapping.md).
* **MFA** afgedwongen in Okta is van toepassing tijdens het aanmelden; de eenmalige e-mailcodes van Dispel zijn niet van toepassing op SSO-gebruikers. Zie [SSO en multifactorauthenticatie](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#sso-and-multi-factor-authentication).
* **Om van protocol of provider te wisselen**, ontkoppel eerst. Zie [Van provider wisselen of de verbinding verbreken](/documentation/documentation-nl/beveiligen-en-beheren/identity-providers.md#switching-or-disconnecting-a-provider).
## Veelgestelde vragen
Welk protocol moet ik gebruiken met Okta?
Beide werken. Gebruik wat overeenkomt met de app die u in Okta maakt — een OIDC-appintegratie voor OAuth, of een SAML 2.0-appintegratie voor SAML.
Moet ik gebruikers aan de Okta-app toewijzen?
Ja. Alleen gebruikers (of groepen) die aan de Okta-app zijn toegewezen, kunnen zich erdoor authenticeren. Ze moeten ook worden uitgenodigd voor uw Dispel-organisatie.
Mijn SAML-testverbinding is mislukt. Wat moet ik controleren?
Controleer of de SSO-URL, issuer en het certificaat overeenkomen met de Sign On-instellingen van uw Okta-app, of u Dispel's SP-entiteits-ID en ACS-URL in de SAML-instellingen van Okta hebt geplakt, en of de testgebruiker is toegewezen aan de Okta-app en is uitgenodigd voor uw Dispel-organisatie.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.dispel.com/documentation/documentation-nl/beveiligen-en-beheren/identity-providers/okta.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.