> For the complete documentation index, see [llms.txt](https://doc.dastra.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.dastra.eu/features/settings/sso/okta.md).

# Okta

Configurer Okta comme fournisseur d'identité dans Dastra avec le protocole OpenID Connect.

Cette page explique comment configurer le login Okta en SSO dans Dastra avec le protocole **OpenID Connect**. Il est également possible de le faire avec SAML : voir [SAML 2](https://doc.dastra.eu/features/settings/sso/saml.md).

1. Connectez-vous à la console d'administration d'Okta.
2. Ouvrez le menu **Applications** > **Applications**, puis cliquez sur **Create App Integration**.

   ![Le menu Applications d'Okta avec le bouton Create App Integration](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FPbMa9MTTgZtxOtJGMkHL%2Fokta-home.png?alt=media\&token=03907945-64b3-4000-88f5-47e4aa273073)
3. Sélectionnez **OIDC - OpenID Connect**.

   ![Le choix du type de connexion dans Okta](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F7t0DO8H9aqGRRuLntfjD%2Fokta-select.png?alt=media\&token=7aa62ce6-9af9-47a1-8647-7f07f34ddec1)
4. Sélectionnez le type d'application **Web application**.

   ![Le choix du type d'application dans Okta](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F7lsqmyrdyhTCy7XD1MjC%2Fokta-app-type.png?alt=media\&token=fe0f8239-05bb-4ddd-958a-8f9c4d47d2be)
5. Configurez l'application et cochez **Implicit (hybrid)** dans **Grant type**. Pour le logo de l'application, vous pouvez [utiliser celui-ci](https://www.dastra.eu/img/press/logodastra.png).

   ![La configuration générale de l'application dans Okta, avec Implicit (hybrid) coché](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FcgNhJhmxxojBAxXhILu4%2Fokta-config.png?alt=media\&token=7c2399c6-990f-4c22-a879-648ea18b8582)
6. Dans Dastra, récupérez l'URL de redirection : ouvrez [la page de gestion du SSO](https://app.dastra.eu/general-settings/sso), cliquez sur **Ajouter un login SSO** et choisissez **OpenID**. Dans la section **Configuration**, vers le bas du formulaire, copiez l'URL de redirection.

   <figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-be94e7ffcaa4762be6f76c9e64a0e3d7790acf62%2Fsettings-okta-1.png?alt=media" alt="Le bas de la section Configuration du formulaire OpenID, avec l&#x27;URL de redirection à copier"><figcaption><p>L'URL de redirection affichée par Dastra</p></figcaption></figure>
7. Retournez dans Okta et collez l'URL de redirection dans **Sign-in redirect URIs**. Sélectionnez les utilisateurs d'Okta à qui vous souhaitez donner accès à Dastra (par défaut, vous pouvez cocher **Allow everyone**), puis cliquez sur **Save**.

   ![Le champ Sign-in redirect URIs d'Okta](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FkxzXSe2MkcVCTyqvA8z3%2Fokta-redirecturi-config.png?alt=media\&token=77a9af12-f112-4b61-baa8-10895adb802e)
8. Okta affiche la page des paramètres de la nouvelle application : l'identifiant du client (Client ID), la clé secrète (Client secret) et le domaine Okta, qui sert d'autorité.

   ![Les identifiants du client dans Okta](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FVsfbe4YEo8aYtKwcYhaq%2Fokta-client-settings.png?alt=media\&token=ce578222-7965-437b-b502-9563049dd2f5)

   ![Le domaine Okta, à reprendre avec le protocole https://](https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F0aKHexbvz7FXXPoQOZwo%2Fokta-domain.png?alt=media\&token=37b40428-dd5c-4b64-a8d8-9493459bd78f)
9. Retournez dans Dastra et renseignez les champs du formulaire :

   * **Id du client (ClientId)** : copiez le Client ID d'Okta.
   * **Authority/Domain** : saisissez le domaine d'Okta avec le protocole (`https://<votre domaine>.okta.com`).
   * **Issuer** : laissez le champ vide.
   * **Clé secrète** : copiez la clé secrète d'Okta.
   * **Scope** : `openid profile email`.
   * **Type de réponse** : `id_token`.

   <figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fgit-blob-88a5b8c09b1701040679dab7c613a9944c1d1508%2Fsettings-okta-2.png?alt=media" alt="Le formulaire OpenID de Dastra rempli avec les valeurs d&#x27;Okta, les valeurs secrètes étant masquées"><figcaption><p>Le formulaire OpenID de Dastra</p></figcaption></figure>
10. Cliquez sur **Enregistrer**, puis sur **Tester** sur la carte de la connexion. Si Okta vous redirige vers Dastra, la configuration est terminée.


---

# 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://doc.dastra.eu/features/settings/sso/okta.md?ask=<question>&goal=<user_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.
