# Configure an external identity provider

To configure an external identity provider, access the Keycloak administration console exposed on the `/auth` page of your installation; for example, `https://app.akamas.io/auth`.

<figure><img src="https://2155114708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgkHh2U5Lv6WWsTGWV3RA%2Fuploads%2Fgit-blob-c8a4343d5374102468a024aa8c65357dbca95e9b%2Fkc_admin_login.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Now log into the Administration Console using the admin user.\
The password for such a user can be retrieved in different ways, depending on the installation method:

* **Kubernetes.**\
  A custom password can be specified during the installation by providing a value `keycloak.adminPassword` in the helm chart. If this value was left unspecified, you can retrieve the auto-generated password with the following command:

```bash
kubectl get secret keycloak-admin-credentials \
  -o go-template='{{ .data.KEYCLOAK_ADMIN_PASSWORD | base64decode }}'
```

Note that you might need to provide the namespace in which Akamas have been installed using the flag `-n namespace`

* **Docker.**

  A custom password can be specified during the installation by providing a value for the variable `KEYCLOAK_ADMIN_PASSWORD` in the environment or in the docker-compose file. if during the installation you didn't specify the value, you can retrieve the auto-generated password with the following command:

```bash
docker exec -it keycloak cat /config/keycloak_admin | cut -d '|' -f1
```

Once logged in, select the *akamas* realm from the dropdown menu and navigate to the *Identity providers* section.

<figure><img src="https://2155114708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgkHh2U5Lv6WWsTGWV3RA%2Fuploads%2Fgit-blob-759f2d630af229b13b1d4eeb4197d6aacd3bba88%2Fkeycloak1.jpg?alt=media" alt=""><figcaption></figcaption></figure>

From here on, the steps required to proceed with the configuration vary depending on the provider you are integrating with. Select yours from the guides below:

* [Azure Active Directory](https://docs.akamas.io/akamas-docs/3.3.1/installing-akamas/configure-an-external-identity-provider/azure-active-directory)
* [Google](https://docs.akamas.io/akamas-docs/3.3.1/installing-akamas/configure-an-external-identity-provider/google)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akamas.io/akamas-docs/3.3.1/installing-akamas/configure-an-external-identity-provider.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.