はじめに

Graph API をアプリケーション許可権限で実行すると、管理者がテナント全体に渡る情報を取得したり、変更することができます。

この記事では、アプリケーション許可権限で Graph API を実行するために必要な事前準備についてまとめました。

1. 事前準備

アプリケーション許可権限 で Graph API を実行するには、以下の事前準備が必要です。

1. Entra ID へのアプリケーションの登録
2. Graph API を実行するプログラムの準備

1.1 Entra ID へのアプリケーションの登録

1. Entra ID 管理センターから [アプリケーション] - [アプリの登録] - [+新規登録] をクリックします
   
2. [名前] と [リダイレクト URL] を入力して [保存] をクリックします

※ 以下の [リダイレクト URI] は Insomnia から Graph API 実行する場合の設定例です。

項目	内容
名前	任意の名前
リダイレクト URI	Web / https://insomnia.rest

1. 作成したアプリケーションの [証明書とシークレット] - [+新しいクライアント シークレット] をクリックします
   
2. [追加] ボタンをクリックします
   
3. 追加されたシークレットの [値] 列をコピーボタンからコピーし、控えておきます
   
4. [概要] タブから [アプリケーション(クライアント) ID] と [ディレクトリ(テナント) ID] をコピーし、控えておきます
   

1.2 Graph API を実行するプログラムの準備

Graph API を実行するプログラムは、公開されているアプリケーションや PowerShell、自身で作成したプログラムなど何でも構いません。

公開されているアプリケーションを利用する場合には Postman がよく使われます。公開情報にある Microsoft Graph Postman コレクションを利用すると Graph API を簡単に実行することができます。
(参考：Microsoft Graph API で Postman を使用する)
https://learn.microsoft.com/ja-jp/graph/use-postman

しかし、Postman では作成したコレクションなどの設定が常にクラウド側へアップロードされます。組織によっては、Postman の利用が制限されている場合もあると思います。そのため、この記事では Insomnia を利用して Graph API を実行してみます。

代表的なアプリケーションの比較

名前	クラウド同期	ローカル環境のみで利用可	アカウント作成
Postman	〇	×	必要
Insomnia	〇	〇	必要
Bruno	×	〇	不要

※ Bruno というツールもあり、こちらはクラウド同期の機能が無いためアカウントを作成せずに利用できます。クラウドへ同期する必要が無ければこちらも便利です。

1.2.1 Insomnia のインストール

1. ダウンロードページ からインストーラをダウンロードしてインストールします
   
2. インストールが完了すると Insomnia が開きます
   [Continue] をクリックします
   
3. 任意の方法でサインアップします
   
4. 初期画面が表示されます
   

1.2.2 Microsoft Graph Postman コレクションのインポート

1. 以下の 2 つのファイルを右クリックして [名前を付けて保存] します
   Microsoft Graph.postman_collection.json
   M365 Environment.postman_environment.json
   ※ Microsoft Graph Postman コレクションの JSON ファイルです。
2. [Import] をクリックします
   
3. Microsoft Graph.postman_collection.json を選択し [Scan] をクリックします
   
4. [Import] をクリックします
   
5. Microsoft Graph が追加されたことを確認します
   
6. [Environments] をクリックし、[Import] をクリックします
   
7. M365 Environment.postman_environment.json を選択し [Scan] をクリックします
   
8. [Import] をクリックします
   
9. M365 Environment が追加されたことを確認します
   

1.2.3 Entra ID アプリケーションの情報を設定

1. [M365 Environment] をクリックします
   
2. [ClientID] / [TenantID] / [ClientSecret] の値を Entra ID に登録したアプリケーションから取得した値に置き換えます
   
3. ホームボタンから [Collections] - [Microsoft Graph] をクリックします
   
4. [Base Environment] をクリックし、プルダウンから [M365 Environment] を選択します
   
5. [M365 Environment] と表示されていることを確認します
   

1.2.4 アクセストークンの取得

1. [Microsoft Graph] フォルダをクリックして、右側の [Scripts] - [Pre-request] タブに入力されている内容を削除します
   
2. フォルダのアイコンから [Application] フォルダをクリックし、[Auth] タブをスクロールして [Fetch Tokens] をクリックします
   
3. 取得されたアクセストークンが [ACCESS TOKEN] に表示されることを確認します
   ※ ey... のような文字列がアクセストークンです。
   

アクセストークンについて

(参考：手順 3: アクセス トークンを要求する)
https://learn.microsoft.com/ja-jp/graph/auth-v2-service?tabs=http#step-3-request-an-access-token

次の記事

ここまでの手順でアクセストークンが取得できれば、Graph API が実行できるようになります。以下の記事に続きます。