パートナーセンターの認証

[アーティクル]
03/12/2024

適用対象: パートナーセンター | 21Vianet が運営するパートナーセンター | Microsoft Cloud for US Government のパートナーセンター

パートナーセンターでは、認証に Microsoft Entra ID が使用されます。パートナーセンター API、SDK、または PowerShell モジュールを使ってやり取りする場合は、Microsoft Entra アプリケーションを正しく構成してから、アクセストークンを要求する必要があります。パートナーセンターでは、アプリのみの認証、またはアプリとユーザー認証を使用して取得したアクセストークンを使用できます。ただし、考慮する必要がある重要な項目が 2 つあります。

アプリ + ユーザー認証を使用してパートナーセンター API にアクセスする場合は、多要素認証を使用します。この変更に関する詳細については、セキュリティで保護されたアプリケーションモデルの有効化に関する記事をご覧ください。
一部の操作については、パートナーセンター API はアプリのみの認証をサポートしていません。アプリとユーザー認証を使用する必要がある特定のシナリオがあります。各articleの Prerequisites 見出しの下に、アプリのみの認証、アプリ + ユーザー認証、またはその両方がサポートされているかどうかを示すドキュメントがあります。

重要

Azure Active Directory (Azure AD) Graph は、2023 年 6 月 30 日の時点で非推奨となっています。今後、Azure AD Graph への投資は行いません。 Azure AD Graph API には、セキュリティ関連の修正プログラム以外の SLA やメンテナンスコミットメントはありません。新機能への投資は Microsoft Graph に対してのみ行われます。

アプリケーションを Microsoft Graph API に移行するのに十分な時間を確保できるように、段階的な手順で Azure AD Graph を廃止します。後日お知らせしますが、Azure AD Graph を使用して新しいアプリケーションの作成をブロックします。

詳細については、「 Important: Azure AD Graph の廃止と Powershell モジュールの廃止に関するページを参照してください。

初期セットアップ

最初に、プライマリパートナーセンターアカウントと統合サンドボックスパートナーセンターアカウントの両方があることを確認する必要があります。詳細については、「 API アクセス用にパートナーセンターアカウントを設定するを参照してください。プライマリアカウントと統合サンドボックスアカウントの両方の Microsoft Entra App 登録 ID とシークレット (アプリのみの識別にはクライアントシークレットが必要) をメモしておきます。
Azure portal から Microsoft Entra ID にサインインします。 [他のアプリケーションに対するアクセス許可] で、Windows Azure Active Directory のアクセス許可を [委任されたアクセス許可] に設定し、[サインインしたユーザーとしてディレクトリにアクセスします] と [サインインとユーザープロファイルの読み取り] の両方を選択します。
Azure portal で、[アプリケーションの追加] を選択します。 Microsoft パートナーセンターアプリケーションである "Microsoft パートナーセンター" を検索します。 [委任されたアクセス許可] を [Access Partner Center API]$パートナーセンター API へのアクセス$ に設定します。米国政府機関向け Microsoft Cloud のパートナーセンターを使用している場合、この手順は必須です。パートナーセンターグローバルインスタンスを使用している場合、この手順は省略可能です。 CSP パートナーは、パートナーセンターのアプリ管理機能を使用して、パートナーセンターのグローバルインスタンスに対してこの手順をバイパスできます。

アプリのみの認証

アプリのみの認証を使用してパートナーセンター REST API、.NET API、Java API、または PowerShell モジュールにアクセスしたい場合は、次の説明を使用してそのようにできます。

.NET (アプリのみの認証)

public static IAggregatePartner GetPartnerCenterTokenUsingAppCredentials()
{
    IPartnerCredentials partnerCredentials =
        PartnerCredentials.Instance.GenerateByApplicationCredentials(
            PartnerApplicationConfiguration.ApplicationId,
            PartnerApplicationConfiguration.ApplicationSecret,
            PartnerApplicationConfiguration.ApplicationDomain);

    // Create operations instance with partnerCredentials.
    return PartnerService.Instance.CreatePartnerOperations(partnerCredentials);
}

Java (アプリのみの認証)

Partner Center Java SDK を使用して、パートナーセンターのリソースを管理できます。これは、パートナーコミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソースプロジェクトです。問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。

public IAggregatePartner getAppPartnerOperations()
{
    IPartnerCredentials appCredentials =
        PartnerCredentials.getInstance().generateByApplicationCredentials(
        PartnerApplicationConfiguration.getApplicationId(),
        PartnerApplicationConfiguration.getApplicationSecret(),
        PartnerApplicationConfiguration.getApplicationDomain());

    return PartnerService.getInstance().createPartnerOperations( appCredentials );
}

REST (アプリのみの認証)

REST 要求

POST https://login.microsoftonline.com/{tenantId}/oauth2/token HTTP/1.1
Accept: application/json
return-client-request-id: true
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: login.microsoftonline.com
Content-Length: 194
Expect: 100-continue

resource=https%3A%2F%2Fgraph.windows.net&client_id={client-id-here}&client_secret={client-secret-here}&grant_type=client_credentials

REST 応答

HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Pragma: no-cache
Content-Type: application/json; charset=utf-8
Expires: -1
Content-Length: 1406

{"token_type":"Bearer","expires_in":"3600","ext_expires_in":"3600","expires_on":"1546469802","not_before":"1546465902","resource":"https://graph.windows.net","access_token":"value-has-been-removed"}

アプリとユーザー認証

セキュリティで保護されたアプリケーションモデルを使用して、パートナーセンター API アクセスに対してセキュリティで保護され、スケーラブルで将来を保証する認証を提供できるようになりました。この方法では、Azure AD 経由のアプリ専用やアプリ+ユーザーアクセストークンなどの最新の認証メカニズムを使用して、セキュリティが向上します。詳細については、「セキュリティで保護されたアプリケーションモデルを有効にする」を参照してください。

パートナーの同意プロセスは、パートナーが多要素認証を使用して認証し、アプリケーションに同意し、更新トークンが Azure Key Vault などのセキュリティで保護されたリポジトリに格納される対話型プロセスです。このプロセスには、統合のための専用アカウントを使用することをお勧めします。

重要

パートナーの同意プロセスで使用されるサービスアカウントに対して、適切な多要素認証ソリューションを有効にする必要があります。そうしない場合、結果として得られる更新トークンは、セキュリティ要件に準拠しなくなります。

アプリとユーザー認証のサンプル

パートナーの同意プロセスは、さまざまな方法で実行できます。パートナーが必要な各操作を実行する方法を理解できるように、次のサンプルを開発しました。環境内に適切なソリューションを実装する場合は、コーディング標準とセキュリティポリシーに準拠したソリューションを開発することが重要です。

.NET (アプリとユーザー認証)

パートナーの同意サンプルプロジェクトでは、ASP.NET を使用して開発された Web サイトを利用して、同意を取得し、更新トークンを要求してから、それを Azure Key Vault に安全に格納する方法を示しています。このサンプルに必要な前提条件を作成するには、次の手順を実行します。

Azure portal または次の PowerShell コマンドを使用して、Azure Key Vault のインスタンスを作成します。このコマンドを実行する前に、必ずパラメーター値を適宜変更してください。コンテナー名は一意である必要があります。
```
Login-AzureRmAccount

# Create a new resource group
New-AzureRmResourceGroup -Name ContosoResourceGroup -Location EastUS

New-AzureRmKeyVault -Name 'Contoso-Vault' -ResourceGroupName 'ContosoResourceGroup' -Location 'East US'
```
Azure Key Vault の作成の詳細については、「 Quickstart: Azure portal を使用して Azure Key Vault からシークレットを設定および取得するまたは Quickstart: PowerShell を使用して Azure Key Vault からシークレットを設定および取得するを参照してください。次に、シークレットを設定して取得します。

Azure portal または次のコマンドを使用して、Microsoft Entra アプリケーションとキーを作成します。

Connect-MgGraph -Scopes "Application.ReadWrite.OwnedBy"

$Context = Get-MgContext

$app = New-MgApplication -DisplayName 'My Vault Access App' -Web @{ RedirectUris = 'https://$($Context.TenantId)/$((New-Guid).ToString())' }
$password = Add-MgApplicationPassword -ApplicationId $app.AppId

Write-Host "ApplicationId       = $($app.AppId)"
Write-Host "ApplicationSecret   = $($password.SecretText)"

アプリケーション識別子とシークレットの値は、以下の手順で使用するため、必ずメモしておいてください。

Azure portal または次のコマンドを使用して、新しく作成した Microsoft Entra アプリケーションにシークレットの読み取りアクセス許可を付与します。

# Connect to Microsoft Graph
Connect-MgGraph -Scopes "User.Read"

# Get the application
$app = Get-MgApplication -Filter "appId eq 'ENTER-APP-ID-HERE'"

# Set the Key Vault access policy
Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -ObjectId $app.Id -PermissionsToSecrets get

パートナーセンター用に構成された Microsoft Entra アプリケーションを作成します。この手順を完了するには、次の操作を実行します。
- パートナーセンターの App management 機能を参照する
- 新しい Web アプリの追加を選択して、新しい Microsoft Entra アプリケーションを作成します。
"アプリ ID"、"アカウント ID"*、および "キー" の値は、以下の手順で使用するため、必ず文書化してください。
Visual Studio または次のコマンドを使用して、Partner-Center-DotNet-Samples リポジトリを複製します。
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Partner-Center-DotNet-Samples\secure-app-model\keyvault ディレクトリにある PartnerConsent プロジェクトを開きます。

web.config にあるアプリケーション設定にデータを入力します。

<!-- AppID that represents CSP application -->
<add key="ida:CSPApplicationId" value="" />
<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CSPApplicationSecret" value="" />

<!--
    Endpoint address for the instance of Azure KeyVault. This is
    the DNS Name for the instance of Key Vault that you provisioned.
 -->
<add key="KeyVaultEndpoint" value="" />

<!-- App ID that is given access for KeyVault to store refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate
    to your environment. The following application secret is for sample
    application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

重要

アプリケーションシークレットなどの機密情報は、構成ファイルに格納しないでください。ここでそれを行ったのは、これがサンプルアプリケーションであるためです。実稼働アプリケーションでは、証明書ベースの認証を使用することを強くお勧めします。詳細については、アプリケーション認証用の証明書資格情報に関する記事を参照してください。

このサンプルプロジェクトを実行すると、認証を求められます。認証に成功すると、Microsoft Entra ID からアクセストークンが要求されます。 Microsoft Entra ID から返される情報には、Azure Key Vault の構成済みインスタンスに格納される更新トークンが含まれます。

Java (アプリとユーザー認証)

パートナーの同意サンプルプロジェクトでは、JSP を使用して開発された Web サイトを利用して、同意を取得し、更新トークンを要求してから、それを Azure Key Vault に安全に格納する方法を示しています。このサンプルに必要な前提条件を作成するには、以下を実行します。

Azure portal または次の PowerShell コマンドを使用して、Azure Key Vault のインスタンスを作成します。このコマンドを実行する前に、必ずパラメーター値を適宜変更してください。コンテナー名は一意である必要があります。
```
Login-AzureRmAccount

# Create a new resource group
New-AzureRmResourceGroup -Name ContosoResourceGroup -Location EastUS

New-AzureRmKeyVault -Name 'Contoso-Vault' -ResourceGroupName 'ContosoResourceGroup' -Location 'East US'
```
Azure Key Vault の作成の詳細については、「 Quickstart: Azure portal を使用して Azure Key Vault からシークレットを設定および取得するまたは Quickstart: PowerShell を使用して Azure Key Vault からシークレットを設定および取得するを参照してください。

Azure portal または次のコマンドを使用して、Microsoft Entra アプリケーションとキーを作成します。

Connect-MgGraph -Scopes "Application.ReadWrite.OwnedBy"

$Context = Get-MgContext

$app = New-MgApplication -DisplayName 'My Vault Access App' -IdentifierUri 'https://$($Context.TenantDomain)/$((New-Guid).ToString())'
$password = Add-MgApplicationPassword -ApplicationId $app.AppId

Write-Host "ApplicationId       = $($app.AppId)"
Write-Host "ApplicationSecret   = $($password.SecretText)"

アプリケーション識別子とシークレットの値は、以下の手順で使用するため、必ず文書化してください。

Azure portal または次のコマンドを使用して、新しく作成された Microsoft Entra アプリケーションにシークレットの読み取りアクセス許可を付与します。
```
Connect-MgGraph -Scopes "User.Read"
$app = Get-MgApplication -Filter "appId eq 'ENTER-APP-ID-HERE'"

Set-AzKeyVaultAccessPolicy -VaultName ContosoVault -ObjectId $app.Id -PermissionsToSecrets get
```
パートナーセンター用に構成された Microsoft Entra アプリケーションを作成します。この手順を完了するには、以下を実行します。
- パートナーセンターの App management 機能を参照する
- 新しい Web アプリの追加を選択して、新しい Microsoft Entra アプリケーションを作成します。
"アプリ ID"、"アカウント ID"*、および "キー" の値は、以下の手順で使用するため、必ず文書化してください。
次のコマンドを使用して、Partner-Center-Java-Samples リポジトリを複製します
```
git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git
```
Partner-Center-Java-Samples\secure-app-model\keyvault ディレクトリにある PartnerConsent プロジェクトを開きます。

web.xml ファイルにあるアプリケーション設定にデータを入力します。

<filter>
    <filter-name>AuthenticationFilter</filter-name>
    <filter-class>com.microsoft.store.samples.partnerconsent.security.AuthenticationFilter</filter-class>
    <init-param>
        <param-name>client_id</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>client_secret</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_base_url</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_client_id</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_client_secret</param-name>
        <param-value></param-value>
    </init-param>
    <init-param>
        <param-name>keyvault_certifcate_path</param-name>
        <param-value></param-value>
    </init-param>
</filter>

重要

アプリケーションシークレットなどの機密情報は、構成ファイルに格納しないでください。ここでそれを行ったのは、これがサンプルアプリケーションであるためです。実稼働アプリケーションでは、証明書ベースの認証を使用することを強くお勧めします。詳細については、Key Vault 証明書認証に関するページを参照してください。

このサンプルプロジェクトを実行すると、認証を求められます。認証に成功すると、Microsoft Entra ID からアクセストークンが要求されます。 Microsoft Entra ID から返される情報には、Azure Key Vault の構成済みインスタンスに格納される更新トークンが含まれます。

クラウドソリューションプロバイダー認証

クラウドソリューションプロバイダーパートナーは、パートナーの同意プロセスを通じて取得した更新トークンを使用できます。

クラウドソリューションプロバイダー認証のサンプル

パートナーが必要な各操作を実行する方法を理解できるように、次のサンプルを開発しました。環境内に適切なソリューションを実装する場合は、コーディング標準とセキュリティポリシーに準拠したソリューションを開発することが重要です。

.NET (CSP 認証)

まだ行っていない場合は、パートナーの同意プロセスを実行します。
Visual Studio または次のコマンドを使用して、Partner-Center-DotNet-Samples リポジトリを複製します
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Partner-Center-DotNet-Samples\secure-app-model\keyvault ディレクトリにある CSPApplication プロジェクトを開きます。

App.config ファイルにあるアプリケーション設定を更新します。

<!-- AppID that represents CSP application -->
<add key="ida:CSPApplicationId" value="" />
<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CSPApplicationSecret" value="" />

<!-- Endpoint address for the instance of Azure KeyVault -->
<add key="KeyVaultEndpoint" value="" />

<!-- AppID that is given access for keyvault to store the refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

Program.cs ファイルにある PartnerId および CustomerId 変数に適切な値を設定します。

// The following properties indicate which partner and customer context the calls are going to be made.
string PartnerId = "<Partner tenant id>";
string CustomerId = "<Customer tenant id>";

このサンプルプロジェクトは、実行すると、パートナーの同意プロセス中に取得された更新トークンを取得します。これは次に、パートナーの代わりにパートナーセンター SDK と対話するためのアクセストークンを要求します。最後に、指定された顧客に代わって Microsoft Graph と対話するためのアクセストークンを要求します。

Java (CSP 認証)

まだ行っていない場合は、パートナーの同意プロセスを実行します。
Visual Studio または次のコマンドを使用して、Partner-Center-Java-Samples リポジトリを複製します
```
git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git
```
Partner-Center-Java-Samples\secure-app-model\keyvault ディレクトリにある cspsample プロジェクトを開きます。

application.properties ファイルにあるアプリケーション設定を更新します。

azuread.authority=https://login.microsoftonline.com
keyvault.baseurl=
keyvault.clientId=
keyvault.clientSecret=
partnercenter.accountId=
partnercenter.clientId=
partnercenter.clientSecret=

このサンプルプロジェクトは、実行すると、パートナーの同意プロセス中に取得された更新トークンを取得します。これは次に、パートナーの代わりにパートナーセンター SDK と対話するためのアクセストークンを要求します。
省略可能 - 顧客に代わって Azure Resource Manager および Microsoft Graph と対話する方法を確認する場合は、RunAzureTask と RunGraphTask 関数呼び出しのコメントを解除します。

コントロールパネルプロバイダー認証

コントロールパネルベンダーは、サポートを提供する対象の各パートナーにパートナーの同意プロセスを実行してもらう必要があります。これが完了すると、そのプロセスを通じて取得された更新トークンを使用して、パートナーセンター REST API と .NET API にアクセスします。

Note

コントロールパネルベンダーは、顧客のテナントで少なくともクラウドアプリケーション管理者ロールを持っている必要があります。

クラウドパネルプロバイダー認証のサンプル

コントロールパネルベンダーが必要な各操作の実行方法を理解できるように、次のサンプルを開発しました。環境内に適切なソリューションを実装する場合は、コーディング標準とセキュリティポリシーに準拠したソリューションを開発することが重要です。

.NET (CPV 認証)

適切な同意を得るために、クラウドソリューションプロバイダーパートナー向けのプロセスを開発してデプロイします。詳細と例については、「パートナーの同意」を参照してください。

重要

クラウドソリューションプロバイダーパートナーからのユーザー資格情報は格納しないでください。パートナーの同意プロセスを通じて取得した更新トークンは、保存し、Microsoft API と対話するためのアクセストークンを要求するために使用する必要があります。
Visual Studio または次のコマンドを使用して、Partner-Center-DotNet-Samples リポジトリを複製します
```
git clone https://github.com/Microsoft/Partner-Center-DotNet-Samples.git
```
Partner-Center-DotNet-Samples\secure-app-model\keyvault ディレクトリにある CPVApplication プロジェクトを開きます。

App.config ファイルにあるアプリケーション設定を更新します。

<!-- AppID that represents Control panel vendor application -->
<add key="ida:CPVApplicationId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:CPVApplicationSecret" value="" />

<!-- Endpoint address for the instance of Azure KeyVault -->
<add key="KeyVaultEndpoint" value="" />

<!-- AppID that is given access for keyvault to store the refresh tokens -->
<add key="ida:KeyVaultClientId" value="" />

<!--
    Please use certificate as your client secret and deploy the certificate to your environment.
    The following application secret is for sample application only. please do not use secret directly from the config file.
-->
<add key="ida:KeyVaultClientSecret" value="" />

Program.cs ファイルにある PartnerId および CustomerId 変数に適切な値を設定します。

// The following properties indicate which partner and customer context the calls are going to be made.
string PartnerId = "<Partner tenant id>";
string CustomerId = "<Customer tenant id>";

このサンプルプロジェクトは、実行すると、指定されたパートナーの更新トークンを取得します。次に、パートナーに代わってパートナーセンターと Microsoft Graph にアクセスするためのアクセストークンを要求します。これが次に実行するタスクは、顧客テナントに対するアクセス許可付与の削除と作成です。コントロールパネルベンダーと顧客の間に関係がないため、パートナーセンター API を使用してこれらのアクセス許可を追加する必要があります。次の例は、これがどのように行われるかを示しています。

JObject contents = new JObject
{
    // Provide your application display name
    ["displayName"] = "CPV Marketplace",

    // Provide your application id
    ["applicationId"] = CPVApplicationId,

    // Provide your application grants
    ["applicationGrants"] = new JArray(
        JObject.Parse("{\"enterpriseApplicationId\": \"00000003-0000-0000-c000-000000000000\", \"scope\":\"Domain.ReadWrite.All,User.ReadWrite.All,Directory.Read.All\"}"), // for Microsoft Graph access,  Directory.Read.All
        JObject.Parse("{\"enterpriseApplicationId\": \"797f4846-ba00-4fd7-ba43-dac1f8f63013\", \"scope\":\"user_impersonation\"}")) // for Azure Resource Manager access
};

/**
 * The following steps have to be performed once per customer tenant if your application is
 * a control panel vendor application and requires customer tenant Microsoft Graph access.
 **/

// delete the previous grant into customer tenant
JObject consentDeletion = await ApiCalls.DeleteAsync(
    tokenPartnerResult.Item1,
    string.Format("https://api.partnercenter.microsoft.com/v1/customers/{0}/applicationconsents/{1}", CustomerId, CPVApplicationId));

// create new grants for the application given the setting in application grants payload.
JObject consentCreation = await ApiCalls.PostAsync(
    tokenPartnerResult.Item1,
    string.Format("https://api.partnercenter.microsoft.com/v1/customers/{0}/applicationconsents", CustomerId),
    contents.ToString());

これらのアクセス許可が確立されると、このサンプルは顧客に代わって Microsoft Graph を使用して操作を実行します。

Note

Microsoft Graph の詳細については、「Microsoft Graph の概要」をご覧ください。

Java (CPV 認証)

適切な同意を得るために、クラウドソリューションプロバイダーパートナー向けのプロセスを開発してデプロイします。詳細と例については、「パートナーの同意」を参照してください。

重要

クラウドソリューションプロバイダーパートナーからのユーザー資格情報は格納しないでください。パートナーの同意プロセスを通じて取得した更新トークンは、保存し、Microsoft API と対話するためのアクセストークンを要求するために使用する必要があります。
次のコマンドを使用して、Partner-Center-Java-Samples リポジトリを複製します
```
git clone https://github.com/Microsoft/Partner-Center-Java-Samples.git
```
Partner-Center-Java-Samples\secure-app-model\keyvault ディレクトリにある cpvsample プロジェクトを開きます。
application.properties ファイルにあるアプリケーション設定を更新します。
```
azuread.authority=https://login.microsoftonline.com
keyvault.baseurl=
keyvault.clientId=
keyvault.clientSecret=
partnercenter.accountId=
partnercenter.clientId=
partnercenter.clientSecret=
partnercenter.displayName=
```
partnercenter.displayName の値は、お使いのマーケットプレースアプリケーションの表示名にする必要があります。

Program.java ファイルにある partnerId および customerId 変数に適切な値を設定します。

partnerId = "SPECIFY-THE-PARTNER-TENANT-ID-HERE";
customerId = "SPECIFY-THE-CUSTOMER-TENANT-ID-HERE";

このサンプルプロジェクトは、実行すると、指定されたパートナーの更新トークンを取得します。これは次に、パートナーに代わってパートナーセンターにアクセスするためのアクセストークンを要求します。これが次に実行するタスクは、顧客テナントに対するアクセス許可付与の削除と作成です。コントロールパネルベンダーと顧客の間に関係がないため、パートナーセンター API を使用してこれらのアクセス許可を追加する必要があります。次の例は、アクセス許可を付与する方法を示しています。

ApplicationGrant azureAppGrant = new ApplicationGrant();

azureAppGrant.setEnterpriseApplication("797f4846-ba00-4fd7-ba43-dac1f8f63013");
azureAppGrant.setScope("user_impersonation");

ApplicationGrant graphAppGrant = new ApplicationGrant();

graphAppGrant.setEnterpriseApplication("00000002-0000-0000-c000-000000000000");
graphAppGrant.setScope("Domain.ReadWrite.All,User.ReadWrite.All,Directory.Read.All");

ApplicationConsent consent = new ApplicationConsent();

consent.setApplicationGrants(Arrays.asList(azureAppGrant, graphAppGrant));
consent.setApplicationId(properties.getProperty(PropertyName.PARTNER_CENTER_CLIENT_ID));
consent.setDisplayName(properties.getProperty(PropertyName.PARTNER_CENTER_DISPLAY_NAME));

// Deletes the existing grant into the customer it is present.
partnerOperations.getServiceClient().delete(
    partnerOperations,
    new TypeReference<ApplicationConsent>(){},
    MessageFormat.format(
        "customers/{0}/applicationconsents/{1}",
        customerId,
        properties.getProperty(PropertyName.PARTNER_CENTER_CLIENT_ID)));

// Consent to the defined applications and the respective scopes.
partnerOperations.getServiceClient().post(
    partnerOperations,
    new TypeReference<ApplicationConsent>(){},
    MessageFormat.format(
        "customers/{0}/applicationconsents",
        customerId),
    consent);

顧客に代わって Azure Resource Manager および Microsoft Graph と対話する方法を確認する場合は、RunAzureTask と RunGraphTask 関数呼び出しのコメントを解除します。

次の方法で共有

パートナーセンターの認証

初期セットアップ

アプリのみの認証

.NET (アプリのみの認証)

Java (アプリのみの認証)

REST (アプリのみの認証)

REST 要求

REST 応答

アプリとユーザー認証

アプリとユーザー認証のサンプル

.NET (アプリとユーザー認証)

Java (アプリとユーザー認証)

クラウドソリューションプロバイダー認証

クラウドソリューションプロバイダー認証のサンプル

.NET (CSP 認証)

Java (CSP 認証)

コントロールパネルプロバイダー認証

クラウドパネルプロバイダー認証のサンプル

.NET (CPV 認証)

Java (CPV 認証)

フィードバック

その他のリソース

次の方法で共有

パートナー センターの認証

初期セットアップ

アプリのみの認証

.NET (アプリのみの認証)

Java (アプリのみの認証)

REST (アプリのみの認証)

REST 要求

REST 応答

アプリとユーザー認証

パートナーの同意

アプリとユーザー認証のサンプル

.NET (アプリとユーザー認証)

Java (アプリとユーザー認証)

クラウド ソリューション プロバイダー認証

クラウド ソリューション プロバイダー認証のサンプル

.NET (CSP 認証)

Java (CSP 認証)

コントロール パネル プロバイダー認証

クラウド パネル プロバイダー認証のサンプル

.NET (CPV 認証)

Java (CPV 認証)

フィードバック

その他のリソース

パートナーセンターの認証

クラウドソリューションプロバイダー認証

クラウドソリューションプロバイダー認証のサンプル

コントロールパネルプロバイダー認証

クラウドパネルプロバイダー認証のサンプル