顧客アプリのインストールを検証する

適用対象: Isv

この記事は、お客様が SharePoint Embedded アプリをインストールした後に使用します。 検証では、コンテナーの種類の登録、同意、課金、管理の可視性、および基本的なコンテナー操作が機能していることを確認します。 ユーザーにアプリをアナウンスする前に、顧客管理者に対してこれらのチェックを実行します。

重要

運用ワークロードを実行する顧客テナントで検証します。 開発者テナントでテストが成功しても、顧客テナントが正しく登録、同意、または課金されていることが証明されません。

検証の目標

顧客オンボードを終了する前に、次の目標を達成します。

  1. アプリとコンテナーの種類が顧客テナントに登録されていることを確認します。
  2. 必要なアクセス許可が付与されていることを確認します。
  3. パススルー アプリに対して課金が有効であることを確認します。
  4. アプリがコンテナーを作成またはアクセスできることを確認します。
  5. 顧客管理者がアプリとコンテナーを表示できることを確認します。
  6. コンテンツ操作がテスト ユーザーに対して機能することを確認します。
  7. 一般的なエラー モードが除外されていることを確認します。

顧客のセットアップ手順については、「 テナントのセットアップを通じて顧客をガイドする」を参照してください。

関連するPeople

検証には通常、ISV ロールと顧客ロールの両方が必要です。

役割 責任
ISV 開発者 予期されるアプリ ID、コンテナーの種類 ID、アプリの動作、サポートのトラブルシューティングを提供します。
顧客全体管理者または SharePoint 埋め込み管理者 SharePoint Embedded アプリのセットアップ、課金、管理の可視性を確認します。
顧客Azure課金所有者または共同作成者 パススルー課金設定の問題を解決するのに役立ちます。
顧客テスト ユーザー サインインし、アプリ レベルのドキュメント アクションを実行します。

始める前に

次の値を収集します。

  • 顧客テナント名または ID。
  • 所有アプリケーション ID。
  • ゲスト アプリのアプリケーション ID (アプリがゲスト アプリを使用している場合)。
  • コンテナーの種類 ID。
  • コンテナーの種類名。
  • 課金モデル。
  • 予期される共有動作。
  • サポート チケットまたはオンボード レコード。

ヒント

顧客のインストール パッケージを使用して検証レコードを保持します。 これは、将来のサポート チームがセットアップの問題と製品の回帰を区別するのに役立ちます。

手順 1: コンテナーの種類の登録を確認する

コンテナーの種類が、使用しているテナントに登録されていることを確認します。 コンテナーの種類がそのテナントに登録されるまで、アプリはコンテナーを作成または操作できません。 製品のセットアップ ポータルまたは登録フローを使用して、登録の状態を表示します。

顧客管理者に SharePoint 管理センターを開き、 SharePoint Embedded>Active アプリ>インストールされているアプリに移動し、SharePoint Embedded アプリが一覧表示されていることを確認します。 顧客管理者は、次のような SharePoint Embedded アプリの詳細を確認できます。

  • 所有しているアプリケーション ID。
  • コンテナーの種類 ID。

登録が完了していない場合は、 テナントのセットアップを通じて顧客をガイドするに戻ります。

手順 2: アクセス許可を確認する

アプリが顧客テナントに適切にインストールされていることを確認するには:

  1. 所有アプリを使用して、使用しているテナントの Microsoft Graph .default スコープのアクセス トークンを要求します。
  2. アクセス トークンに、scp要求 (ユーザーの代わりにアクセスする) またはroles要求 (ユーザーなしでアクセスする場合) にFileStorageContainer.SelectedとFileStorageContainerTypeReg.Selectedが含まれていることを確認します。
  3. トークンを使用して 、テナント内のコンテナーの種類の登録を取得します。 登録が返された場合は、SharePoint Embedded アプリが正しくインストールされていることを意味します。

ヒント

また、ゲスト アプリが適切に設定されていることを検証するには、使用しているテナントで Microsoft Graph .default スコープのアクセス トークンを要求し、想定するスコープ/ロールが存在し、トークンを使用してコンテンツと対話できることを検証します。 テナント内のコンテナーの種類の登録にアクセスできるのは、所有アプリだけです。

お客様に必要なアクセス許可が付与され、予期しないアプリ ID が使用されなかったことを確認します。

ほとんどのお客様のインストールでは、少なくとも次のアクセス許可を検証します。

アクセス許可 一般的な使用 検証に関するメモ
FileStorageContainerTypeReg.Selected 使用しているテナントにコンテナーの種類を登録します。 アプリは、委任またはアプリケーションのアクセス許可としてこれを要求できます。 委任された登録を使用する場合、登録を実行するユーザーは SharePoint Embedded Administrator またはグローバル管理者である必要があります。
FileStorageContainer.Selected インストールされているアプリのコンテナーとコンテンツにアクセスします。 アプリケーションのアクセス許可には管理者の同意が必要です。委任されたアクセス許可は許可されません。 許可が、顧客が承認したアプリの動作と一致することを確認します。

次の項目を検証します。

  • 管理同意は、必要に応じて、承認された顧客管理者によってアプリケーションのアクセス許可に付与されました。
  • 同意されたアプリ ID は、ISV インストール パッケージと一致します。
  • アクセス許可セットには、アプリ モデルの予想される登録とコンテンツのアクセス許可が含まれています。
  • ゲスト アプリケーションのアクセス許可は、必要に応じて存在します。
  • 委任された動作とアプリのみの動作は、デザインと一致します。
  • テスト ユーザーは、メンバーまたはゲストとしてMicrosoft Entra IDに存在します。

注意

アプリ ID または発行元がインストール パッケージと一致しない場合は、検証を続行しないでください。 同意の不一致を最初に停止して解決します。

所有しているアプリまたはゲスト アプリにアクセス許可がない場合は、「 テナントのセットアップを通じて顧客をガイドする」に戻ります。

手順 3: 課金の状態を確認する

課金の検証は、選択した課金モデルによって異なります。

Standard請求

標準請求の場合は、開発者テナントの課金関係がアクティブであることを内部的に確認します。 顧客は、アプリの SharePoint Embedded 課金プロファイルを構成する必要はありません。 引き続き、アプリケーションで SharePoint Embedded の使用量がどのように処理されるかを顧客に伝えます。

チェック：

  • アプリは、標準の課金として文書化されます。
  • 運用チームは消費を監視できます。
  • 顧客の引き渡しは、顧客にパススルー請求の構成を求めるわけではありません。

パススルー請求

パススルー課金の場合、顧客が有効な課金を設定するまで、ユーザーはアプリにアクセスできません。 顧客管理者に、Microsoft 365 管理センターで課金を確認するように依頼します。

チェック：

  • 有効なAzure サブスクリプションが接続されています。
  • 有効なリソース グループが選択されています。
  • SharePoint Embedded アプリのセットアップが完了しました。
  • 顧客の課金管理者には、必要に応じて所有者または共同作成者のアクセス許可があります。
  • 顧客は、課金を無効にするとユーザーアクセスが中断されることを理解しています。

課金モデルのガイダンスについては、「 アプリの課金モデルを選択する」を参照してください。

手順 4: テスト コンテナーを作成または開く

アプリの通常の製品フローを使用して、顧客テナントでテスト コンテナーを作成または開きます。 運用ユーザーが使用するのと同じアクセス許可とコンテナーの種類の登録をバイパスする非表示の検証パスを使用しないでください。

検証：

  • アプリは、予期されるコンテナーの種類のコンテナーを作成できます。
  • アプリは、既存のテスト コンテナーを開くことができます。
  • アプリは小さなテスト ドキュメントをアップロードできます。
  • アプリはテスト ドキュメントを読み取ることができます。
  • これらのアクションが製品の一部である場合、アプリはテスト ドキュメントを更新または削除できます。
  • アプリは、顧客と ISV サポートがトラブルシューティングできる方法でエラーを報告します。

警告

既存の運用コンテナーでの破壊的検証を避けます。 検証が完了したら、明確に識別されたテスト コンテナーを使用し、テスト コンテンツを削除します。

手順 5: コンテナーの管理を確認する

お客様の管理者は、 SharePoint 管理センター を使用して、SharePoint Embedded アプリとそのコンテナーのインストールを管理できます。

  • SharePoint Embedded アプリケーションのコンテナーの詳細を取得します。
  • 特定のコンテナーの詳細を表示します。
  • ストレージで並べ替えられたコンテナーを表示します。
  • 必要に応じて秘密度ラベルを設定します。
  • 該当する場合は、削除されたコンテナーを管理します。
  • 目的の場合にのみ、テスト コンテナーを復元または完全に削除します。

顧客管理ガイダンスについては、「 SharePoint 管理センターでコンテナーを管理する」を参照してください。

手順 6: 共有とコンプライアンスの期待を確認する

SharePoint Embedded では、Microsoft 365 のセキュリティとコンプライアンス機能が使用されます。 アプリに関係する設定を検証するように顧客管理者に依頼します。

  • 外部共有の動作。
  • ゲスト ユーザー アクセス。
  • 秘密度ラベルの期待値。
  • 保持または削除の期待。
  • 監査またはコンプライアンス レビューの要件。
  • 顧客ポリシーの例外 (存在する場合)。

アプリで外部コラボレーションが必要な場合は、顧客テナント共有ポリシーで目的の動作が許可されていることを確認します。 共有が制限されている場合は、ユーザーがアプリの使用を開始する前に製品への影響を文書化します。

一般的なエラー モード

オンボード中に次の表を使用します。

エラー モード チェックポイント リンクする場所
管理者に対してアプリが表示されない コンテナーの種類の登録とアプリ ID 管理者の概要
同意エラー ロールと予想されるアクセス許可を管理する 管理者の同意を付与する
パススルー アプリにアクセスできない 課金のセットアップとサブスクリプションのAzure テナントのセットアップを通じて顧客をガイドする
コンテナーの作成が失敗する 登録、アクセス許可、課金 SharePoint Embedded アプリをインストールする
ゲスト ユーザーがコンテンツにアクセスできない ゲスト ID と共有ポリシー 管理者の同意とアクセス許可を付与する
管理 ツールが失敗する ロールの割り当てと管理ツールへのアクセス 管理者の概要
課金が切断されました 新しいコンテナーの作成がブロックされます。既存のコンテナーは引き続きアクセス可能 Microsoft 365 管理センターで課金を設定する

検証チェックリスト

このチェックリストは、最終的な顧客サインオフとして使用します。

  • [ ] 顧客管理者がアプリの管理者の同意を付与しました。
  • [ ] コンテナーの種類の登録が完了しました。
  • [ ] 顧客管理者は、SharePoint 管理センターに SharePoint Embedded アプリを表示します。
  • [ ] 請求は、顧客テナントに対して有効であるか、必須ではありません。
  • [ ] テスト ユーザーはアプリにサインインできます。
  • [ ] テスト コンテナーは作成または開くことができます。
  • [ ] ファイル操作をテストします。
  • [ ] 顧客管理者は、管理ツールでアプリまたはコンテナーを表示できます。
  • [ ] 共有とコンプライアンスの期待が文書化されています。
  • [ ] テスト コンテンツは、契約によって削除または保持されます。
  • [ ] サポートハンドオフが完了しました。

検証後

検証が成功した後:

  1. 日付、テナント、アプリ ID、コンテナーの種類 ID を記録します。
  2. 課金モデルと顧客設定の結果を保存します。
  3. 検証レコードを顧客と共有します。
  4. アプリを次のリリースまたはロールアウト手順に移動します。

検証が失敗した場合は、顧客をセットアップ フェーズに留め、広範なユーザー アクセスの前にエラーを解決します。

次の手順

  • Last updated on