Authorization setup: Microsoft Entra ID

FoundationaLLM comes with out-of-the-box support for Microsoft Entra ID authorization. This means that you can use your Microsoft Entra ID to setup authorization access to FoundationaLLM's platform.

Create the API application

Register the API application in the Microsoft Entra ID admin center

  1. Sign in to the Microsoft Entra ID admin center as at least a Cloud Application Administrator.

  2. Browse to Identity > Applications > App registrations.

    The app registrations menu item in the left-hand menu is highlighted.

  3. On the page that appears, select + New registration.

  4. When the Register an application page appears, enter the name FoundationaLLM-Authorization-API for your application.

  5. Under Supported account types, select Accounts in this organizational directory only.

  6. Select Register.

  7. The application's Overview pane displays upon successful registration. Record the Application (client) ID and Directory (tenant) ID to add to your App Configuration settings later.

    The Entra app client ID and Directory ID values are highlighted in the Overview blade.

Expose an API for the API application

  1. Under Manage, select Expose an API > Add a scope. For Application ID URI, enter api://FoundationaLLM-Authorization, then select Save and continue, and then enter the following details:

    • Scope name: Authorization.Manage
    • Who can consent?: Admins and users
    • Admin consent display name: Manage Authorization
    • Admin consent description: Allows the app to manage data on behalf of the signed-in user.
    • User consent display name: Manage data on behalf of the user
    • User consent description: Allows the app to manage data on behalf of the signed-in user.
    • State: Enabled
  2. Select Add scope to complete the scope addition.

    The Add a scope form is displayed as described in the bulleted list above.

  3. Copy the Scope name value to add to your App Configuration settings later. It should look like api://FoundationaLLM-Authorization/Authorization.Manage.

    The new scope name is displayed with the Copy button highlighted.

Update the client application manifest

  1. Under Manage, select Manifest.

  2. Locate the accessTokenAcceptedVersion property and set its value to 2.

    The accessTokenAcceptedVersion property is highlighted.

  3. Select Save at the top of the page to save the changes.

Configure Authentication Flows

  1. Navigate to the Authentication tab. Select Add a platform. On the Configure platforms pane, select Web.

    Create a new Web application platform.

  2. Enter http://localhost under Redirect URIs. Then, below Implicit grant and hybrid flows, select both Access tokens and ID tokens. Finally, select Configure.

    Select "Access Tokens" and "ID Tokens".