テナントの設定を顧客に案内する

適用対象: ISV

この記事を使用して、マルチテナント SharePoint Embedded アプリをインストールする顧客に渡されるセットアップ ガイドを作成します。 顧客管理者は、Microsoft 365 テナントに登録されている SharePoint Embedded アプリケーションと、顧客コンテンツを保持するコンテナーを管理する消費テナント管理者です。

顧客管理者ロール

セットアップを実行するユーザーに伝えます。 消費するテナント管理者は、 グローバル管理者 または SharePoint Embedded 管理者 ロールを割り当てられたユーザーのいずれかです。 このロールは、Microsoft Entra ID と Microsoft 365 管理センターで利用できます。 グローバル管理者には既にこれらのアクセス許可があります。

ロールの詳細については、「 SharePoint Embedded アプリのインストール」を参照してください。

お客様の前提条件

セットアップ ミーティングまたはインストール ウィンドウの前に、これらの前提条件の確認を顧客に求めます。

ユーザーは、メンションなどの例外的なエクスペリエンスが文書化されている場合を除き、コンテナーに保存されている Microsoft Office ドキュメントで共同作業を行うために Office ライセンスは必要ありません。

顧客に提供する情報

セットアップ ガイドで次の値を指定します。

• 製品名。
• 発行元名。
• 所有しているアプリケーション ID。
• コンテナーの種類 ID。
• コンテナーの種類名。
• 課金モデル。
• アプリが要求する Microsoft Entra のアクセス許可。
• アプリの同意手順。
• アプリが使用するリダイレクト URL またはサインイン URL。
• サポート連絡先。
• 想定されるセットアップ所要時間。
• 検証手順。

ISV 準備のガイダンスについては、「 顧客インストール用にアプリの準備」を参照してください。

アプリが要求するアクセス許可

アプリに必要な Microsoft Graph のアクセス許可とその理由をユーザーに正確に伝えます。 SharePoint Embedded アプリは 2 つのアクセス許可でインストールされます。

お客様向けのセットアップの概要

カスタマー ガイドで次の大まかな順序を使用します。

1. 適切な管理者ロールを割り当てる。
2. アプリの発行元、アプリ ID、要求されたアクセス許可を確認します。
3. 必要に応じて管理者の同意を与えます。
4. アプリのセットアップ フローを通じて、SharePoint Embedded コンテナーの種類を消費テナントに登録します。
5. 必要に応じて、パススルー請求を構成します。
6. アプリが顧客管理者に表示されることを確認します。
7. テスト コンテナーを作成またはアクセスします。
8. アプリが想定どおりのファイル操作を実行できることを確認します。
9. 顧客の検証ポリシーに従って、テスト コンテンツを削除または保持します。

手順 1: 管理者を割り当てる

アプリとコンテナーのセットアップ用に SharePoint Embedded 管理者またはグローバル管理者を選択するように顧客に依頼します。 アプリでパススルー課金を使用している場合は、課金管理者またはグローバル管理者が Microsoft 365 管理センター で課金の設定を完了していることを確認します。

インストール ウィンドウの前に必要なロールの割り当てを完了するように顧客に伝えます。 これにより、セットアップおよび検証中の遅延が回避されます。

手順 2: アプリケーションを確認する

顧客管理者に次の確認を依頼します。

• 発行元 ID。
• アプリケーション ID。
• コンテナーの種類 ID。
• 要求されたアクセス許可 ( 「アプリが要求するアクセス許可」を参照)。
• SharePoint Embedded コンテナーに格納されているデータ。
• アプリがゲスト アクセスを許可するかどうか。
• サポートとインシデント対応のコミットメント。
• 課金モデル。

インストール フローが SaaS 管理ポータルでホストされている場合は、ハンドオフにスクリーンショットまたはテナント固有の値を含め、顧客管理者が運用環境とディザスター リカバリーのためにガイドを再利用できるようにリンクを安定させます。

手順 3: 管理者の同意を付与する

顧客管理者は、アプリに必要なアクセス許可に同意します。 何をするかを説明せずに生の同意 URL を送信するのではなく、アプリの正確な同意エクスペリエンスを文書化します。

顧客に次のガイダンスを提供します。

1. 顧客管理者アカウントでサインインします。
2. 指定したアプリのセットアップまたは同意エクスペリエンスを開きます。
3. 発行元と要求されたアクセス許可を確認します。
4. パブリッシャーとアクセス許可が顧客の引き継ぎと一致する場合にのみ、同意を付与します。
5. 同意を完了した時間と管理者を記録します。

顧客管理者は、署名済みインストール パッケージ内の正確なアプリ ID にのみ同意する必要があります。 別のアプリ ID に同意することは、セキュリティ リスクです。

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

アプリでコンテナーを作成して使用できるようにするには、コンテナーの種類を消費テナントに登録する必要があります。 このフローはアプリ固有のものであるため、お客様を製品のセットアップ エクスペリエンスと現在の登録ドキュメントにリンクします。

顧客に次の確認を依頼します。

• セットアップ フローでは、予想される所有アプリケーション ID が使用されます。
• 登録は、予想されるコンテナーの種類 ID を対象としています。
• 登録は顧客のテナントで完了します。
• エラー メッセージは、時間、テナント、および関連付け情報がある場合はキャプチャされます。

手順 5: 必要に応じて請求を設定する

アプリで標準課金を使用している場合は、この手順をスキップします。 アプリでパススルー課金を使用している場合は、ユーザーがアプリにアクセスする前に SharePoint Embedded 課金を構成する必要があることを顧客に伝えます。

顧客には有効な Azure サブスクリプションとリソース グループが必要です。 課金管理者またはグローバル管理者は、Microsoft 365 管理センター で課金を設定します。 この管理者には、Azure サブスクリプションの所有者または共同作成者ロールも必要です。 次に、請求を設定します。

1. Microsoft 365 管理センターを開きます。
2. [ セットアップ>課金とライセンス] に移動し、[ 従量課金制サービスをアクティブ化する] を選択します。
3. [ Syntex services for] で、[ アプリ] を選択し、[ SharePoint Embedded] を選択します。
4. SharePoint Embedded ページの指示に従って、SharePoint Embedded アプリをオンにします。

手順 6: 管理の可視性を検証する

同意、登録、請求が完了したら、顧客管理者にアプリを管理できることを確認します。 管理者は、SharePoint 管理センターやその他の管理ツールを使用して、SharePoint Embedded アプリケーションとコンテナーを管理できます。

顧客管理者は次のことができます。

• テナント内のアプリケーションを列挙します。
• アプリケーションのコンテナーを列挙します。
• コンテナーの詳細を表示します。
• 管理エクスペリエンスでアクティブおよび削除されたコンテナーを表示します。
• サポートされている場合は、秘密度ラベルと共有設定を管理します。
• セキュリティとコンプライアンスの動作を確認します。

詳細な検証手順については、「 カスタマー アプリのインストールの検証」を参照してください。

顧客セットアップ チェックリスト

承認できるチェックリストを顧客に渡します。

• [ ] SharePoint Embedded 管理者またはグローバル管理者が、アプリとコンテナーのセットアップに割り当てられます。
• [ ] 課金管理者またはグローバル管理者は、必要に応じてパススルー課金の設定を完了できます。
• [ ] アプリ ID と発行元が ISV ハンドオフと一致する。
• [ ] 予想されるアプリに対して管理の同意が付与されます。
• [ ] コンテナーの種類が消費テナントに登録されている。
• [ ] 必要に応じて、パススルー課金が構成されます。
• [ ] テスト ユーザーはアプリにサインインできます。
• [ ] テスト コンテナーを作成または開くことができます。
• [ ] テスト ドキュメントをアップロード、読み取り、削除できます。
• [ ] 顧客管理者は、管理ツールでアプリまたはコンテナーを表示できます。
• [ ] 検証ノートとサポート連絡先が記録されます。

セットアップ中のトラブルシューティング

この表を使用して、初期セットアップの問題をルーティングします。

次の手順

セットアップ後、顧客管理者にインストールを検証します。 カスタマー アプリのインストールを検証します。