チュートリアル: アプリを Azure Active Directory に登録する

[アーティクル]
03/11/2022

このチュートリアルでは、Power Apps ユーザーアカウントを使用するユーザーが、OAuth 認証を使用して外部クライアントアプリケーションから Microsoft Dataverse 環境に接続できるアプリケーションを Azure Active Directory に登録する方法について説明します。

重要

また、Power Apps には、外部アプリケーションから、および特別なアプリケーションユーザーアカウントを使用するサービスからアプリ用 Dataverse 環境のインスタンスに接続するためのサーバー間 (S2S) 認証オプションも用意されています。 S2S 認証は、Microsoft AppSource に登録されたアプリがサブスクライバーのデータにアクセスする際に使用する一般的な方法です。詳細情報: サーバー間 (S2S) 認証を使用して Web アプリケーションを作成する。

Azure Active Directory へのアプリの登録は一般的に、外部クライアントアプリケーションの開発を希望する ISV が Dataverse でのデータの読み取りおよび書き込みを実行する際に行われます。 Azure Active Directory でのアプリケーションの登録では、ISV がクライアントアプリケーションの認証コードで使用できる アプリケーション ID および リダイレクト URI の値が提供されます。エンドユーザーが ISV のアプリケーションを使用して、自分たちの Dataverse 資格情報で Dataverse 環境に 初めて 接続するとき、同意フォームがエンドユーザーに表示されます。 ISV のアプリケーションで Dataverse アカウントの使用に同意した後、エンドユーザーは外部アプリケーションから Dataverse 環境に接続できます。同意フォームは、ISV のアプリケーションの使用に既に同意している最初のユーザー以外のユーザーには再度表示されません。 Azure Active Directory に登録されているアプリケーションはマルチテナント型です。それはつまり、他のテナントの他の Dataverse ユーザーが ISV アプリを使用してその環境に接続できることを意味しています。

アプリ登録も、Dataverse への接続およびそこでのデータの読み取り/書き込みを行うクライアントアプリケーションを作成しているアプリケーション開発者または個別のユーザーが実行することもできます。登録済みのアプリケーションからの アプリケーション ID および リダイレクト URI の値をクライアントアプリケーションの認証コードで使用して、クライアントアプリケーションからの Dataverse 環境に接続して必要な操作を実行できます。アプリケーションが Dataverse 環境と同じテナントに登録されている場合は、クライアントアプリケーションから Dataverse 環境に接続したとき、同意フォームが表示されないことに注意してください。

前提条件

アプリケーションの登録のための Azure サブスクリプション。試用アカウントも有効です。

アプリケーション登録の作成

管理者権限を持つアカウントを使用して Azure portal にサインインします。アプリの登録に使用するものと同じ Microsoft 365 サブスクリプション (テナント) のアカウントを使用する必要があります。 Microsoft 365 管理センターから Azure portal にアクセスするには、左側のナビゲーションウィンドウで 管理センター の項目を展開し、 Azure Active Directory を選択します。

注意

ユーザーが Azure テナント (アカウント) を持っていないか、または持っているが Dataverse の Microsoft 365 サブスクリプションが Azure サブスクリプションで利用できない場合は、トピック開発者サイトへの Azure Active Directory アクセスの設定の手順に従って、2 つのアカウントを関連付けます。

アカウントがない場合は、クレジットカードを使用して、アカウントにサインアップすることができます。ただし、アカウントはアプリケーション登録のため無料であり、このトピックで説明されている手順に従って 1 つ以上のアプリケーションを登録するだけでは、クレジットカードに請求はありません。詳細: Active Directory 価格設定詳細
Azure portal では、左側のウィンドウの Azure Active Directory を選択し、 アプリの登録 を選択し、 新規登録 をクリックします。
アプリケーションページの登録 にて、アプリケーションの登録情報を入力します:
- 名前セクションで、ユーザーに表示するわかりやすいアプリケーションの名前を入力します。
- 対応しているアカウントの種類 セクションで 組織ディレクトリ内のアカウント オプションを選択します。
- リダイレクト URI を設定します。
- 登録をクリックしてアプリケーションを作成します。
アプリケーションの認証コード、または app.config ファイルで必要に応じて指定するため、アプリの概要ページで アプリケーション (クライアント) ID 値の上にカーソルを移動し、クリップボードにコピー アイコンを選択して値をコピーします。
マニフェスト タブを選択し、マニフェストエディタで allowPublicClient プロパティーを true に設定して保存をクリックします。
API アクセス許可 タブを選択し、 アクセス許可の追加 をクリックします。
組織で使用している API タブ配下で Dataverse を選択します。"Dataverse" が見つからない場合、"Common Data Service" を検索してください。

ヒント

検索リストに複数の Common Data Service 項目が存在する場合、それらのいずれかを選択します。次のステップでは、サービス名と URL が表示されます。その時点で、API 検索に戻り、必要に応じて別の Dataverse リストアイテムを選択できます。
代理人のアクセス許可 をクリックし、オプションをチェックしてし、 アクセス許可の追加 をクリックします。

注意

ステップ 8 のフォームの将来の改訂により、Dynamics CRM のロゴとアイコンが Dataverse に置き換えられます。