# エクイニクス連携SSOのためのOktaの設定 プロバイダ(IdP)とのサービス統合は、セキュリティの向上とユーザーアクセス管理の簡素化を実現するベストプラクティスとして確立されています。エクイニクスは[SAMLベースのシングルサインオン(SSO)](https://docs.equinix.com/ja/iam/federated-sso/ssf.md)をサポートしており、エクイニクスへのアクセス時に自社のIdPを通じてユーザーを認証できます。さらに、IDプラットフォームはSCIMベースのユーザープロビジョニングとデプロビジョニングをサポートしています。この機能により、IdPは認証だけでなく、エクイニクスのユーザーアカウントの自動作成と削除にも使用されます。 ユーザー管理を自動化することで、ユーザーエクスペリエンスの合理化、管理オーバーヘッドの削減、手作業によるミスの減少、セキュリティポリシーの強化など、さまざまなメリットが得られます。OktaとSCIMプロトコルを使用することで、エクイニクスのユーザープロビジョニングを自動化し、IDプロバイダ内のID管理を一元化できます。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") Equinix Federated [SSOサイト](https://federation.equinix.com)でSSOオンボーディングを完了してください。オンボーディングプロセスでは、手順で使用する統合URLとトークンが提供されます。 ## アプリケーションの作成[​](#アプリケーションの作成 "への直接リンクアプリケーションの作成") プロビジョナーは、Okta アプリケーションを使用して設定します。これを構成するには、Okta 管理コンソールを開き、サイドバーで**アプリケーション** を選択します。**Browse App Catalog** を選択します。Governance with SCIM\_ を検索し、*(OAuth Bearer Token) Governance with SCIM 2.0* を選択し、**Add Integration** を選択します。 Equinix」や「Equinix Provisioning」など、目的を識別できるアプリケーション名をプロバイダに入力してください。サインオンオプション\_」では、アプリケーションがログインフローにも使用される場合、このSCIMアプリケーションのSAMLフィールドを設定できます。資格情報の詳細]の[アプリケーションユーザー名形式]は、[Email]に設定する必要があります(エクイニクスへのSAML SSOに別のOktaアプリケーションを使用する場合は、そのアプリケーションも[Email]に設定する必要があります)。**Done** を選択してアプリケーションを作成します。 ![Credentials details](https://docs.equinix.com/ja/assets/images/credentials-details-c4ce2b2bb82bdf3248a3092472204ae8.png) ### NameIDが小文字で送信されていることを確認してください。[​](#nameidが小文字で送信されていることを確認してください "への直接リンクNameIDが小文字で送信されていることを確認してください。") プロビジョニングと認証の問題を防ぐため、NameIDとして使用されるSAMLアサーション属性が小文字形式であることを確認してください。エクイニクスは、SAML認証とSCIMプロビジョニングにおいてユーザー識別子の大文字と小文字を区別します。同じ識別子が異なる大文字と小文字(`User@Example.com`と`user@example.com`など)で送信されると、アカウントの重複、ログインの失敗、同期エラーの原因となります。このような問題を回避するには、一意のユーザー識別子(Name ID)を小文字に正規化してから送信するようにしてください。 1. Okta Admin Consoleで、\_Applications\_に移動します。 2. SAML Settings\_ セクションで、**Edit** をクリックして、SAML を設定します。 3. Application username\_を\_Custom\_に設定し、小文字の式を入力します。 ![Configuring Application username to Custom in Okta SAML Settings](https://docs.equinix.com/ja/assets/images/Okta1-e069759285f43fd72e0823b79d32f3e3.png) ![Entering a lowercase expression for the Application username in Okta SAML Settings](https://docs.equinix.com/ja/assets/images/Okta2-898522e93fab6f3c65582ce5e9d20f8c.png) ## プロビジョニングの設定[​](#プロビジョニングの設定 "への直接リンクプロビジョニングの設定") アプリケーションが作成されると、アプリケーションの管理パネルが表示されます。Provisioning セクションバーを開き、**Configure API Integration** を選択します。federation.equinix.comから提供されたURLとトークンを入力し、認証情報をテストします。変更を保存します。 > **メモ** > > エクイニクスのグループをOktaに反映するには、[[グループのインポートオプション](https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-import-groups-app-provisioning.htm)を有効にしてください。 ![Credentials verified](https://docs.equinix.com/ja/assets/images/credentials-verified-600b2ece57bf24bf7a191ae9f60fcffc.png) ## プロビジョニングを有効にする[​](#プロビジョニングを有効にする "への直接リンクプロビジョニングを有効にする") 認証情報が構成されたら、*Provisioning* タブに戻り、**To App** を選択します。**Edit** を選択し、チェックボックスを有効にします。Create Users(ユーザの作成)]、\[Update User Attributes(ユーザ属性の更新)]、および \[Deactivate Users(ユーザの停止)]を有効にします。デフォルトのユーザー名がEmailに設定されていることを確認します。 ![Enable provisioning](https://docs.equinix.com/ja/assets/images/enable-provisioning-c7b1a827a629949670d29ae338d6bb12.png) ## 属性マッピングの設定[​](#属性マッピングの設定 "への直接リンク属性マッピングの設定") **To App** ] セクションで、Okta属性とEquinixユーザー属性のマッピングを設定します。図のようにマッピングを設定します: | **Attribute** | **Attribute Type** | **Value** | **Apply on** | | ---------------- | ------------------ | -------------------------------- | ----------------- | | userName | Personal | *Configured in Sign On settings* | | | givenName | Personal | user.firstName | Create and Update | | familyName | Personal | user.lastName | Create and Update | | displayName | Personal | user.displayName | Create and Update | | primaryPhone | Personal | user.primaryPhone | Create and Update | | primaryPhoneType | Personal | "work" | Create and Update | | locale | Group | user.locale | Create and Update | primaryPhoneType`は、"Same value for all users "を選択することで、`work\`に設定されます。 追加のデフォルトマッピングは削除するか、マッピングを解除すべきである。 ![Attribute mappings](https://docs.equinix.com/ja/assets/images/attribute-mappings-e41c2546b75712410f17783bfa618181.png) ## プロビジョニング用のユーザーとグループの追加[​](#プロビジョニング用のユーザーとグループの追加 "への直接リンクプロビジョニング用のユーザーとグループの追加") ユーザーをアプリケーションに個別またはグループ別に割り当てます。Assignments\_タブを開き、**Assign** を選択してユーザーを追加します。Oktaが自動的にエクイニクスにユーザーを割り当てます。 ![User assignment](https://docs.equinix.com/ja/assets/images/user-assignment-1f67c28b490d923d2c173c49306f0d9b.png) ## プロビジョニングの成功の確認[​](#プロビジョニングの成功の確認 "への直接リンクプロビジョニングの成功の確認") この時点で、OktaはEquinixでのユーザーのプロビジョニングとデプロビジョニングに必要な設定を完了しています。ヘッダーのアプリケーション名の横にある「**View Logs** 」を選択するか、「*Reports* > *System Log*」に移動してプロビジョニングイベントを確認してください。最初のプロビジョニングサイクルを監視し、接続が期待どおりに機能していることを確認します。 ![Provisioned](https://docs.equinix.com/ja/assets/images/provisioned-708f25ccfb4894d4e34b09f798efa887.png)