SaaS アプリケーションを登録する

この記事では、Microsoft Azure portal を使用して SaaS アプリケーションを登録する方法と、発行元のアクセス トークン (Microsoft Entra アクセス トークン) を取得する方法について説明します。 発行元はこのトークンを使用して、 SaaS Fulfillment API を呼び出して SaaS アプリケーションを認証します。 SaaS Fulfillment API は、OAuth 2.0 クライアント資格情報を使用して、サービス間アクセス トークン要求を行うために Microsoft Entra ID (v2.0) エンドポイントにフローを付与します。

Microsoft Marketplace では、SaaS サービスがエンド ユーザーに使用する認証方法に制約はありません。 以下のフローは、Microsoft Marketplace で SaaS サービスを認証するためにのみ必要 です。

Microsoft Entra ID (Active Directory) の詳細については、「認証とは」を参照してください。

Microsoft Entra ID で保護されたアプリを登録する

Microsoft Entra ID の機能を使用するアプリケーションは、まず Microsoft Entra テナントに登録する必要があります。 この登録プロセスでは、アプリケーションに関する詳細を Microsoft Entra に提供する必要があります。 Azure portal を使用して新しいアプリケーションを登録するには、次の手順に従います。

1. Azure portalにサインインします。

2. アカウントから複数のアカウントにアクセスできる場合は、右上隅で自分のアカウントを選択します。 次に、ポータル セッションを目的の Microsoft Entra テナントに設定します。

3. 左側のナビゲーション ウィンドウで、Microsoft Entra ID サービス を選択し、[アプリの登録 ] を選択し、[新しいアプリケーションの登録 選択します。

   

4. [作成] ページで、アプリケーションの登録情報を入力します。

   • 名前: わかりやすいアプリケーション名を入力します

   • サポートされているアカウントの種類:

     オファーに適したオプションを選択します。

5. 完了したら、[登録] を選択します。

6. クライアント シークレットを作成するには、[証明書 & シークレット] ページに移動し、[+新しいクライアント シークレット を選択します。 シークレット値をコピーしてコードで使用してください。

7. SaaS API リソース 20e940b3-4c77-4b0b-9a53-9e16a1b010a7 のサービス プリンシパルを、SaaS アプリケーションを作成するのと同じテナントに登録します。 これを行うには、次の Azure CLI スクリプトまたは選択した方法を使用できます。

az login --tenant <TENANT_ID_GOES_HERE> 
az ad sp create --id 20e940b3-4c77-4b0b-9a53-9e16a1b010a7

発行元の承認トークンを取得する方法

アプリケーションを登録したら、発行元の承認トークン (Microsoft Entra アクセス トークン、Azure AD v2 エンドポイントを使用) をプログラムで要求できます。 発行元は、さまざまな SaaS Fulfillment API を呼び出すときにこのトークンを使用する必要があります。 このトークンは 1 時間のみ有効です。

これらのトークンの詳細については、Microsoft Entra アクセス トークンの を参照してください。 以下のフローでは、V2 エンドポイント トークンが使用されます。

HTTP POST を使用してトークンを取得する

HTTP メソッド

Post

要求 URL

https://login.microsoftonline.com/*{tenantId}*/oauth2/v2.0/token

URI パラメーター

要求ヘッダー

要求本文

応答

TokenResponse

応答の例:

{
      "token_type": "Bearer",
      "expires_in": "3600",
      "ext_expires_in": "0",
      "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6ImlCakwxUmNxemhpeTRmcHhJeGRacW9oTTJZayIsImtpZCI6ImlCakwxUmNxemhpeTRmcHhJeGRacW9oTTJZayJ9…"
  }

関連コンテンツ

Microsoft Entra ID で保護されたアプリで、SaaS Fulfillment サブスクリプション API バージョン 2 と SaaS Fulfillment Operations API バージョン 2を使用できるようになりました。

ビデオチュートリアル

• Microsoft Entra アプリケーションの登録