Skip to main content

Overview

Configure Azure Active Directory (Microsoft Entra ID) as an OAuth provider for your env zero organization. This integration enables authentication through Microsoft Entra ID and supports automatic team syncing based on Azure AD groups.

Prerequisites

Edit Organization Settings permission is required to configure SSO.

Setup Steps

1

Register Application in Microsoft Entra ID

Register an application in the Microsoft identity platform. In platform settings, select Web and add a Redirect URI: https://login.app.env0.com/login/callback
2

Create Client Secret

Create a Client Secret and note the value. Copy the Application (client) ID and Client Secret Value for the next step.
3

Configure in env zero

Navigate to your organization settings > SSO tab. Click Azure AD and complete the self-service form with:
  • Application (client) ID
  • Client Secret Value
  • Email domain (e.g., env0.com) or Microsoft tenant domain (e.g., env0.onmicrosoft.com)
Multitenant Microsoft Entra IDIf you are in a Multitenant environment, under Authentication / Supported account types, select โ€œAccounts in any organizational directory (Any Azure AD directory - Multitenant)โ€.

Enabling Access

If users have trouble accessing the App Registration, grant admin consent:
1

Navigate to API Permissions

Go to Manage > API Permissions or Security > Permissions in your Azure AD application.
2

Grant Admin Consent

Click โ€œGrant Admin consent for env zeroโ€ for:
  • Microsoft Graph User.Read - Sign in and read user profile permissions
  • Microsoft Graph Directory.Read.All permissions
Azure AD API Permissions showing admin consent for Microsoft Graph permissions

Teams Syncing

Teams SyncingTeams are synced each time a user logs in:
  1. env zero creates a new team if one doesnโ€™t exist based on the group name from the OAuth provider.
  2. If the team exists in env zero, we will not create a new team.
  3. Users are assigned to all teams in env zero based on the group names they belong to in the OAuth provider.
  4. If a user is removed from a group in the OAuth provider, they are removed from the team in env zero.
Learn more: Sync Roles & Groups From Your IdP