顧客のインストール用にアプリを準備する

適用対象: Isv

SharePoint Embedded アプリケーションを顧客テナントに送信する前に、この記事を使用してください。 SharePoint Embedded は API 専用であるため、お客様のインストールは、従来の SharePoint サイトの展開ではなく、コンテナーの種類の登録、同意、アクセス許可、課金構成によって異なります。 目標は、顧客管理者に完全で反復可能なオンボード パッケージを提供することです。

重要

顧客オンボードの前に、開発者テナントで運用コンテナーの種類を準備します。 試用版コンテナーの種類は探索用であり、他の使用しているテナントにデプロイすることはできません。

お客様のインストール フロー

通常、顧客対応の SharePoint Embedded アプリケーションは、次の順序に従います。

  1. 製品のアプリケーション モデルとテナント モデルを選択します。
  2. 開発者テナントで所有アプリケーションを登録または構成します。
  3. その所有アプリケーションの標準の運用コンテナーの種類を作成します。
  4. コンテナーの種類に対して標準請求またはパススルー課金を選択します。
  5. 顧客の管理者Microsoft Entra同意情報を準備します。
  6. 顧客テナントのセットアップ手順を指定します。
  7. 必要に応じて、コンテナーの種類の登録、管理者の同意、課金の設定を完了するように顧客に依頼します。
  8. アプリケーションが、使用しているテナントでコンテナーを作成して使用できることを検証します。

発行パスの次の決定については、「 アプリの課金モデルを選択する」を参照してください。

前提条件

顧客のインストール資料を準備する前に、開発者テナントで次の項目を確認します。

分野 要件
Microsoft 365 テナント アクティブな SharePoint テナントを使用できます。
管理者ロール グローバル管理者または SharePoint 埋め込み管理者は、コンテナーの種類を管理できます。
アプリケーション コンテナーの種類を所有するMicrosoft Entra アプリケーションがあります。
コンテナーの種類 試用版コンテナーの種類ではなく、運用標準コンテナーの種類があります。
課金の決定 アプリで標準請求とパススルー課金のどちらを使用しているかがわかります。
顧客パッケージ アプリ ID、リダイレクト URL、アクセス許可、サポート連絡先、検証手順を提供できます。

開発者の責任を理解する

開発者は、SharePoint Embedded アプリケーションとそれをバックするコンテナーの種類を管理します。 コンテナーの種類は、SharePoint Embedded アプリケーションとコンテンツを格納するコンテナーの間の関係を定義します。 各コンテナーの種類は、所有するアプリケーションに関連付けられます。 所有しているアプリケーションには、その種類のコンテナーへの既定のフル アクセス権があります。

開発者は、SharePoint Embedded Visual Studio Code 拡張機能または Microsoft Graph fileStorageContainerType API を使用して、コンテナーの種類を作成、一覧表示、更新、削除できます。 グラフの作成は委任のみであり、管理者ロールは必要ありません。 詳細については、「 コンテナーの種類を作成して構成する」を参照してください。

モデルとテナントの決定については、「 アプリ モデルの選択」を参照してください。

アプリケーション構成をパッケージ化する

アプリの確認と承認に必要な正確な識別子と URL を顧客に提供します。 コードからこれらの値を推測するように顧客管理者に依頼しないでください。

インストール パッケージに次の情報を含めます。

  • 製品名と発行元名。
  • 所有アプリケーション ID。
  • コンテナーの種類 ID(作成後)。
  • コンテナーの種類名。
  • 課金モデル: 標準またはパススルー。
  • コンテナーの種類で構成されている場合は、アプリケーション リダイレクト URL。
  • 顧客向けのサインイン URL。
  • 顧客向けのサポート URL。
  • アプリによって要求されたMicrosoft Entraアクセス許可の一覧。
  • アプリで委任されたアクセス許可、アプリケーションのアクセス許可、またはその両方を使用するかどうか。
  • ゲスト アプリケーションが所有アプリケーションへのアクセスを必要とするかどうか。
  • アプリのデータ所在地、保持、サポートの境界。
  • セットアップ後に顧客が実行できる検証手順。

所有しているアプリとコンテナーの種類の関係を確認する

すべての運用コンテナーの種類には、所有アプリケーションが必要です。 1 つの所有アプリケーションで一度に所有できるコンテナーの種類は 1 つだけです。 1 つの所有アプリケーションを複数の運用コンテナーの種類にまたがって再利用しないでください。 複数の分離または課金の境界が必要な場合は、個別の所有アプリケーションとコンテナーの種類を計画します。

SharePoint Embedded Visual Studio Code 拡張機能または Microsoft Graph Create fileStorageContainerType API を使用して、運用コンテナーの種類を作成します。 Microsoft Graph の作成は委任専用であり、管理者ロールは必要ありません。

運用コンテナーの種類を構成する

顧客が使用する標準のコンテナーの種類を作成します。 SharePoint Embedded では、次の 2 つの運用課金オプションがサポートされています。

  • Standard課金。開発者テナントが課金されます。
  • パススルー課金。この場合、使用しているテナントは登録とセットアップ後に課金されます。

標準請求の場合、開発者は課金情報を添付するときに、Azureサブスクリプション、リソース グループ、リージョンを指定する必要があります。 パススルー課金の場合、開発者はパススルー課金を有効にしてコンテナーの種類を作成し、顧客管理者は後で使用しているテナントで課金を設定します。

重要

コンテナーの種類が作成された後、Standardとパススルーの課金の選択肢を変換することはできません。 間違った課金モデルを選択した場合は、目的の課金モデルを使用して新しいコンテナーの種類を作成します。

顧客が何を行う必要があるかを決定する

顧客のハンドオフでは、ISV タスクを顧客管理者タスクから明確に分離する必要があります。

ISV タスク

顧客がセットアップを開始する前に、次のタスクを完了します。

  1. 所有するMicrosoft Entra アプリケーションを作成または構成します。
  2. 運用コンテナーの種類を作成します。
  3. すべてのコンテナーに適用されるコンテナーの種類の設定を構成します。
  4. 同意要件Microsoft Entra文書化します。
  5. パススルー請求が必要かどうかを文書化します。
  6. 検証チェックリストを準備します。
  7. インストール エラーのエスカレーション連絡先を指定します。

顧客管理タスク

テナントでこれらのタスクを完了するように顧客管理者に依頼します。

  1. アプリの発行元、アクセス許可、およびデータ処理に関するドキュメントを確認します。
  2. 必要に応じて管理者の同意を付与します。
  3. アプリの登録フローを使用して、使用しているテナントにコンテナーの種類を登録します。
  4. アプリがパススルー課金を使用する場合は、課金を設定します。
  5. アプリがテナント管理エクスペリエンスに表示されることを検証します。
  6. コンテナーが作成および管理できることを確認します。

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

アクセス許可の準備に関するガイダンス

アプリが要求するアクセス許可と、各アクセス許可が必要な理由を文書化します。 コンテキストなしでアクセス許可の表示名をコピーする代わりに、製品固有の説明を使用します。

少なくとも、使用しているテナントにインストールされている SharePoint Embedded アプリは、次の Microsoft Graph アクセス許可を要求します。

アクセス許可 型 用途
FileStorageContainerTypeReg.Selected 委任またはアプリケーション 使用しているテナントにコンテナーの種類を登録します。 委任されたアクセス許可を持つユーザーは、 SharePoint Embedded Administrator または Global Administrator である必要があります。 アプリケーションのアクセス許可には管理者の同意が必要です。委任されたアクセス許可は許可されません。
FileStorageContainer.Selected 委任またはアプリケーション コンテナーの種類の SharePoint Embedded コンテンツを操作します。 アプリケーションのアクセス許可には管理者の同意が必要です。委任されたアクセス許可は許可されません。

重要

ユーザーの代わりに SharePoint Embedded (委任されたアクセス) を使用することをお勧めします。 アプリケーションによって実行されるアクションのセキュリティと監査性の両方が向上します。

シングルテナント アプリの場合は、管理者の同意 URL を作成し、テナントのMicrosoft Entra管理者に提供できます(例:

https://login.microsoftonline.com/{tenant}/v2.0/adminconsent?client_id={client_id}&redirect_uri={redirect_uri}

アプリの リダイレクト URI が管理者の同意フローを処理できることを確認します。 完全なアクセス許可モデルについては、「 認証と承認」を参照してください。

アプリでゲスト アプリケーション アクセスが使用されている場合は、使用しているテナント管理者が管理ツールでゲスト アプリケーションのアクセス許可を表示する方法について説明します。

注意

インストール スクリプトでオプションまたは昇格されたアクセス許可を非表示にしないでください。 顧客管理者は、同意を付与する前に、要求されたアクセス許可を確認できる必要があります。

課金ガイダンスを準備する

アプリをインストールする前に、適用される課金モデルを顧客に伝えます。

標準請求の場合:

  • 開発者テナントが SharePoint Embedded 従量課金関係を所有していることを説明します。
  • SharePoint Embedded の使用状況が商用契約に含まれているかどうかを顧客に伝えます。
  • 顧客が SharePoint Embedded 課金のAzureサブスクリプションを構成する必要がないことを確認します。

パススルー課金の場合:

  • 従量課金が消費テナントに課金されることを説明します。
  • 有効な課金が構成されるまで、パススルー SharePoint Embedded アプリにユーザーがアクセスできないことをお客様に伝えます。
  • テナントのセットアップを 通じて顧客をガイド し、 SharePoint Embedded アプリをインストールするように顧客に送信します。

管理者ハンドオフ資料を準備する

次を含む簡潔な管理者ハンドオフ パケットを作成します。

  • インストールの概要。
  • 発行元とアプリの ID 情報。
  • セキュリティとコンプライアンスの概要。
  • 課金モデルの概要。
  • 同意手順をMicrosoft Entraします。
  • テナントのセットアップ手順。
  • 検証チェックリスト。
  • ロールバックまたはアンインストールのガイダンス。
  • 連絡先と予想される応答時間をサポートします。

ハンドオフは、1 つの製品と 1 つのコンテナーの種類に固有のままにします。 複数の製品を発行する場合は、アプリごとに個別のハンドオフを指定します。

検証チェックリストを指定する

インストール後に顧客が記入できるチェックリストを含めます。

  • 顧客管理者は、テナント内の SharePoint Embedded アプリケーションを識別できます。
  • 顧客管理者は、想定される同意を付与しました。
  • パススルー課金は、必要に応じて有効になります。
  • アプリケーションでテスト コンテナーを作成できます。
  • アプリケーションは、テスト コンテンツをアップロード、読み取り、削除できます。
  • 顧客管理者は、コンテナーの詳細を表示できます。
  • 外部共有の動作は、顧客のポリシーと一致します。
  • テスト データは、検証後に削除されます。

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

次の手順

インストール手順を顧客に送信する前に、適切な課金オプションを選択します。 アプリの課金モデルを選択します。

  • Last updated on