> 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/1.6/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://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-c95769d2be0cccb2ff4e4f32feffab959a5d48f1%2Fzitadel1.png?alt=media" alt=""><figcaption></figcaption></figure>
5. Choose **Code** for authorization method.

   <figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-989bc4ab5085470070dc5c53a1157737074f94ab%2Fzitadel2.png?alt=media" alt=""><figcaption></figcaption></figure>
6. Enter a redirect URI for your Defguard instance. The URI is in the form `<DEFGUARD_DASHBOARD_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 proxy, make sure to enter an additional URI here in the form of `<DEFGUARD_ENROLLMENT_URL>/openid/callback`.

   <figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-3e4d6639500bceeead840ca254a422c891005c3d%2Fzitadel3.png?alt=media" 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://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-b948e098f403ddf2adedf9f159192c9d86758a50%2Fzitadel4.png?alt=media" alt=""><figcaption></figcaption></figure>
