Entra ID(Azure AD)でのサービスプリンシパルアプリの作成
Entra ID (Azure AD) でのサービスプリンシパルアプリの作成
Note:Microsoft はAzure AD をEntra ID にリブランドしました。ユーザーがEntra ID 管理サイトを操作する必要があるトピックでは、Microsoft が使用している名称と同じものを使用します。ただし、名前または値が"Azure AD" を参照しているCData 接続プロパティは、依然として存在します。
Azure サービスプリンシパルを使用して認証する場合は、カスタムAzureAD アプリケーションと必要なリソースにアクセスできるサービスプリンシパル両方の作成が必要です。
手順
以下のステップでは、ほとんどのサポート対象エディションのカスタムAzure AD サービスプリンシパルアプリケーションを作成し、Azure サービスプリンシパル認証の接続プロパティを取得した上で、Power Platform(Azure サービスプリンシパル)環境のアプリケーションユーザーを設定します。FinOps Online 用のカスタムAzure ADサービスプリンシパルアプリの作成方法については、以下のFinOps Online を参照してください。
カスタムAzure AD サービスプリンシパルアプリケーションの作成
- https://portal.azure.com にログインします。
- 左側のナビゲーションペインでAzure Active Directory -> 管理 -> アプリの登録を選択して、新規登録をクリックします。アプリの登録ページが表示されます。
- アプリケーション名を入力します。
- 新しいアプリケーションが、この組織ディレクトリのみに含まれるアカウントで使用できるように指定します。
- 登録をクリックします。ポータルには、新しいアプリケーションの概要ページが表示されます。
- 管理 -> アプリの登録に移動します。
- 「API のアクセス許可」ダイアログで、Dynamics CRM のアクセス許可を選択します。ポータルにDynamics CRM メニューが表示されます。
- 委任されたアクセス許可を選択し、User_impersonation を選択してアクセス許可の追加をクリックします。
- はいをクリックします。
- ポータルのPower Platform Service Principal セクションで、Certificates & secrets -> + New Client Secret をクリックします。ポータルに、クライアントシークレットの追加フォームが表示されます。
- クライアントシークレットの説明を入力し(通常、これはカスタムアプリケーションに付けた名前と同じです)、シークレットのExpires date を選択します。
- Add をクリックします。
- ポータルは、Secret ID(一意の識別子)とValue(パスワード)を生成します。これらは一度しか表示されないので、後で使用するために記録しておきます。(キーを紛失した場合は、シークレットを削除して新しいものを作成する必要があります。)
アプリケーションユーザーの作成
- https://admin.powerplatform.microsoft.com/home にログインします。
- 左側のナビゲーションパネルで、「環境」タブをクリックします。
- D365 環境を選択します。
- 設定 -> ユーザーとアクセス許可に移動します。
- アプリケーションユーザーを選択します。
- 新しいアプリユーザー -> アプリを追加をクリックします。
- 先ほど作成したカスタムサービスプリンシパルアプリケーションを選択します。
- システム管理者のセキュリティロールを追加します。
- 作成をクリックします。
- ビジネスユニットを割り当てます。
- 作成をクリックします。
FinOps Online の手順
Microsoft Dynamics 365 FinOps Online で使用するカスタムAzure AD サービスプリンシパルアプリケーションを作成するには、アプリケーションをMicrosoft Dynamics 365 に登録し、カスタムアプリケーション用のクライアントシークレットを生成して、アプリケーションを使用するために必要な権限を構成してから、Finance and Operations 用にアプリケーションを登録します。Note: Finance and Operations 用Microsoft Dynamics 365 の登録時に、実行する必要があるすべての必須権限を持つ専用のサービスアカウントを用意することをお勧めします。 該当するアカウントが存在しない場合は、以下の手順を開始する前にアカウントを作成してください。
Azure AD ポータルにアプリケーションを登録
- https://portal.azure.com にログインします。
- アプリケーションを登録するテナントに切り替えます。
- 左側のナビゲーションペインでAzure Active Directory -> アプリの登録を選択して、新規登録をクリックします。アプリの登録ページが表示されます。
- アプリケーション名を入力します。
- アカウントの種類は、任意の組織ディレクトリ内のアカウント(任意のAzure AD ディレクトリ - マルチテナント)を指定します。
- 残りのフィールドはデフォルト値のままにします。
- 登録をクリックします。ポータルには、新しいアプリケーションの概要ページが表示され、重要な項目が表示されます。
- アプリケーション(クライアント)ID の値を、今後の使用のために記録しておきます。
クライアントシークレットの生成
- Client credentials の隣にある、Add a certificate or secret をクリックします。ポータルに証明書とシークレットページが表示されます。
- 新しいクライアントシークレットをクリックします。ポータルに、クライアントシークレットの追加パネルが表示されます。
- シークレットの説明("App Connect secret" など)を指定し、有効期限を選択します。
- 追加をクリックします。
- ポータルはクライアントシークレットを生成し、証明書とシークレットページに表示します。
- シークレットは一度しか全文表示されないため、今後の使用のためにシークレットの値を記録しておきます。
必要なアクセス許可の設定
- 左のナビゲーションバーで、API のアクセス許可をクリックします。
- アクセス許可の追加 -> Dynamics ERP -> アプリケーションの許可に移動します。
- Connector.FullAccess を選択し、アクセス許可の追加をクリックして追加します。
- アクセス許可の追加 -> Dynamics ERP -> 委任されたアクセス許可に移動します。
- AX.FullAccess、CustomService.FullAccess、およびOData.FullAccess を選択し、アクセス許可の追加をクリックして追加します。
- 今追加したアクセス許可のいずれかが自身のドメインに付与されていない場合、yourdomain に管理者の同意を与えますをクリックします。 はいをクリックして確定します。すべてのアクセス許可のステータスが付与されましたに更新されます。
アプリケーションをMicrosoft Dynamics 365 Finance and Operations に登録
- Microsoft Dynamics 365 Finance and Operations アカウントを開きます。
- Modules -> System administration -> Setup -> Azure Active Directory applications に移動します。 ポータルにAzure Active Directory applications ページが表示されます。
- New をクリックします。
- Client Id フィールドに、Azure AD に登録したアプリケーション(クライアント)ID を入力します。
- Name フィールドに、カスタムアプリケーションの名前を入力します。
- User ID フィールドに、このセクションの冒頭で説明したとおり、適切なサービスアカウントユーザーID を選択します。
- Save をクリックします。