Gebo.ai setup guide · Security · Page 24b

Microsoft accounts

People sign in to Gebo.ai with a personal Microsoft account (Outlook.com, Hotmail, Live) or with the work account of the organizations you list. One application in Entra, one configuration in Setup.

Time
15 minutes, plus the tenant ID of each organization to admit.
You need
A Microsoft Entra tenant where you can register applications, and Gebo.ai open at the address your users use.

1Register Gebo.ai in Entra

  1. In the Microsoft Entra admin center open App registrations and click New registration.
  2. Name it Gebo.ai and, under Supported account types, choose the option for accounts in any organizational directory and personal Microsoft accounts. Click Register. The redirect address comes later.
  3. On the Overview copy the Application (client) ID.
  4. In Certificates & secrets click New client secret and copy its Value at once: Entra shows it only now.
Only your own organization?If only the people of your organization sign in, page 24 is the simpler choice: its application admits your tenant alone.

2Open the single sign-on settings

In Setup open Security (1) and click Single signon, oauth2 authentication (2), then + Oauth2 config.

The Security tab of Setup.
The Security tab of Setup.

3Enter the application

A new configuration for Microsoft accounts, admitting personal accounts and one organization. The secret is still to be entered.
A new configuration for Microsoft accounts, admitting personal accounts and one organization. The secret is still to be entered.
  1. Description: the name on the login button, for example Microsoft account.
  2. Provider: Microsoft accounts auth provider (personal accounts and the organizations you list).
  3. Configuration purpose: Authentication.
  4. Accepted audiences: only for tools that call the Gebo.ai API with tokens of this provider (page 28b). Enter the Client ID of item 5 to accept only tokens meant for Gebo.ai; empty, any token this provider signed is accepted. Signing in with the button does not depend on it.
  5. Client ID: the identifier the provider gave Gebo.ai.
  6. Secret key: the client secret the provider gave Gebo.ai.
  7. allowedTenants: who may sign in, separated by commas: consumers for personal Microsoft accounts, and the Tenant ID of each organization to admit. For example consumers, aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.
  8. Click Save.

Each organization finds its Tenant ID on the Overview of its Microsoft Entra admin center. The list applies from the next sign-in: to add or remove an organization, Modify the configuration.

Admit only organizations you trustGebo.ai recognizes people by their e-mail address, and the administrators of an organization decide the addresses of its people. Admit an organization only if you trust its administrators.

4Give the provider the redirect address

Save closes the dialog. Click Modify next to the new configuration: Gebo.ai has given it a Code (2) and lists the addresses to enable at the provider. The redirect address to register is the one ending in /login/oauth2/code/ followed by the code (1).

The saved configuration: its redirect address (1) and its code (2).
The saved configuration: its redirect address (1) and its code (2).

In Entra open the application, Authentication → Add a platform → Web, paste the address as Redirect URI and click Configure.

Open Gebo.ai at its real address firstThe addresses are built from the address your browser has Gebo.ai open at. Open Gebo.ai at the address your users use, for example https://gebo.company.com, before copying it: an address with localhost works only on the server itself.

5Let people in

The login page now shows a button with the Description of the configuration.

The Microsoft account button on the login page.
The Microsoft account button on the login page.

By default Gebo.ai lets in the people an administrator has created: for each of them create a user whose Username is the e-mail address of their Microsoft account and whose Authentication provider is this provider, as described in page 29. To make every person the provider recognizes a user on their own, see page 28b.

6If someone cannot get in

  • A person of an organization missing from allowedTenants is refused, and so is a personal account when consumers is missing.
  • Gebo.ai recognizes people by the e-mail address Microsoft sends: make sure each work account has one (the Email of the user in Entra).
  • If Microsoft asks a person of an organization for a consent they cannot give, an administrator of that organization has to grant it.