LoginSignup

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

This article is a Private article. Only a writer and users who know the URL can access it.
Please change open range to public in publish setting if you want to share this article with other users.

@atsmin77

【Hoppscotch】【GraphAPI】アプリケーション許可権限 (1) ：事前準備

Last updated at Posted at 2025-05-13

はじめに

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

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

1. 事前準備

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

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

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

Entra ID へのアプリケーションの登録は、管理者ロールが割り当てられていない一般ユーザーでも行うことができます。

Graph API を実行する際には Entra ID アプリケーションにアクセス許可を追加する必要があります。アクセス許可の追加は管理者で行う必要があります。

  1. Entra ID 管理センターから [アプリケーション] - [アプリの登録] - [+新規登録] をクリックします
    image.png
  2. [名前] に任意の名前を入力して [保存] をクリックします
    image.png
  3. 作成したアプリケーションの [証明書とシークレット] - [+新しいクライアント シークレット] をクリックします
    image.png
  4. [追加] ボタンをクリックします
    image.png
  5. 追加されたシークレットの [値] 列をコピーボタンからコピーし、控えておきます
    image.png
  6. [概要] タブから [アプリケーション(クライアント) ID] と [ディレクトリ(テナント) ID] をコピーし、控えておきます
    image.png

次の手順で以下の情報を使用します。

  • アプリケーション(クライアント) ID
  • ディレクトリ(テナント) ID
  • クライアント シークレット

追加したクライアントシークレットは、ブラウザのページを更新すると、以降 Entra ID 管理センターから確認することができなくなります。
値が分からなくなった場合には、古いクライアントシークレットを削除して、再度作成します。

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

Graph API を実行するプログラムは、公開されている既存のプログラムや、自身で作成したプログラムなど何でも構いません。

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

しかし、Postman は SaaS アプリケーションのため、利用するためにはアカウントの作成が必須となります。組織によっては、Postman のような Saas アプリケーションの利用が制限されている場合もあると思いますので、ここでは Hoppscotch を利用して Graph API を実行してみます。

Hoppscotch は Postman とよく似ていますが、アカウントを作成することなくローカルの環境だけで利用することができます。Microsoft Graph Postman コレクションも利用できます。

1.2.1 Hoppscotch のインストール

  1. ダウンロードページ からインストーラをダウンロードしてインストールします
    image.png
  2. インストールが完了すると Hoppscotch が開きます
    image.png
  3. 更新を促すダイアログが表示されたら [Later] をクリックします
    image.png
  4. 初期画面が表示されます
    image.png

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

  1. 以下の 2 つのファイルを右クリックして [名前を付けて保存] します
    Microsoft Graph.postman_collection.json
    M365 Environment.postman_environment.json
    ※ Microsoft Graph Postman コレクションの JSON ファイルです。
  2. Hoppscotch の右上のフォルダのアイコンから [インポート] をクリックします
    image.png
  3. [Postmanからインポート] をクリックします
    image.png
  4. [ファイルの選択] から Microsoft Graph.postman_collection.json を選択しインポートします
    image.png
  5. Microsoft Graph などのフォルダが追加されたことを確認します
    image.png
  6. フォルダの 1 つ下のアイコンをクリックします
    image.png
  7. [Postmanからインポート] をクリックします
    image.png
  8. [ファイルの選択] から M365 Environment.postman_environment.json を選択しインポートします
    image.png
  9. M365 Environment が追加されたことを確認します
    image.png

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

  1. [M365 Environment] の [編集] をクリックします
    image.png
  2. [ClientID] と [TenantID] の値をすべて削除して Entra ID に登録したアプリケーションの値に置き換えます
    image.png
  3. [Secrets] タブをクリックして、[ClientSecret] の値をすべて削除して Entra ID に登録したアプリケーションの値に置き換えます
    image.png
  4. 中央の [環境変数を選択] プルダウンから [M365 Environment] を選択します
    image.png

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

  1. フォルダのアイコンから [Application] フォルダを右クリックし [Properties] をクリックします
    image.png
  2. [Grant Type] を "Client Credentials" に変更します
    image.png
  3. https://login.microsoftonline.com/~ で始まる URL の末尾を "token" に変更し、[Client Secret] の行に "<<ClientSecret>>" と入力します
    [トークンを生成] をクリックします
    image.png
  4. [Token fetched successfully] と表示されることを確認して、[保存] をクリックします
    ※ 上部に表示される ey... のような文字列がアクセストークンです。
    image.png
  5. [Collection Properties Updated] と表示されることを確認します
    image.png

アクセストークンは、プログラムが組織の Entra ID に登録されたアプリケーションであることを示す許可証のようなものです。プログラムはアクセストークンによって Graph API へアクセスできるようになります。

アクセストークンには有効期限があり、既定では 1 時間です。有効期限が切れた場合には、手順 3 の [トークン生成] からアクセストークンを再度取得して [保存] します。

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

次の記事

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

0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?