適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
この記事では、パートナー センター SDK に対して開発する必要があるアカウントについて説明します。 この記事では、統合サンドボックス アカウント 作成し、統合サンドボックスでテストする方法についても説明します。
注
API にアクセスするには、テナントがクラウド ソリューション プロバイダー (CSP) テナントである必要があり、間接プロバイダーまたは直接請求パートナーである必要があります。
アカウント定義を理解する
API 統合の統合とテストを支援するために、パートナー センターでは 2 種類のアカウントがサポートされています。
プライマリ パートナー アカウント
このアカウントでは、実際の顧客の実際の注文を作成します。 プライマリ アカウントにサインインするときに変更やトランザクションを行った場合は、パートナー センター SDK またはパートナー ダッシュボード UI を使用して、実際の顧客の公式注文として扱われます。 これらは請求書に反映され、会社は支払いを担当します。
統合サンドボックス アカウント
このアカウントは、広範に展開する前に、コードとそのパートナー センター API との統合をテストするためのものです。 統合サンドボックス アカウントにサインインしたときに行った変更とトランザクションは請求書に表示されますが、請求書の金額を支払う必要はありません。 請求書の PDF には、「支払わないでください」という免責事項が含まれています。 これはサンドボックスの請求書であり、アクションは必要ありません。
- 統合サンドボックス アカウントとプライマリ アカウントは個別に動作します。 管理者アカウント、ユーザー アカウント、顧客、注文、サブスクリプション、その他のデータは共有されません。
- 統合サンドボックスは、限られた数の顧客、注文、サブスクリプション、ライセンスなどのトランザクションをサポートします。
- 統合サンドボックス アカウントは、ポリシーによる統合テストのみを目的としています。
- 既定では、統合サンドボックス アカウントは存在しません。 パートナー センター SDK を使用する場合は、自分で作成する必要があります。
アカウントを設定する
このセクションでは、パートナー センター SDK のプライマリ パートナー アカウントと統合サンドボックス アカウントを設定する方法について説明します。
統合サンドボックスを作成する
統合サンドボックスを作成するには、「クラウド ソリューション プロバイダー (CSP) 統合サンドボックス アカウントを作成する」の手順に従います。
API アクセスを有効にする
アカウントを設定したら、統合サンドボックスでパートナー センター SDK を使用する前に API アクセスを有効にする必要があります。 プライマリ パートナー アカウントと統合サンドボックス アカウントの両方に対して、API へのアクセスを個別に有効にする必要があります。
- グローバル管理者アカウントでパートナー センターにサインインし、[設定] (歯車アイコン) を選択します。
- アカウント設定を選択し、次に アプリ管理を選択します。
- 既存のアプリがない場合は、新しい Web アプリを追加します。 既存の Web アプリがある場合は、[キー の追加] ボタン 選択します。
- Web アプリを作成する場合は、アプリ登録情報 (特に キー) をコピーし、安全な場所に保存します。
- パートナー ダッシュボードからサインアウトします。
- 統合サンドボックス アカウントでもう一度サインインします。 手順 2 から 5 を繰り返して、統合サンドボックスで API アクセスを有効にします。
コードの記述とテスト
統合サンドボックスでコードを記述し、コードをテストできます。 Microsoft Entra ID を使用してパートナー センター認証 設定するには、次の情報が必要です。
- アプリ ID/クライアント ID: 設定 (歯車アイコン) >>内の 登録済みアプリケーションアプリ ID として一覧表示されます。
- キー: 前のセクションで新しい Web アプリを作成した場合は、そのキーを使用します。
- ドメイン: 統合サンドボックス用です。
テスト済みコードを実行する
実際の顧客データでソリューションを使用するには、統合サンドボックスの資格情報からプライマリ パートナー アカウントの資格情報に変更する必要があります。
プライマリ パートナー アカウントでテスト済みのコードを使用する準備ができたら、Microsoft Entra セキュリティ トークンが必要です。 このセキュリティ トークンは、(統合サンドボックス アプリ、キー、ドメインではなく) パートナー センターの アプリ、キー、ドメインに基づいています。
- パートナー センター認証 の手順に従って、プライマリ パートナー センターの資格情報を使用して Microsoft Entra セキュリティ トークンを取得します。 (以前は、統合サンドボックスの Microsoft Entra セキュリティ トークンを取得するために、これらの手順に従いました)。
- コード内の統合セキュリティ トークンを、プライマリ パートナー アカウントの新しいセキュリティ トークンに置き換えます。
関連コンテンツ
- パートナー センター開発者向けドキュメント
- パートナー センター API の使い始め方
- パートナー センター API のサンプル