################################ Azure Active Directory の設定 ################################ Sitecore は Active Directory を利用したシングルサインオンの連携を標準で利用することできるようになっています。ここでは、その手順に関して紹介をしています。 ****************************** Azure Active Directory の準備 ****************************** ここでは検証用の Active Directory を Microsoft Azure 上で準備します。なお、テスト・検証用程度で利用するのであれば無料で利用することが可能です。 * `Azure Portal `_ へアクセス、ログインします * 左側のメニューから「リソースの作成」を選択 * Azure Marketplace の ID をクリック * Azure Active Directory の項目を選択します .. image:: images/aad01.png :align: center :width: 400px :alt: Azure Active Directory" /> * `組織名` と `初期ドメイン名` を選択します。初期ドメイン名に関しては `onmicrosoft.com` のドメインが設定される形となりますが、あとで独自ドメインを設定することも可能です。 .. image:: images/aad02.png :align: center :width: 400px :alt: ディレクトリの作成 .. image:: images/aad03.png :align: center :width: 400px :alt: 作成中 * 数分で Azure Active Directory が作成されます ****************************** アプリの登録（AD の設定） ****************************** 作成した AD のポータルに移動します。ウィンドウの右側に表示されている「作成」エリアにある「アプリの登録」をクリックします。 .. image:: images/azure01.png :align: center :width: 400px :alt: アプリケーションの登録 アプリケーションの登録では、`アプリケーション名`を入力、`シングルテナント`を選択します。リダイレクト URI には Sitecore Identity Server のドメイン名に対して、 `/signin-oidc` 追加した URI を設定します。 .. image:: images/azure02.png :align: center :width: 400px :alt: 情報の入力 作成したアプリについて、管理「認証」を開いて、ID トークンの項目をチェックします。 .. image:: images/azure03.png :align: center :width: 400px :alt: ID トークンをオン 管理「マニフェスト」をチェックして、表示される JSON のデータに関して、groupmembershipClaims の項目が最初は空欄になっていますが、ここに `SecurityGroup` を追加してください。 .. image:: images/azure04.png :align: center :width: 400px :alt: マニフェスト 概要を選択して、以下の２つの項目が表示されているのを確認してください。 * アプリケーション（クライアント）ID * ディレクトリ（テナント）ID .. image:: images/azure05.png :align: center :width: 400px :alt: パラメータの確認 ****************************** Sitecore の設定 ****************************** 続いて Sitecore の設定を進めていきます。まず、Sitecore Identity Server の設定ファイル、 `\sitecore\Sitecore.Plugin.IdentityProvider.AzureAd\Config` のフォルダの中にある `Sitecore.Plugin.IdentityProvider.AzureAd.xml` を編集します。 .. image:: images/azure06.png :align: center :width: 400px :alt: 設定ファイルの確認 このファイルの項目のうち、Settings : Sitecore : ExternalIdentityProviders : IdentityProviders : AzureAd にある3つの項目を変更してください。ID に関しては Azure AD の概要の項目になります。 ========= ==================================== 設定項目 設定する値 ========= ==================================== Enabled True ClientId アプリケーション（クライアント）ID TenantId ディレクトリ（テナント）ID ========= ==================================== .. code-block:: xml IdS4-AzureAd Azure AD true {Place ClientID here} {Place TenantID here} .. image:: images/azure07.png :align: center :width: 400px :alt: 設定ファイルの確認 これで設定が完了となります。Sitecore Identity Server を再起動すると、ログイン画面が変わります。 .. image:: images/azure10.png :align: center :width: 400px :alt: Azure AD のボタンが表示される ****************************** ログインの検証 ****************************** Azure AD にログインできるユーザーを作成します。メニューの「管理」－「ユーザー」をクリックして、メニューに表示される「新しいユーザー」をクリックして作成をします。 続いて、現在管理画面を開いているブラウザとは別のブラウザ、もしくはプライベートモードで別のウィンドウを開いてください。この手順を実施する理由としては、AD 管理画面に入っている場合、マイクロソフトアカウントとしてログインをしている状態となるためテストができないためです。 新しく開いたブラウザでログイン画面を開き「Azure AD」のボタンをクリックしてください。 .. image:: images/azure11.png :align: center :width: 400px :alt: ログイン画面 作成をしたアカウントでログインを進めていきます。ログインの手続きが終わった段階で、以下のようなエラーが出ればシングルサインオン自体は成功しています。 .. image:: images/azure12.png :align: center :width: 400px :alt: エラー画面 ****************************** ロールのマッピング ****************************** Sitecore のロールと AD のグループを紐づけることで、シングルサインオンをした後、使うことができる権限を設定することができます。 まず Active Directory にグループを作成します。今回は、SitecoreAuthor というグループを作成しました。 .. image:: images/azure13.png :align: center :width: 400px :alt: グループの作成 作成したグループにユーザーを追加します。 .. image:: images/azure14.png :align: center :width: 400px :alt: ユーザーの追加 続いてグループの「概要」を開いて、オブジェクト ID を確認します。 .. image:: images/azure15.png :align: center :width: 400px :alt: オブジェクト ID の確認 このオブジェクト ID を Sitecore Identity Server の設定に反映をさせます。反映させるファイルは、`\sitecore\Sitecore.Plugin.IdentityProvider.AzureAd\Config` のフォルダにある `Sitecore.Plugin.IdentityProvider.AzureAd.xml` です。 取得したオブジェクト ID を 以下のように `Claim1 type="groups"` の value に反映させます。 .. code-block:: xml この設定の場合は、Sitecore のロールとして `Sitecore\Author` に反映させる設定になっています。 この状態でログインをすると、AD を利用してログインをすることが可能となります。 .. image:: images/azure16.png :align: center :width: 400px :alt: ログインに成功