> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowla.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra ID SSO setup

> Connect Flowla to Entra ID using OpenID Connect (OIDC) to enable Single Sign-On for your organization.

SSO lets your team log in to Flowla using their existing Microsoft credentials — no separate passwords, no extra accounts to manage. This guide is a simplified, Flowla-focused walkthrough derived from the [official Microsoft guide](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-oidc-sso#configure-oidc-sso-for-custom-non-gallery-applications), which you can refer to for full platform details.

### Prerequisites

* Microsoft Entra user account with one of the following roles: Cloud Application Administrator, Application Administrator, Owner of the service principal
* Admin access to your Flowla workspace

<Warning>
  User emails in Flowla must match user emails in Entra ID; otherwise authentication will fail.
</Warning>

***

<Steps>
  <Step title="Register your application">
    Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator. Browse to **Entra ID → App registrations → New registration**.

    Fill in the following:

    * **Name**: e.g. "Flowla SSO"
    * **Supported account types**: select the appropriate option for your organization
    * **Platform type**: Web
    * **Redirect URI**: `https://app.flowla.com/sso`

    Click **Register**.

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Register%20your%20application.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=15823edd071352ee081bd0dd1052239f" alt="Entra ID app registration page with Register action highlighted" width="2940" height="1662" data-path="product-images/entra-id-sso/Register your application.png" />
    </Frame>
  </Step>

  <Step title="Configure authentication settings">
    In your app registration, navigate to **Authentication**. Verify your redirect URIs are correctly configured under the **Web** platform — this enables the standard Authorization Code flow.

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Configure%20authentication%20settings.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=7a211ad6ceac14a2e3ad457c25b73ff3" alt="Entra ID Authentication page showing Web platform redirect URI configuration" width="2940" height="1662" data-path="product-images/entra-id-sso/Configure authentication settings.png" />
    </Frame>
  </Step>

  <Step title="Configure client credentials">
    Navigate to **Certificates & secrets** and select **New client secret**. Add a description, select an expiration period, then click **Add**.

    Copy the secret value immediately — it cannot be shown again.

    <Warning>
      Protect your Client Secret Value by keeping it confidential. Avoid sharing it in public repositories, forums, or unencrypted channels.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Configure%20client%20credentials.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=29d114e9ae5947ab33fe8b434172ec40" alt="Entra ID Certificates and secrets page for creating a new client secret" width="2940" height="1662" data-path="product-images/entra-id-sso/Configure client credentials.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Copy%20client%20secret%20value.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=9f83df5f8d4c41c2a94d53f5c33062a6" alt="Entra ID client secret value displayed after creation" width="2940" height="1662" data-path="product-images/entra-id-sso/Copy client secret value.png" />
    </Frame>
  </Step>

  <Step title="Configure API permissions">
    Navigate to **API permissions → Add a permission → Microsoft Graph → Delegated permissions**. Search for and add:

    * `openid` — required for OIDC authentication
    * `profile` — access to the user's basic profile information
    * `email` — access to the user's email address

    Click **Add permissions**.

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Configure%20API%20permissions.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=d3d04ce169eeb44f8d81346b1ff6ee23" alt="Entra ID API permissions screen with Microsoft Graph delegated permissions selected" width="2940" height="1662" data-path="product-images/entra-id-sso/Configure API permissions.png" />
    </Frame>
  </Step>

  <Step title="Gather application details">
    From the **Overview** page, note the following — you'll need these in the next step:

    * **Application (client) ID**: your app's unique identifier
    * **Directory (tenant) ID**: used to build your Identity Provider URL: `https://login.microsoftonline.com/{tenant}/v2.0/`
    * **Client Secret Value**: the value you copied in Step 3

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Gather%20application%20details.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=9ae84d2cf8f3680568a047ed9df6d7c5" alt="Entra ID overview page showing application and directory IDs" width="2940" height="1662" data-path="product-images/entra-id-sso/Gather application details.png" />
    </Frame>
  </Step>

  <Step title="Enable SSO in Flowla">
    In Flowla, go to **Settings → Security & Permissions** and click **Enable SSO**. Fill in the form with the values from Entra ID:

    <Frame>
      <img src="https://mintcdn.com/flowla/QkooP-2I8GNz6Pw7/product-images/entra-id-sso/Enable%20SSO%20in%20Flowla.png?fit=max&auto=format&n=QkooP-2I8GNz6Pw7&q=85&s=adfc07816f7e505ba97139c63b5257fb" alt="Flowla SSO setup form with identity provider URL, client ID, client secret, and email domain fields" width="2940" height="1662" data-path="product-images/entra-id-sso/Enable SSO in Flowla.png" />
    </Frame>

    <Steps>
      <Step title="Enter your Identity Provider URL">
        Paste `https://login.microsoftonline.com/{tenant}/v2.0/` (replace `{tenant}` with your Directory tenant ID)
      </Step>

      <Step title="Enter your Client ID">
        Paste the Application (client) ID
      </Step>

      <Step title="Enter your Client Secret">
        Paste the Client Secret Value (not the secret ID)
      </Step>

      <Step title="Set your email domain">
        Enter the email domain your organization uses (e.g. `yourcompany.com`). Users with this domain will be required to sign in via SSO.
      </Step>

      <Step title="Save and test">
        Click **Save** to activate SSO. Open a new browser session and verify you can sign in via Entra ID.
      </Step>
    </Steps>
  </Step>
</Steps>

<Card title="For more information, visit Microsoft Entra ID OIDC setup (non-gallery application)" href="https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal-setup-oidc-sso#configure-oidc-sso-for-custom-non-gallery-applications" cta="Read Microsoft docs">
  Official guide for configuring OIDC SSO for a custom non-gallery application.
</Card>
