Postman 環境の設定

[アーティクル]
04/09/2023

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

前提条件

接続できる Power Apps Dataverse 環境を用意します。
Postman デスクトップアプリケーションをダウンロードおよびインストールします。
Postman アカウントを持っている 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 という名前の環境を保存します。
新しく作成した環境を選択し、次のいずれかの方法でアクティブに設定します。

右上にある省略記号メニューをクリックして、アクティブな環境として設定を選択するか、または
右上の環境ドロップダウンをクリックして、MyNewEnvironment" を選択します。

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

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

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

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

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

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

注意

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

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