Microsoft 顧客契約一括構成証明ツール

対象ロール: 管理エージェント | 販売エージェント

適用可能なクラウド: グローバル

Microsoft 顧客契約一括構成証明ツールを使用すると、パートナーは顧客に代わって Microsoft 顧客契約に同意していることを確認できます。 このツールは、多くの顧客を抱え、Microsoft 顧客契約の更新作業の対象となるパートナーを支援するように設計されています。

一括構成証明ツールには、いくつかの機能があります。

• オープン ソースの .NET SDK を使用したオープン ソースの .NET コンソール ツール (7.0)
• 一括構成証明を設定するためのコンマ区切り (.csv) ファイル形式をサポートします
• コードの変更は必要なく、.NET コマンドで使用できます
• コードは拡張可能であり、パートナーが適合すると判断した場合に拡張できます
• 広範なログ記録は、問題のトラブルシューティングに役立ちます

このツールは、CSP プログラムを通じて取引する直接請求パートナーと間接プロバイダーを対象としています。

前提条件

• 顧客ワークスペース API で MFA が適用されるため、パートナー アカウントは多要素認証 (MFA) に対して有効にする必要があります。 MFA を追加するには、「 パートナー テナントの MFA の管理」の手順に従います。

• ホスト コンピューターに .NET 7.0 SDK がインストールされていることを確認します。

• パートナー センターでネイティブ アプリケーションを構成します。

  1. パートナー センターで、[ Settings (歯車アイコン) >Account 設定を選択します。

     

  2. App management ページを選択します。

  3. [ + 新しいネイティブ アプリの追加を選択します。 新しいアプリケーションが自動的に作成されます。 アプリケーション ID をコピーし便利な状態に保ちます。

     

     これで、Azure portal で新しく作成されたアプリケーションが Azure Entra ID > アプリの登録下に表示されるようになります。

     

  4. Authentication タブを使用して、Mobile アプリケーションとデスクトップ アプリケーション用のプラットフォームを追加します。

     

  5. アプリケーションの http://localhost とその他のリダイレクト URI を構成します。

     

  6. 保存したら、リダイレクト URI が Mobile アプリケーションとデスクトップ アプリケーション プラットフォームの下に表示され、 ID トークン が Implicit 許可とハイブリッド フローで選択されていることを確認。

  詳細については、「 Partner Center 認証」を参照してください。

Microsoft 顧客契約一括構成証明ツールを実行する

1. GitHub の Partner Center DotNet Samples に移動し、 Code>Download ZIP を選択して、ファイルをローカル フォルダーに抽出します。 抽出されたフォルダーには、Microsoft 顧客契約RefreshBulkAttestationCLITool という名前のサブフォルダーがあります。 これで、ツールを実行する準備ができました。

2. コマンド プロンプトを開き、ファイルを抽出したフォルダーに移動します。

3. コマンド dotnet run を実行します。 必要に応じて、ビルドが完了するまで待ちます。

4. アプリケーション ID とユーザー プリンシパル名 (UPN) を指定します。 作成したネイティブ アプリケーション ID と UPN を使用します。

5. MFA を使用してアカウントにサインインします。

6. このツールには、次のセクションで説明する次のオプションが表示されます。

   

認証

ツールを起動すると、認証トークンがサイレント モードでフェッチされます。 失敗した場合は、対話型モードがトリガーされ、ブラウザー ウィンドウが開き、サインインするように求められます。 パートナー センターにサインインするときに使用するのと同じ資格情報を使用します。

認証が成功すると、次のメッセージが表示されます。 ブラウザー ウィンドウを閉じて、コンソール アプリケーションに戻ります。

シナリオ

ツールを使用する前に、次の点に注意してください。

• このツールは、顧客への直接の受け入れの詳細を提供するようには設計されていません
• このツールは、パートナー センターの Create Agreement API と同等の入力データ検証を行います。

このツールでサポートされるシナリオには、顧客契約レコードの と 顧客契約レコードの更新 があります。

顧客契約レコードを取得する

この操作では、パートナー センター API を使用して、パートナー テナントのMicrosoft 顧客契約更新のスコープ内にあるすべての顧客契約レコードをフェッチします。 次に、選択したパスの CSV ファイル (CustomerAgreementRecords.csv) にレコードが保存されます。

顧客契約が更新された場合 (一括ツール、パートナー センター ポータル、または契約の作成 API を使用)、レコードはフェッチ操作で返されません。 また、CSV ファイルには含まれません。 CSV ファイルで返されるすべてのレコードは操作可能であり、更新する必要があります。

フェッチ操作の実行例:

返されるフィールドの一部には、最後にパートナーが確認した契約の顧客の連絡先の詳細が含まれます。 以前の構成証明 (顧客に代わってパートナーによって確認された契約) が存在する場合、その確認の顧客の連絡先の詳細が次のフィールドに表示されます。 それ以外の場合は空白になります。 これらの詳細は、受け入れエージェントが受け入れの更新時に同じである場合に便利に提供されますが、それ以外の場合は、受け入れの詳細を正確に反映するように更新する必要があります。 パートナーがMicrosoft 顧客契約の同意を確認すると、指定された電子メールを使用して、電子メール通知が顧客に送信されます。

CSV ファイルには、次のフィールドが含まれています。

• 顧客テナント ID: 顧客のテナント/Microsoft ID
• 顧客の連絡先の詳細:
  • FirstName: 最後にパートナーが確認した契約の顧客の組織内の受け入れエージェントの名
  • LastName: パートナーが確認した最後の契約の顧客の組織内の受け入れエージェントの姓
  • 電子メール: 最後にパートナーが確認した契約の顧客の組織内の受け入れエージェントの電子メール アドレス
  • PhoneNumber: 最後にパートナーが確認した契約の顧客の組織内の受け入れエージェントの電話番号
  • LastAgreementDate: 最後にパートナーが確認した契約の datetime
• Partner Attestation Completed: 顧客契約レコードを一括ツールで更新するかどうかを示すブール値。 このフィールドは既定で False に設定され、更新するすべてのレコードに対して True に設定する必要があります。
• 顧客アカウント リンク: パートナー センターで顧客のアカウント ページへの直接リンクを表示するために使用される非運用フィールド。 ツールによってこのフィールドが設定されますが、どの操作にも使用されないため、変更しないでください。

CSV ファイルの例:

ヒント

最初の更新操作をトリガーする前に、独自のレコードの別の場所に返された顧客契約レコードのコピーを保存することをお勧めします。 顧客契約レコードが正常に更新されると、それらは解決済みとして扱われ、今後は返されません。

顧客契約レコードを更新する

この操作では、パートナー センター API を使用して、フェッチ操作によって作成された CSV ファイルから顧客契約レコードを更新します。

顧客契約レコードを更新する前に、顧客の組織内の受け入れエージェントの顧客の連絡先の詳細が正確で最新であることを確認します。 これを行うには、CSV ファイル内の次のフィールドを更新します。

• FirstName
• 姓
• 電子メール
• PhoneNumber (省略可能)

契約の日時は、パートナー センターで自動的に設定されます。

更新する顧客契約レコードをマークするには、CSV ファイル内のレコードに対して Partner Attestation Completed フィールドを True に設定します。 このツールは、このフィールドが True に設定されているレコードのみを処理します。

トップ 2 のお客様の CSV ファイルを更新する例フェッチ操作から返されます。

更新する顧客契約レコードをマークしたら、CSV ファイルを保存して閉じ、ツール メニューから更新操作をトリガーします。 ツールによって、CSV ファイルへのパスを指定するように求められます。 レコードが正常に解析されると、ツールは検出されたアクション可能なレコードの数を表示し、更新操作のディスパッチを開始します。

大量の契約の場合、ディスパッチされた呼び出しごとに更新する契約の最大数が 500であるため、更新に時間がかかる場合があります。 更新操作は、パートナー センターに到達すると非同期的に行われます。 ツールが更新操作を完了したときや、パートナー センターで顧客契約レコードが更新されるまでの遅延が予想されます。

更新操作の実行例:

関連するコンテンツ

• Microsoft 顧客契約一括構成証明ツールに関する FAQ