> For the complete documentation index, see [llms.txt](https://docs.defguard.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defguard.net/2.0/features/external-openid-providers/zitadel.md).

# Zitadel

{% hint style="info" %}
Refer to [Zitadel's documentation](https://zitadel.com/docs) on how to install it.
{% endhint %}

1. Log in to Zitadel's web interface.
2. Create a project.
3. Add a new application within the project.
4. Select **Web** for application type.

   <figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-a118d818a8a2d37c0466eb1ccfce6cca09b1c8f3%2Fzitadel1.png?alt=media" alt=""><figcaption></figcaption></figure>
5. Choose **Code** for authorization method.

   <figure><img src="https://2426002228-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqPYuWxfmxFk6sz1LLLwd%2Fuploads%2Fgit-blob-079e8b5ccfedb409f862e8c572fc3ba0d85fed6d%2Fzitadel2.png?alt=media" alt=""><figcaption></figcaption></figure>
6. Enter a redirect URI for your Defguard instance. The URI is in the form `<DEFGUARD_URL>/auth/callback`, for example `https://defguard.example.com/auth/callback`. (If Defguard has been launched on the *localhost*, select **Development Mode** and enter `http://localhost:8000/auth/callback`). If you'd like to use OpenID enrollment through Edge, make sure to enter an additional URI here in the form of `<DEFGUARD_PUBLIC_URL>/openid/callback`.

   <figure><img src="https://content.gitbook.com/content/qPYuWxfmxFk6sz1LLLwd/blobs/4g1S3wayMQjtn24pGXQI/zitadel3.png" alt=""><figcaption></figcaption></figure>
7. **Create** the application.
8. Copy the provided **Client ID** and **Client Secret** and enter these in the Defguard's OpenID settings.
9. Finally, in the **Token Settings**, enable **User Info inside ID Token**.

   <figure><img src="https://content.gitbook.com/content/qPYuWxfmxFk6sz1LLLwd/blobs/Giz5oDhGoNpotldIuDcF/zitadel4.png" alt=""><figcaption></figcaption></figure>
