Skip to main content

始める前に

Auth0 テナントが、Microsoft Azure AD connection type を使用して Azure AD に接続されていることを確認してください。この連携では、Azure AD に 2 つのアプリケーションを登録する必要があります。1 つは OpenID Connect 連携用、もう 1 つは SCIM 連携用です。お客様の設定作業をスムーズに進められるよう、Azure Active Directory app gallery にアプリを公開することも検討してください。
Auth0 は、ユーザー認証に Connect (OIDC) プロトコルを使用する Microsoft Azure AD connection type を通じて、Microsoft Azure Active Directory (現在の名称は Microsoft Entra ID) と連携できます。これらの手順は新しい Azure AD 接続向けです。ペアワイズユーザー識別子 (sub) を使用する古い接続については、Older Connections を参照してください。

​
Auth0 で SCIM 設定を構成する

  1. Auth0 Dashboard を開き、Authentication > Enterprise > Microsoft Azure AD > [your-connection] > Settings に移動します。
  2. User ID Attribute Type が User Object Identifier (oid) に設定され、Use Common Endpoint トグルが Disabled になっていることを確認します。
  3. Provisioning タブを選択し、ログイン時に追加属性を同期する必要がある場合を除き、Sync user profile attributes at each login を無効にします。
  4. 同じセクションで、Sync user profiles using SCIM を有効にします。
  5. Mapping タブで、SCIM attribute containing the User ID が externalId に設定されていることを確認します。
  6. Additional Mappings を確認し、拡張 SCIM 属性が使用したい Auth0 属性にマッピングされていることを確認します。詳しくは、属性マッピングを参照してください。

​
SCIM エンドポイント URL とトークンを取得する

このセクションでは を使用しますが、これらの手順は でも実行できます。推奨される方法については、デプロイ ガイドライン セクションを参照してください。
  1. Auth0 Dashboard で SCIM の Setup タブに移動し、SCIM Endpoint URL をコピーして安全な場所に保存します。
  2. Generate New Token をクリックして SCIM トークンを生成し、必要に応じてトークンの有効期限を設定します。
  3. 許可するスコープを選択します。Azure AD で必要なデフォルトのスコープは get:users、post:users、patch:users、delete:users です。必要に応じて、グループをプロビジョニングするために get:groups、post:groups、patch:groups、delete:groups も選択できます。

​
OIDCアプリ向けにAzure ADでSCIMを設定する

  1. Azure portal の Microsoft Entra ID > App registrations セクションで、ユーザー認証を処理する OpenID Connect アプリケーションがすでに登録されていることを確認します。
  2. Microsoft Entra ID > Enterprise applications > [your-oidc-app] > Manage > Properties セクションで、OpenID Connect アプリケーションの Assignment Required が Yes に設定されており、Users and Groups タブでユーザーが割り当てられていることを確認します。
  3. 次に、Azure portal で Microsoft Entra ID > Enterprise applications > New application > Create your own application の順に移動し、アプリケーション名を入力して Create を選択し、新しい Non-gallery アプリケーションを登録します。
  4. Users and Groups タブに移動し、登録済みの OpenID Connect アプリに割り当てられているものと同じ Azure AD のユーザーとグループを割り当てます。
  5. Provisioning タブを選択し、Get started を選択して、Provisioning Mode として Automatic を選びます。
  6. Admin Credentials を選択し、先ほど保存した SCIM Endpoint URL の値を Tenant URL として入力します。URL の末尾に ?aadOptscim062020 クエリパラメータを追加して、こちらで説明されている Azure AD の既知の問題に対応します。
  7. トークンの値を Secret Token フィールドに貼り付け、Save を選択します。
  8. Mappings に移動します。
  9. 必要に応じてグループをプロビジョニングするには、Provision Entra ID Groups が Enabled に設定されていることを確認します。不要な場合は、これを Disabled に設定します。
  10. Provision Microsoft Entra ID Users を選択し、Attribute Mappings に移動して、externalId と mailNickname を含む行の属性を編集します。
  11. Edit Attribute 画面で、Source attribute を objectId に変更し、OK を選択します。
  12. Attribute Mappings に戻り、emails[type eq "work"].value and mail を含む行を選択します。
  13. Edit Attribute 画面で、Match objects using this attribute を Yes に変更し、Matching precedence を 2 に設定して OK を選択します。追加の SCIM 属性を設定するために Attribute Mappings セクションを引き続き使用すると、属性マッピング画面は次のようになります。
SAML Azure 属性マッピング
属性マッピングを Save し、右上の X を選択して Provisioning 画面に戻ります。

​
テスト

  1. Enterprise アプリケーションの概要画面で、SCIM 接続をテストするには Manage > Provisioning > Provision on Demand に移動します。
  2. Select a user or group で、アプリケーションに割り当てたユーザーまたはグループの名前を入力し、該当する項目を選択して Provision をクリックします。これにより、Auth0 テナントにユーザーまたはグループが作成されます。
  3. 割り当てられたすべてのユーザーとグループをプロビジョニングするには、Provisioning Status を On に設定します。