3.8 KiB
stage | group | info |
---|---|---|
Create | Ecosystem | To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments |
Microsoft Azure OAuth2 OmniAuth Provider
NOTE: Per Microsoft, this provider uses the older Azure Active Directory v1.0 endpoint. Microsoft documentation suggests that you should use the OpenID Connect protocol to use the v2 endpoints for new projects.
To enable the Microsoft Azure OAuth2 OmniAuth provider, you must register your application with Azure. Azure generates a client ID and secret key for you to use.
Sign in to the Azure Portal, and follow the instructions in the Microsoft Quickstart documentation.
As you go through the Microsoft procedure, keep the following in mind:
- If you have multiple instances of Azure Active Directory, you can switch to the desired tenant.
- You're setting up a Web application.
- The redirect URI requires the URL of the Azure OAuth callback of your GitLab
installation. For example,
https://gitlab.mycompany.com/users/auth/azure_oauth2/callback
. The type dropdown should be set to Web. - The
client ID
andclient secret
are terms associated with OAuth 2. In some Microsoft documentation, the terms may be listed asApplication ID
andApplication Secret
. - If you need to generate a new client secret, follow the Microsoft documentation for creating a new application secret.
- Save the client ID and client secret for your new app, as the client secret is only displayed one time.
-
On your GitLab server, open the configuration file.
For Omnibus GitLab:
sudo editor /etc/gitlab/gitlab.rb
For installations from source:
cd /home/git/gitlab sudo -u git -H editor config/gitlab.yml
-
Refer to Initial OmniAuth Configuration for initial settings.
-
Add the provider configuration:
For Omnibus GitLab:
gitlab_rails['omniauth_providers'] = [ { "name" => "azure_oauth2", "args" => { "client_id" => "CLIENT ID", "client_secret" => "CLIENT SECRET", "tenant_id" => "TENANT ID", } } ]
For installations from source:
- { name: 'azure_oauth2', args: { client_id: "CLIENT ID", client_secret: "CLIENT SECRET", tenant_id: "TENANT ID" } }
The
base_azure_url
is optional and can be added for different locales; such asbase_azure_url: "https://login.microsoftonline.de"
. -
Replace
CLIENT ID
,CLIENT SECRET
andTENANT ID
with the values you got above. -
Save the configuration file.
-
Reconfigure or restart GitLab, depending on your installation method:
- If you installed from Omnibus GitLab, reconfigure GitLab.
- If you installed from source, restart GitLab.
On the sign-in page, you should now see a Microsoft icon below the regular sign-in form. Click the icon to begin the authentication process. Microsoft then asks you to sign in and authorize the GitLab application. If successful, you are returned to GitLab and signed in.
Read Enable OmniAuth for an Existing User for information on how existing GitLab users can connect to their newly-available Azure AD accounts.