はじめに

Auth0では、Auth0自体のユーザデータベースだけではなく、外部のIdPで管理されているユーザアカウントを利用して、Auth0連携アプリケーションへログインできます。既存のIdPに登録済のユーザアカウント情報を継続して利用でき、最小限の対応作業でAuth0への認証統合を実現できます。
Auth0における外部IdP連携では、Enterprise Connection機能を利用します。本ページでは、外部IdPとしてAzure Active Directory(以下、Azure AD)を対象とし、必要となる設定と実際のログイン動作をご紹介します。

Auth0がサポート対応する外部IdP

Auth0がサポート対応している外部IdPは、以下より確認できます。Okta Workforce Identity、Azure AD等、主要なIdPに対応しています。
https://auth0.com/docs/authenticate/identity-providers/enterprise-identity-providers

前提

本ページ内の設定及び動作例では、以下が準備済の状態を前提とします。

• Auth0連携済のWebアプリケーション
• Azure ADテナント作成

Auth0によるログイン画面機能については、New Universal Loginを利用します。
※後述のConnection Button設定はClassic版非対応

また、本ページに記載する機能及び設定に関する内容は、2022年11月現在の情報となります。

設定概要

設定例

2.　Azure AD設定

※Azure AD側の設定の詳細については、Microsoft社の下記ページをご確認ください。

https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app

• Azureポータル画面において、[追加] > [アプリの登録]をクリック

• アプリケーションの登録において各項目を設定後、[登録]をクリック

• 名前：任意の設定名
• サポートされているアカウントの種類：アクセス範囲の指定
• リダイレクトURL：https://(Auth0テナントドメイン名)/login/callback

• 登録されたアプリケーションのアプリケーション(クライアント)IDをコピー(３．Auth0設定で利用)

• 左側メニューから[証明書とシークレット]を選択し、[新しいクライアント シークレット]をクリック

• 任意の説明と有効期限を指定し、[追加]をクリック

• 発行されたクライアントシークレットの値をコピー(3．Auth0設定にて利用)

3.　Auth0設定

• Auth0管理画面で、[Authentication] > [Enterprise]をクリック

• [Microsoft Azure AD]をクリック

• [Create Connection]をクリック

• 各項目を設定後、ページ末尾の[Create]をクリック

• Connection name：任意の設定名
• Microsoft Azure AD Domain：連携対象とするAzure ADのドメイン（ホーム > Azure Active Directoryより確認可能）
• Client ID：Azure ADアプリケーションのアプリケーション(クライアント)ID
• Client Secret：Azure ADアプリケーションのクライアントシークレット値
• Use common endpoint：無効
• Identity API：Microsoft Identity Platform (v2)
• Extended Attributes：選択なし
• Auth0 APIs：選択なし
• Sync user profile attributes at each login：有効
• Email Verification：Always set email_verified to 'false'

• Login ExperienceタブにてConnection Button設定を実施し、ページ末尾の[Save]をクリック

• Display connection as a button：チェック(ログイン画面上にAzure ADによるログインボタンを表示)
• Button display name：ボタン表示名称を指定

• 連携するApplication設定にて、作成したEnterprise Connection設定を有効化

ログイン時の動作例：Azure ADに登録済のユーザによるログイン

• Auth0連携済のWebアプリケーション画面においてログイン操作を行い、Auth0が提供するログイン画面に遷移
• [Azure ADで続ける]ボタンが表示されていることを確認し、[Azure ADで続ける]ボタンをクリック

3.　Azure AD側の認証画面に遷移後、Azure AD上のユーザ情報を入力

4.　許可を求めるメッセージ表示において、[承諾]をクリック

5.　WebアプリケーションにAzure AD上のユーザでログインできたことを確認

6.　Auth0管理画面において、当該ユーザ情報を確認

まとめ

Auth0では、Enterprise Connection機能を利用することで、外部IdPを用いた認証処理を簡単に実現できます。無償のAuth0トライアル環境においてもEnterprise Connection機能をお試しいただけますので、ぜひ実感してください。
既存のIdPを活用したAuth0への認証統合についてご興味がある方は、是非弊社までお問い合わせください。

参考

• Enterprise Identity Providers - Auth0 docs
• Connect Your App to Microsoft Azure Active Directory - Auth0 docs
• Quickstart: Register an application with the Microsoft identity platform