Postman 環境の設定

[アーティクル]
02/01/2024

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

注意

Visual Studio Code を使って PowerShell を使用して、Postman への認証として Dataverse Web API で認証します。 PowerShell と Visual Studio Code で Web API の使用を開始します。このメソッドは:

Azure AD アプリ登録を使用するため、アプリケーション (クライアント) ID を指定する必要はありません。
アクセストークンが自動的に更新されるため、新しいものをリクエストし続ける必要はありません。

前提条件

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

Dataverse 環境に接続する

重要

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

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}}`	値をコピーする
Client ID	`{{clientid}}`	値をコピーする

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

注意

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

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