パートナー センターでの API アクセスの設定
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
この記事では、パートナー センター SDK に対する開発に必要なアカウントについて説明します。 また、統合サンドボックス アカウントを作成する方法、および統合サンドボックスでテストする方法についても説明します。
Note
API にアクセスするには、テナントが CSP テナントであり、自身が間接プロバイダーまたは直接請求パートナーである必要があります。
アカウントの定義
API 統合の統合とテストに役立つパートナー センターでは、次の 2 種類のアカウントがサポートされています。
プライマリ パートナー アカウント
このアカウントでは、実際のお客様用に実際の注文を作成します。 プライマリ アカウントにサインインするときに変更やトランザクションを行った場合は、パートナー センター SDK またはパートナー ダッシュボード UI を使用して、実際の顧客の公式注文として扱われます。 これらは請求書に反映され、支払いは会社が担当します。
統合サンドボックス アカウント
このアカウントでは、広範に展開する前に、コードと、パートナー センター API とのコードの統合をテストします。 統合サンドボックス アカウントにサインイン中に行う変更とトランザクションは、請求書に表示されますが、この請求金額は支払う必要がありません。 請求書 pdf には、"お支払いは不要です。 これはサンドボックスの請求書であり、操作は必要ありません。" という免責事項が記載されます。
統合サンドボックス アカウントとプライマリ アカウントは独立して動作し、管理者アカウント、ユーザー アカウント、顧客、注文、サブスクリプション、その他のデータは共有しません。
統合サンドボックスでは、限られた数の顧客、注文、サブスクリプション、ライセンスなどのトランザクションがサポートされます。
ポリシーによって、統合サンドボックス アカウントは統合テストのみを目的としています。
既定では、統合サンドボックス アカウントはありません。 パートナー センター SDK を使う予定がある場合は、これを作成する必要があります。
アカウントを設定する
このセクションでは、パートナー センター SDK 用のプライマリ パートナー アカウントと統合サンドボックス アカウントを設定する方法について説明します。
統合サンドボックスを作成する
グローバル管理者アカウントでパートナー センターにサインインし、設定 (歯車) を選択します。
Note
サンドボックスを作成するには、パートナーグローバル管理 onmicrosoft.com メインエイリアス (例: alias@domain.onmicrosoft.com) を使用してパートナー センターにログインする必要があります。 ユーザーがカスタム do メインを使用してログインしている場合、サンドボックスの作成は失敗します。
[アカウント設定]、[統合サンドボックス] の順に選択します。
Note
統合サンドボックスのオプションが表示されない場合は、全体管理者アカウントを持っていない可能性があります。 統合サンドボックスアカウントを使用していて、統合サンドボックスが既に設定されている可能性もあります。
統合サンドボックスの管理者アカウントの連絡先情報を入力します。 次に、[アカウントの作成] を選択します。 アカウントが作成されたことを示す確認メッセージが表示されるまで、数分待ちます。
確認メッセージが表示されたら、パートナー ダッシュボードからサインアウトします。
新しい統合サンドボックス管理者アカウントでもう一度サインインします。 資格情報には、username@domain という形式と共に、指定したパスワードを使用してください。
[統合サンドボックス] ページで [アカウントの設定] を選択して、サンドボックス アカウントのセットアップを完了します。
API アクセスを有効にする
アカウントが設定されたら、統合サンドボックスを使用してパートナー センター SDK を使用する前に、API アクセスを有効にする必要があります。 プライマリ パートナー アカウントと、統合サンドボックス アカウントの両方で、個別に API へのアクセスを有効にする必要があります。
グローバル管理者アカウントでパートナー センターにサインインし、設定 (歯車) を選択します。
[アカウント設定]、[アプリ管理] の順に選択します。
既存のアプリがまだない場合は、新しい Web アプリを追加します。 既存の Web アプリがある場合は、[キーの追加] ボタンをクリックします。
Web アプリを作成する場合は、アプリの登録情報 (特に [キー]) をコピーし、安全な場所に保存します。
パートナー ダッシュボードからサインアウトします。
統合サンドボックス アカウントでもう一度サインインします。 手順 2 - 5 を繰り返し、統合サンドボックスで API アクセスを有効にします。
コードの記述とテスト
統合サンドボックスでコードを記述し、コードをテストできます。 Microsoft Entra ID を使用してパートナー センター認証を設定するには、次の情報が必要です。
| 品目名 | 項目の場所 |
|---|---|
| アプリ ID/クライアント ID | 設定 (歯車) から[アカウント設定]、[アプリ管理] の順に選択します。 アプリ ID/クライアント ID が、登録済みアプリケーション アプリ ID として一覧表示されます。 |
| キー | 「API アクセスを有効にする」セクションで Web アプリを作成した場合、これは手順 5. で保存したキーです。 |
| Domain | 統合サンドボックスのドメインです。 |
テストされたコードの実行
実際の顧客データでソリューションを使用するには、統合サンドボックスの資格情報から、プライマリ パートナー アカウントの資格情報に変更する必要があります。
プライマリ パートナー アカウントでテスト済みのコードを使用する準備ができたら、Microsoft Entra セキュリティ トークンを取得する必要があります。 このセキュリティ トークンは、(統合サンドボックスのアプリ、キー、ドメインではなく) パートナー センターのアプリ、キー、およびドメインに基づいています。
パートナー センター認証の手順に従って、プライマリ パートナー センターの資格情報を使用して Microsoft Entra セキュリティ トークンを取得します。 (以前は、統合サンドボックスの Microsoft Entra セキュリティ トークンを取得するために、これらの手順に従いました)。
コード内の統合セキュリティ トークンを、プライマリ パートナー アカウントの新しいセキュリティ トークンに置き換えます。