# エクイニクス連携SSOのためのMicrosoft Entra IDの設定 プロバイダ(IdP)とのサービス統合は、セキュリティの向上とユーザーアクセス管理の簡素化を実現するベストプラクティスとして確立されています。エクイニクスは[SAMLベースのシングルサインオン(SSO)](https://docs.equinix.com/ja/iam/federated-sso/ssf.md)をサポートしており、エクイニクスへのアクセス時に自社のIdPを通じてユーザーを認証できます。さらに、IDプラットフォームはSCIMベースのユーザープロビジョニングとデプロビジョニングをサポートしています。この機能により、IdPは認証だけでなく、エクイニクスのユーザーアカウントの自動作成と削除にも使用されます。 ユーザー管理を自動化することで、ユーザーエクスペリエンスの合理化、管理オーバーヘッドの削減、手作業によるエラーの減少、セキュリティポリシーの施行の改善など、いくつかのメリットが得られます。Microsoft Entra ID(旧Azure Active Directory)をSCIMプロトコルと組み合わせて使用することで、エクイニクスにおけるユーザーのプロビジョニングを自動化し、IDプロバイダー内のID管理を一元化できます。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") Equinix Federated [SSOサイト](https://federation.equinix.com)でSSOオンボーディングを完了してください。オンボーディングプロセスでは、手順で使用する統合URLとトークンが提供されます。 既存のEntra IDエンタープライズアプリケーションを使用してSAMLでエクイニクスにログインする場合、その固有ユーザー識別子として`user.mail`属性を使用する必要があります。 ## エンタープライズ・アプリケーションの作成[​](#エンタープライズアプリケーションの作成 "への直接リンクエンタープライズ・アプリケーションの作成") プロビジョナは、Entra ID \_Enterprise アプリケーションを使用して構成します。このアプリケーションを構成するには、Azure ポータルを開き、Microsoft Entra ID に移動します。**すべてのサービス** を展開します。**Add** を選択し、ドロップダウンから**Enterprise application** を選択します。 ![Add enterprise application](https://docs.equinix.com/ja/assets/images/add-enterprise-application-815484f7b53d1df14d4fac082a7ed0c0.png) ポータルにはアプリケーションギャラリーが表示されます。Equinix SCIMサービスは現在ベータ版であり、Equinix Federation Appギャラリーアプリケーションと統合されていないため、**Create your own application** を選択し、モーダルダイアログで**Non-gallery** を選択します。 Equinix SCIM」や「Equinix Provisioning」など、目的を示すアプリケーション名を入力してください。アプリケーションを作成するオプションを選択します。 ## シングルサインオン属性の設定[​](#シングルサインオン属性の設定 "への直接リンクシングルサインオン属性の設定") SAMLを使用してエクイニクスと統合するIDプロバイダは、ユーザーのメールアドレスをSAML NameIDの値として渡す必要があります。これはEntra IDの\_Manage\_ > \_Single Sign-On\_に移動し、\_Attributes & Claims\_セクションで**Edit** 。Unique User Identifier (Name ID)] フィールドを `user.mail` に設定し、\[Name identifier] の形式を電子メール・アドレスにします。 ![SAML nameid mapping](https://docs.equinix.com/ja/assets/images/saml-manage-claim-5e8f34b1b1557c1b29946fb4cfe8c40a.png) シングルサインオン・パネルの「Attributes & Claims(属性と請求)」セクションは、以下の例と一致している必要があります。 ![SAML attributes](https://docs.equinix.com/ja/assets/images/saml-attributes-1219a6c7749705828b2ad9e68c8e2262.png) ### NameIDが小文字で送信されていることを確認してください。[​](#nameidが小文字で送信されていることを確認してください "への直接リンクNameIDが小文字で送信されていることを確認してください。") プロビジョニングと認証の問題を防ぐため、NameIDとして使用されるSAMLアサーション属性が小文字形式であることを確認してください。エクイニクスは、SAML認証とSCIMプロビジョニングにおいてユーザー識別子の大文字と小文字を区別します。同じ識別子が異なる大文字と小文字(`User@Example.com`と`user@example.com`など)で送信されると、アカウントの重複、ログインの失敗、同期エラーの原因となります。このような問題を回避するには、一意のユーザー識別子(Name ID)を小文字に正規化してから送信するようにしてください。 1. Entra IDアプリケーションで、\_Single sign-on\_と\_Attributes & Claims\_を選択します。 2. 必要なクレーム\_]で、\[固有のユーザー識別子(ネームID)\_]を選択します。 3. Manage claimで\_Source\_の下にある\_Transformation\_を選択し、変換を小文字の値に設定し、クレームを保存します。 ![Selecting the Unique User Identifier (Name ID) claim in Entra ID](https://docs.equinix.com/ja/assets/images/entra1-438647f3ccb4fdcccf66c689b25cec59.png) ![Configuring a lowercase transformation for the Unique User Identifier (Name ID) claim in Entra ID](https://docs.equinix.com/ja/assets/images/entra2-79932766af4c6fbc9a3ac5184d75c7fd.png) ## プロビジョニングを有効にする[​](#プロビジョニングを有効にする "への直接リンクプロビジョニングを有効にする") アプリケーションを作成すると、ナビゲーションサイドバーにいくつかのオプションが用意された "Overview "ページが表示されます。管理\_」ドロップダウンを展開し、「プロビジョニング\_」を選択して、「開始\_」を選択します。 ![App overview](https://docs.equinix.com/ja/assets/images/app-overview-bbe01b52047166b2894e85eecca43a98.png) プロビジョニングモードのプロンプトが表示されたら、デフォルト値をManualからAutomaticに変更します。 管理者資格情報パネルを展開し、federation.equinix.comから提供されたURLとトークンを入力します。Test Connection]を使用して、Entra IDとEquinix間の接続が正しく設定されていることを確認します。オプションとして、同じページの[Settings]パネルを展開して、プロビジョニングの問題に対するEメールアラートを設定したり、[Entra IDの誤削除防止]([https://learn.microsoft.com/en-us/entra/identity/app-provisioning/accidental-deletions?pivots=app-provisioning)を有効にしたりします。設定を保存して、アプリケーションの概要ページに戻ります。](https://learn.microsoft.com/en-us/entra/identity/app-provisioning/accidental-deletions?pivots=app-provisioning\)%E3%82%92%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%97%E3%81%9F%E3%82%8A%E3%81%97%E3%81%BE%E3%81%99%E3%80%82%E8%A8%AD%E5%AE%9A%E3%82%92%E4%BF%9D%E5%AD%98%E3%81%97%E3%81%A6%E3%80%81%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E6%A6%82%E8%A6%81%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AB%E6%88%BB%E3%82%8A%E3%81%BE%E3%81%99%E3%80%82) ![Provisioning config](https://docs.equinix.com/ja/assets/images/provisioning-config-b01ca343f8ff3bb6383857f860e66bc3.png) ## 属性マッピングの設定[​](#属性マッピングの設定 "への直接リンク属性マッピングの設定") サイドバーで、**管理** を選択し、**プロビジョニング** を選択します。マッピングパネルが表示されます。**Provision Microsoft Entra ID Groups** を開き、[Enabled(有効)]トグルをオフにして、設定を保存します。**Provision Microsoft Entra ID Users** を開き、図のようにマッピングを構成します: | **Custom App Attribute** | **Microsoft Entra ID Attribute** | **Matching precedence** | | ----------------------------------- | ------------------------------------------------------------ | ----------------------- | | userName | mail | 1 | | active | Switch(\[IsSoftDeleted], , "False", "True", "True", "False") | | | displayName | displayName | | | externalId | mailNickname | | | name.familyName | surname | | | name.givenName | givenName | | | phoneNumbers\[type eq "work"].value | telephoneNumber (or 'mobile', depending on your environment) | | | locale | preferredLanguage | | 追加のデフォルトマッピングは削除すべきである。 ![Attribute mappings](https://docs.equinix.com/ja/assets/images/attribute-mappings-06cd062d779a57d081a1e09bf46e9155.png) **作成** 、**更新** 、**削除** のいずれかを選択しないでください。たとえば、自動的にデプロビジョニングせずにユーザーをプロビジョニングする場合などです。変更を保存します。 接続が確立され、属性マッピングが構成されたら、*Manage* > \_Provisioning\_に戻り、\_Provisioning Status\_をOnに設定します。 ## プロビジョニングのためのユーザーとグループの追加[​](#プロビジョニングのためのユーザーとグループの追加 "への直接リンクプロビジョニングのためのユーザーとグループの追加") すべてのディレクトリユーザーが高度なアプリケーション設定で同期するように構成されていない限り、エクイニクスでプロビジョニングを行う前に、ユーザーをアプリケーションに割り当てる必要があります。この割り当ては、\_管理 > \_ユーザーとグループ\_で行います。ユーザーは、個別に割り当てることも、グループ単位で割り当てることもできます(Azureサブスクリプションの階層によって異なります)。 ![User assignment](https://docs.equinix.com/ja/assets/images/user-assignment-f69f7c0702361e98b69dd529dc6bf987.png) ## プロビジョニングの成功の確認[​](#プロビジョニングの成功の確認 "への直接リンクプロビジョニングの成功の確認") この時点で、Equinixでのユーザーのプロビジョニングとデプロビジョニングに必要なEntra IDの設定が完了しました。概要ページに戻ります。しばらくすると、Entra IDは割り当てられたユーザーのプロビジョニングを試みます。最初のプロビジョニングサイクル中にログを確認し、プロセスが期待どおりに完了したことを確認してください。 ![User provisioned](https://docs.equinix.com/ja/assets/images/provisioned-a4d821f293cddfb5fb7b51731dc5b13a.png) Entra ID does not synchronize users immediately but runs as a periodic job (every 20-40 minutes, depending on the number of users and groups in the application, according to Microsoft). This interval is not configurable by Equinix. スケジュールされた間隔外でプロビジョニングを実行したり、変更をすぐに適用したりするには、アプリケーションの概要ページから Entra ID の Provision on demand 機能を使用します。オンデマンドプロビジョニングは、選択したユーザーに対してプロビジョニングまたはデプロビジョニングアクションを実行し、実行されたアクションとその結果の詳細を提供します。 ![Provision on demand](https://docs.equinix.com/ja/assets/images/provision-on-demand-26b2d34cd108daa50401a3a2faaec790.png)