---
title: Connecting Your Identity Provider (Okta, Microsoft Entra, Google Workspace)
description: How to connect Okta, Microsoft Entra ID, or Google Workspace to AppGovern, including required credentials, scopes, and sync settings.
---

[Skip to content](https://support.appgovern.com/knowledge-base/connecting-your-identity-provider-okta-microsoft-entra-google-workspace#main-content)

English

Show submenu for translations

[Submit a ticket](https://support.appgovern.com/knowledge-base/kb-tickets/new?hsLang=en)

[![AppGovern](https://support.appgovern.com/hs-fs/hubfs/image50-c..jpeg?width=180&height=38&name=image50-c..jpeg)](https://www.appgovern.com/new/)

- [Support home](https://support.appgovern.com/knowledge-base)

Open main navigation

Close main navigation

- [Support home](https://support.appgovern.com/knowledge-base)
- English
  
  Show submenu for translations
- [Submit a ticket](https://support.appgovern.com/knowledge-base/kb-tickets/new)
- [Contact us](https://www.appgovern.com/new/contact/)

[Contact us](https://www.appgovern.com/new/contact/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [AppGovern Platform Knowledge Base](https://support.appgovern.com/knowledge-base?hsLang=en)
2. [Integrations](https://support.appgovern.com/knowledge-base/integrations?hsLang=en)

# Connecting Your Identity Provider (Okta, Microsoft Entra, Google Workspace)

## Step-by-step setup for each supported identity provider, including the credentials and scopes AppGovern needs to discover apps and users.

AppGovern discovers applications and users by syncing with your identity provider (IdP). This article covers the setup for Okta, Microsoft Entra ID (Azure), and Google Workspace. JumpCloud and Auth0 follow the same pattern.

### Before you start

You will need:

- Admin rights in AppGovern
- Admin rights in your identity provider to create an API integration or app registration
- About 15 minutes

Each IdP connection asks for the same core information: a connection URL, a client ID, a secret or private key, and a sync interval in hours. The exact steps to get those values differ by provider.

### Where to connect

Go to **Integration** in the left sidebar and open the **IDP** tab. Each supported provider has a card. Click **Integrate** to start a new connection, or **Edit** to change an existing one. A **Completed** badge means the connection is active.

![appgovern-integration-idp-tab](https://support.appgovern.com/hs-fs/hubfs/appgovern-integration-idp-tab.jpg?width=670&height=346&name=appgovern-integration-idp-tab.jpg)

### Microsoft Entra ID (Azure)

#### In Entra

1. Open the Entra admin center and go to **App registrations**. Create a new registration for AppGovern.
2. Copy the **Application (client) ID** and the **Directory (tenant) ID**.
3. Under **Certificates & secrets**, create a client secret and copy the value. It is shown only once.
4. Under **API permissions**, add Microsoft Graph application permissions for reading users, groups, applications, service principals, and sign-in logs. Grant admin consent.

#### In AppGovern

1. On the **Azure** card, click **Integrate**.
2. **Connection**: enter `https://login.microsoftonline.com/<your-tenant-id>`.
3. **Client Id**: paste the Application (client) ID.
4. **Client Secret**: paste the secret value.
5. **Scope**: leave as `https://graph.microsoft.com/.default`.
6. **Sync Interval**: how often AppGovern pulls from Entra, in hours. 6 is a reasonable default.
7. Click **Authorize**.

### Okta

Okta uses OAuth 2.0 with a service app and a JWT assertion. No user credentials are stored.

#### In Okta

1. In the Okta Admin Console, go to **Applications \> Applications** and create an **API Services** app integration.
2. Under **Client Credentials**, set the authentication method to **Public key / Private key** and generate a key pair. Save the private key in JWK or PEM format and note the **Key ID**.
3. Copy the **Client ID**.
4. Under **Okta API Scopes**, grant the scopes listed below.
5. Under **Admin roles**, assign a role that can read users, groups, apps, and logs (Read-only Administrator is enough).

Required scopes:

- okta.apps.read
- okta.apps.manage
- okta.groups.read
- okta.groups.manage
- okta.users.read
- okta.users.manage
- okta.roles.read
- okta.logs.read

#### In AppGovern

1. On the **Okta** card, click **Integrate**.
2. **Connection**: your Okta org URL, for example `https://yourcompany.okta.com`.
3. **Client ID (OAuth)**: paste the client ID.
4. **Private Key (JWK Format)**: paste the private key. JWK JSON or PEM both work.
5. **Key ID**: paste the key ID from Okta.
6. **Scope**: the required scopes are pre-filled. Add any extras here.
7. **Sync Interval**: in hours.
8. Click **Authorize**.

### Google Workspace

#### In Google Cloud

1. In the Google Cloud console, create or select a project and enable the **Admin SDK API**.
2. Create an **OAuth 2.0 Client ID** of type Web application. Add the AppGovern redirect URL shown on the integration form to the authorized redirect URIs.
3. Copy the **Client ID** and **Client secret**.
4. Make sure the Google account you authorize with is a Workspace super admin or has the admin roles needed to read users, groups, and application usage.

#### In AppGovern

1. On the **GWS** card, click **Integrate**.
2. **Connection**: your Google Workspace domain or admin URL.
3. **Client Id** and **Client Secret**: paste from Google Cloud.
4. **Sync Interval**: in hours.
5. Click **Authorize** and complete the Google consent screen.

![appgovern-gws-integration-form](https://support.appgovern.com/hs-fs/hubfs/appgovern-gws-integration-form.jpg?width=670&height=346&name=appgovern-gws-integration-form.jpg)

### After you connect

- The card shows a **Completed** badge once AppGovern can reach the IdP.
- The first sync starts right away. Directories with a few hundred users finish in minutes. Larger ones can take longer.
- Synced users appear under **User Management \> IDP Users**. Discovered apps appear under **Application \> App Directory** with the IdP listed as the **Source**.
- The Overview Dashboard's **IDP Integrations** count goes up by one.

### Changing or removing a connection

Click **Edit** on the card to change credentials or the sync interval. Leave the key or secret field empty to keep the existing value. To rotate a secret, paste the new one and click **Authorize** again.

### Common problems

**Authorize fails right away.** Check the connection URL for typos and confirm the client ID matches the app you created in the IdP.

**Authorize succeeds but no apps appear.** The IdP app likely does not have the right permissions or scopes. In Entra, confirm admin consent was granted. In Okta, confirm the scopes and the admin role. In Google, confirm the Admin SDK API is enabled.

**The connection worked but stopped syncing.** Secrets expire. Entra client secrets have an expiry date, and Google OAuth tokens can be revoked. Open **Edit**, paste a new secret, and authorize again. See [Troubleshooting Connections and Sync Issues](https://example.com/#) for the full list.

**Can I connect more than one IdP?** Yes. Each provider card is independent. Apps and users from all connected IdPs appear in the same directory.

- [Getting started](https://support.appgovern.com/knowledge-base/getting-started?hsLang=en)
- [Integrations](https://support.appgovern.com/knowledge-base/integrations?hsLang=en)
- [Application Governance](https://support.appgovern.com/knowledge-base/application-governance?hsLang=en)
- [Access Certification](https://support.appgovern.com/knowledge-base/access-certification?hsLang=en)
- [Non-Human & AI Identity](https://support.appgovern.com/knowledge-base/non-human-ai-identity?hsLang=en)
- [Access Hub](https://support.appgovern.com/knowledge-base/access-hub?hsLang=en)
- [AI Workforce Governance](https://support.appgovern.com/knowledge-base/ai-workforce-governance?hsLang=en)
- [Settings](https://support.appgovern.com/knowledge-base/settings?hsLang=en)

- [Support home](https://support.appgovern.com/knowledge-base)
- [Contact us](https://www.appgovern.com/new/contact/)
- [AppGovern.com](https://www.appgovern.com/new/)
- [Trust Center](https://www.appgovern.com/new/why/trust-center/)
- [Privacy](https://www.appgovern.com/new/legal/privacy/)
- [Terms](https://www.appgovern.com/new/legal/terms/)

[![AppGovern](https://support.appgovern.com/hs-fs/hubfs/image50-c..jpeg?width=250&height=52&name=image50-c..jpeg "AppGovern")](https://www.appgovern.com/new/)

AppGovern is the Ownership-Driven Security platform. Find and manage every app and every identity: humans, AI agents, and service accounts. See what each one reaches. Have a named owner accept accountability for it.

Copyright © 2026, AppGovern Corp.