テナントのセットアップを通じて顧客をガイドする

適用対象: Isv

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

重要

顧客にアプリ リンクのみを送信しないでください。 SharePoint Embedded オンボードには、管理者の同意、コンテナーの種類の登録、ロールの割り当て、課金の設定が必要な場合があります。 以下の各手順を顧客管理者に説明します。

顧客管理者ロール

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

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

お客様の前提条件

セットアップ会議またはインストールウィンドウの前に、これらの前提条件を確認するようにお客様に依頼します。

分野	顧客の要件
Microsoft 365	少なくとも 1 つの SharePoint ライセンスを持つアクティブな Microsoft 365 テナント。
管理者ロール	グローバル管理者または SharePoint 埋め込み管理者は、セットアップを完了できます。
ユーザー	SharePoint Embedded コンテナーに対して認証を行うユーザーは、メンバーまたはゲストとしてMicrosoft Entra IDに存在します。
同意	顧客は、アプリが要求したMicrosoft Entraのアクセス許可を確認して付与できます。
請求	アプリでパススルー課金が使用されている場合は、Azureサブスクリプションとリソース グループを使用できます。
サポート	顧客には、アプリ ID、サポート連絡先、検証チェックリストがあります。

ユーザーは、メンションなどの文書化された優れたエクスペリエンスを除き、コンテナーに格納されている Microsoft Office ドキュメントで共同作業するために Office ライセンスを必要としません。

顧客に提供する情報

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

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

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

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

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

アクセス許可	用途	管理者の同意
FileStorageContainerTypeReg.Selected	使用しているテナントにコンテナーの種類を登録します。	アプリケーションのアクセス許可には管理者の同意が必要です。 委任されたアクセス許可には管理者の同意は必要ありませんが、コンテナーの種類を登録するユーザーは SharePoint Embedded Administrator またはグローバル管理者である必要があります。
FileStorageContainer.Selected	コンテナーの種類の SharePoint Embedded コンテナー コンテンツの読み取りと書き込み。	アプリケーションのアクセス許可には管理者の同意が必要です。 委任されたアクセス許可には、管理者の同意は必要ありません。

顧客向けのセットアップの概要

顧客ガイドでは、次の概要のシーケンスを使用します。

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

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

完全なセットアップを完了できる管理者を選択するように顧客に依頼します。 顧客がグローバル管理者を使用したくない場合は、SharePoint Embedded Administrator ロールを割り当てることができます。

インストールウィンドウの前にロールの割り当てを完了するように顧客に指示します。 これにより、課金または検証に昇格されたアクセス権が必要な場合の遅延を回避できます。

手順 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]\(Syntex services for\) で、[ アプリ] を選択し、[ SharePoint Embedded] を選択します。
4. SharePoint Embedded ページの指示に従って、SharePoint Embedded アプリを有効にします。

警告

パススルー課金がオフになっているか、リンクされたAzureサブスクリプションが切断されている場合、ユーザーは新しいコンテナーを作成できなくなります。 既存のコンテナーとそのコンテンツには引き続きアクセスできます。

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

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

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

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

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

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

サインオフできるチェックリストを顧客に提供します。

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

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

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

現象	可能性の高い領域	アクション
お客様が同意を付与できない	アクセス許可のMicrosoft Entra	管理者ロールとアプリ ID を確認します。
アプリでコンテナーを作成できない	登録またはアクセス許可	コンテナーの種類の登録と同意を確認します。
ユーザーがパススルー アプリにアクセスできない	請求	使用しているテナントで SharePoint Embedded 課金が有効になっていることを確認します。
アプリを管理できない管理	ロールまたはツール	SharePoint Embedded Administrator ロールと管理ツールのアクセス権を確認します。
アプリはメンバーに対して機能しますが、ゲストには機能しません	ID または共有	ゲスト ID と顧客共有ポリシーを確認します。

次の手順

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