Postman 環境の設定

[アーティクル]
05/24/2022

時間を節約してすぐに開始できるように、この記事では、独自の Azure Active Directory (Azure AD) アプリケーションを登録しなくても、Postman 環境を構成して Dataverse 環境で機能するようにする方法について説明します。 Postman 環境と変数については、Postman ドキュメント > 変数を参照してください。

前提条件

接続できる Power Apps Dataverse 環境を用意します。
Postman デスクトップアプリケーションをダウンロードおよびインストールします。

Dataverse 環境に接続する

重要

時間を節約してすぐに開始できるように、すべての Dataverse 環境に登録されているアプリケーションのクライアント ID を提供しているため、Dataverse API に接続するために独自の Azure Active Directory (Azure AD) アプリケーションを登録する必要はありません。

Postman デスクトップアプリケーションを起動します。
新しい環境を作成するには、左側の環境を選択し、 + をクリックします。
環境の名前を入力します。たとえば、MyNewEnvironment。
Power Apps にサインインして、Web API エンドポイントのベース URL を取得します。
Power Apps 環境を選択し、右上隅にある設定ボタンをクリックします。その後、開発者リソースをクリックします。
開発者リソース ウィンドウで、Web API エンドポイントのベース URL を取得します。

Postman で、次のキーと値のペアを編集スペースに追加し、現在の値に初期値を使用します。

変数	初期値	操作
`url`	`https://<your org name>.api.crm.dynamics.com`	Web API エンドポイントのベース URL を使用する
`clientid`	`51f81489-12ee-4a9e-aaae-a2591f45987d`	値をコピーする
`version`	`9.2`	値をコピーする
`webapiurl`	`{{url}}/api/data/v{{version}}/`	値をコピーする
`callback`	`https://localhost`	値をコピーする
`authurl`	`https://login.microsoftonline.com/common/oauth2/authorize?resource={{url}}`	値をコピーする

設定は次のように表示されます。
保存をクリックして、新しく作成した MyNewEnvironment という名前の環境を保存します。

環境で使用するアクセストークンの生成

OAuth 2.0 を使用して接続するには、アクセストークンが必要です。新しいアクセストークンを取得するには、次のステップを実行します:

新しく作成した環境 MyNewEnvironment が選択されていることを確認します。 MyNewEnvironment のすぐ横にある + をクリックします。
次のウィンドウが表示されます。認証タブを選択します。
種類を OAuth 2.0 に設定し、認証データを追加する から 要求ヘッダー に設定します。

新しいトークンの構成 ウィンドウで、次の値を設定します。

件名	価値	アクション
付与タイプ	暗黙的	ドロップダウンから暗黙的を選択する
コールバック URL	`{{callback}}`	値をコピーする
認証 URL	`{{authurl}}`	値をコピーする
クライアント ID	`{{clientid}}`	値をコピーする

設定は次のように表示されます。

注意

異なるユーザー資格情報を使用して Postman で複数の Dataverse インスタンスの環境を構成している場合は、Cookie をクリア をクリックして Postman によってキャッシュされた Cookie を削除します。
新しいアクセストークンの取得 をクリックします。

新しいアクセストークンの取得 をクリックすると、Azure Active Directory のサインインダイアログボックスが表示されます。ユーザー名とパスワードを入力して サインイン をクリックします。認証が完了すると、次のダイアログが表示されます。
認証ダイアログが数秒で自動的に閉じた後、アクセストークンの管理 ウィンドウが表示されます。 トークンの使用 をクリックします。
新しく生成されたトークンは、使用可能なトークン ドロップダウンの下のテキストボックスに自動的に表示されます。