適用対象: ISV
この記事は、お客様が SharePoint Embedded アプリをインストールした後に使用します。 検証により、コンテナーの種類の登録、同意、課金、管理の可視性、基本的なコンテナー操作が機能していることを確認します。 ユーザーにアプリを発表する前に、顧客管理者にこれらのチェックを実行します。
重要
運用ワークロードを実行する顧客テナントで検証します。 開発者テナントでのテストが成功しても、顧客テナントが正しく登録、同意、または請求されていることを証明するものではありません。
検証の目標
顧客のオンボードを終了する前に、次の目標を完了してください。
- アプリとコンテナーの種類が顧客テナントに登録されていることを確認します。
- 期待されるアクセス許可が付与されていることを確認します。
- パススルー アプリに対して課金が有効であることを確認します。
- アプリがコンテナーを作成またはアクセスできることを確認します。
- 顧客管理者がアプリとコンテナーを表示できることを確認します。
- コンテンツ操作がテスト ユーザーに対して機能することを確認します。
- 一般的なエラー モードが除外されていることを確認します。
顧客のセットアップ手順については、「 テナントのセットアップを顧客にガイドする」を参照してください。
People involved
検証には通常、ISV ロールと顧客ロールの両方が必要です。
| 役割 | 責任 |
|---|---|
| ISV 開発者 | 予想されるアプリ ID、コンテナーの種類 ID、アプリの動作、およびサポート トラブルシューティングを提供します。 |
| 顧客の課金管理者またはグローバル管理者 | パススルー請求を設定または確認します。 |
| 顧客の SharePoint Embedded 管理者またはグローバル管理者 | SharePoint Embedded アプリのセットアップと管理の可視性を確認します。 |
| Azure サブスクリプションの所有者ロールまたは共同作成者ロールを持つ顧客 | パススルー請求設定の問題の解決に役立ちます。 |
| 顧客テスト ユーザー | サインインして、アプリ レベルのドキュメント操作を実行します。 |
始める前に
次の値を収集します。
- 顧客テナント名または ID。
- 所有しているアプリケーション ID。
- ゲスト アプリのアプリケーション ID (アプリで使用されている場合)。
- コンテナーの種類 ID。
- コンテナーの種類名。
- 課金モデル。
- 予期される共有動作。
- サポート チケットまたはオンボーディング レコード。
ヒント
顧客のインストール パッケージで検証レコードを保持します。 これは、将来のサポート チームがセットアップの問題と製品のリグレッションを区別するのに役立ちます。
手順 1: コンテナーの種類の登録を確認する
コンテナーの種類が消費テナントに登録されていることを確認します。 アプリは、そのコンテナーの種類がそのテナントに登録されるまで、コンテナーを作成したり、コンテナーと対話したりできません。 製品のセットアップ ポータルまたは登録フローを使用して、登録状態を表示します。
顧客管理者に、SharePoint 管理センターを開き、[SharePoint Embedded>アクティブ アプリ]>インストール済みアプリに移動して、SharePoint Embedded アプリが一覧表示されていることを確認します。 顧客管理者は、次のような SharePoint Embedded アプリの詳細を確認できます。
- 所有しているアプリケーション ID。
- コンテナーの種類 ID。
登録が完了していない場合は、 テナント セットアップを通じて顧客をガイドするに戻ってください。
手順 2: アクセス許可を確認する
アプリが顧客テナントに正しくインストールされていることを確認するには:
- 所有アプリを使用して、消費テナントの Microsoft Graph
.defaultスコープのアクセス トークンを要求します。 - アクセス トークンに、
scp要求 (ユーザーの代わりにアクセスする場合) またはroles要求 (ユーザーなしのアクセスの場合) のいずれかのFileStorageContainer.SelectedとFileStorageContainerTypeReg.Selectedが含まれていることを確認します。 - トークンを使用して、 テナントでのコンテナーの種類の登録を取得します。 登録が返された場合は、SharePoint Embedded アプリが正しくインストールされていることを意味します。
ヒント
また、ゲスト アプリが適切に設定されていることを検証するには、消費テナントの Microsoft Graph .default スコープのアクセス トークンを要求し、想定したスコープ/ロールが存在し、トークンを使用してコンテンツを操作できることを検証します。 所有しているアプリのみが、テナント内のコンテナーの種類の登録にアクセスできます。
顧客が想定されるアクセス許可を付与し、予期しないアプリ ID が使用されていないことを確認します。
ほとんどのお客様のインストールでは、少なくとも次のアクセス許可を検証します。
| アクセス許可 | 一般的な使用 | 検証メモ |
|---|---|---|
FileStorageContainerTypeReg.Selected |
使用するテナントにコンテナーの種類を登録します。 | アプリでは、委任されたアクセス許可またはアプリケーションのアクセス許可としてこれを要求できます。 代理登録を使用する場合、登録を実行するユーザーは、SharePoint Embedded 管理者またはグローバル管理者である必要があります。 |
FileStorageContainer.Selected |
インストールされているアプリのコンテナーとコンテンツにアクセスします。 | アプリケーションのアクセス許可には管理者の同意が必要です。委任されたアクセス許可では、実行されません。 許可が顧客が承認したアプリの動作と一致していることを確認します。 |
次の項目を検証します。
- 必要な場合、アプリケーションのアクセス許可について承認された顧客管理者によって管理の同意が付与された。
- 同意されたアプリ ID は ISV インストール パッケージと一致します。
- アクセス許可セットには、アプリ モデルに必要な登録アクセス許可とコンテンツアクセス許可が含まれます。
- ゲスト アプリケーションのアクセス許可は、必要な場合に存在します。
- 委任されたアプリのみの動作は設計と一致します。
- テスト ユーザーは、メンバーまたはゲストとして Microsoft Entra ID に存在します。
注意
アプリ ID または発行元がインストール パッケージと一致しない場合は、検証を続行しないでください。 まず、同意の不一致を停止して解決します。
所有しているアプリまたはゲスト アプリにアクセス許可がない場合は、「 テナントのセットアップを通じて顧客をガイドする」に戻ります。
手順 3: 請求状況の確認
請求の検証は、選択した課金モデルによって異なります。
Standard billing
標準課金の場合は、開発者テナント課金関係がアクティブであることを内部的に確認します。 顧客は、アプリの SharePoint 埋め込み課金プロファイルを構成する必要はありません。 引き続き、アプリケーションで SharePoint Embedded 使用量がどのように処理されるかを顧客に伝えてください。
小切手:
- このアプリは標準の請求として文書化されます。
- 運用チームはコンサンプションを監視できます。
- 顧客引き継ぎでは、パススルー請求の構成は要求されません。
パススルー請求
パススルー請求の場合、顧客が有効な請求を設定するまで、ユーザーはアプリにアクセスできません。 顧客管理者に、Microsoft 365 管理センターで課金を確認するよう依頼してください。
小切手:
- 有効な Azure サブスクリプションが接続されています。
- 有効なリソース グループが選択されています。
- SharePoint Embedded アプリのセットアップが完了しました。
- 課金を設定する顧客管理者は、必要に応じて Azure サブスクリプションの所有者または共同作成者ロールを持っています。
- 顧客は、課金を無効にするとユーザー アクセスが中断されることを理解しています。
課金モデルのガイダンスについては、「 アプリの課金モデルを選択する」を参照してください。
手順 4: テスト コンテナーを作成または開く
アプリの通常のプロダクト フローを使用して、カスタマー テナントでテスト コンテナーを作成または開きます。 運用環境のユーザーが使用するのと同じアクセス許可とコンテナーの種類の登録をバイパスする非表示の検証パスを使用しないでください。
検証:
- アプリでは、予期されるコンテナー タイプのコンテナーを作成できます。
- アプリで既存のテスト コンテナーを開くことができます。
- アプリでは、小さなテスト ドキュメントをアップロードできます。
- アプリはテスト ドキュメントを読み取ることができます。
- これらの操作が製品の一部である場合、アプリはテスト ドキュメントを更新または削除できます。
- アプリは、顧客と ISV サポートがトラブルシューティングできる方法でエラーを報告します。
警告
既存の運用コンテナーでの破壊的な検証を避けます。 明確に識別されたテスト コンテナーを使用し、検証が完了したらテスト コンテンツを削除します。
手順 5: コンテナー管理を確認する
顧客管理者は、 SharePoint 管理センター を使用して、SharePoint Embedded アプリとそのコンテナーのインストールを管理できます。
- SharePoint Embedded アプリケーションのコンテナーの詳細を取得します。
- 特定のコンテナーの詳細を表示します。
- ストレージで並べ替えられたコンテナーを表示します。
- 該当する場合は秘密度ラベルを設定します。
- 該当する場合は、削除されたコンテナーを管理します。
- テスト コンテナーは、適切なときにのみ復元または完全に削除してください。
顧客管理のガイダンスについては、「 SharePoint 管理センターでコンテナーを管理する」を参照してください。
手順 6: 共有とコンプライアンスの期待値を確認する
SharePoint Embedded では、Microsoft 365 のセキュリティとコンプライアンス機能が使用されています。 顧客管理者に、アプリにとって重要な設定を検証するように依頼します。
- 外部共有動作。
- ゲスト ユーザー アクセス。
- 秘密度ラベルの期待。
- 保持または削除の期待値。
- 監査またはコンプライアンス レビューの要件。
- 顧客ポリシーの例外 (存在する場合)。
アプリに外部コラボレーションが必要な場合は、顧客テナント共有ポリシーが意図した動作を許可していることを確認します。 共有が制限されている場合は、ユーザーがアプリの使用を開始する前に製品への影響を文書化します。
一般的なエラー モード
オンボード時にこの表を使用します。
| エラー モード | チェックポイント | リンクする場所 |
|---|---|---|
| 管理者に対してアプリが表示されない | コンテナーの種類の登録とアプリ ID | 管理者の概要 |
| 同意エラー | 管理ロールと必要なアクセス許可 | 管理者の同意を与える |
| パススルー アプリにアクセスできない | 課金の設定と Azure サブスクリプション | テナントの設定を顧客に案内する |
| コンテナーの作成に失敗する | 登録、アクセス許可、請求 | SharePoint Embedded アプリをインストールする |
| ゲスト ユーザーがコンテンツにアクセスできない | ゲスト ID と共有ポリシー | 管理者の同意とアクセス許可を付与する |
| 管理ツールが失敗する | ロールの割り当てと管理ツールへのアクセス | 管理者の概要 |
| 課金が切断されました | 新しいコンテナーの作成はブロックされます。既存のコンテナーには引き続きアクセスできます | Microsoft 365 管理センターで課金を設定する |
検証チェックリスト
このチェックリストを最終的な顧客サインオフとして使用します。
- [ ] 顧客管理者がアプリに対して管理者の同意を付与しました。
- [ ] コンテナタイプの登録が完了しました。
- [ ] 顧客管理者には、SharePoint 管理センターで SharePoint Embedded アプリが表示されます。
- [ ] 顧客テナントに対して課金が有効であるか、必要ありません。
- [ ] テスト ユーザーがアプリにサインインできます。
- [ ] テスト コンテナーを作成または開くことができます。
- [ ] テスト ファイルの操作が機能します。
- [ ] 顧客管理者は、管理ツールでアプリまたはコンテナーを表示できます。
- [ ] 共有とコンプライアンスの期待値が文書化されています。
- [ ] テスト コンテンツは、契約によって削除または保持されます。
- [ ] サポート ハンドオフが完了しました。
検証後
検証が成功したら:
- 日付、テナント、アプリ ID、コンテナーの種類 ID を記録します。
- 課金モデルと顧客セットアップの結果を保存します。
- 検証レコードを顧客と共有します。
- アプリを次のリリースまたはロールアウトの手順に移動します。
検証に失敗した場合は、顧客をセットアップ フェーズにとどめ、ユーザー アクセスを広げる前にエラーを解決します。