- ホーム
- /
- 投稿記事
Webex アプリ | マイクロソフト OneDrive と SharePoint オンライン統合リファレンス
まとめ
Webex アプリを Microsoft OneDrive および SharePoint Online と統合することで、ユーザーはマイクロソフトの OneDrive や SharePoint Online に保存されているコンテンツを Webex アプリ内から直接共有したりアクセスしたりすることができます。
管理者は、組織にインテグレーションをプロビジョニング(設定、 有効化、承認)することができます。 プロビジョニングコンテンツ管理を参照してください。
組織のプロビジョニング手順を実行した後、各ユーザーは、自分に代わって Webex アプリが OneDrive や SharePoint Online にアクセスすることを個別に承認する必要があります。
これにより、ユーザーは Webex アプリ内から Microsoft OneDrive や SharePoint Online のコンテンツを操作できます。 ユーザーはWebex アプリ | マイクロソフトのOneDriveとSharePoint Onlineを読むべきです。
認証と承認
Webex アプリとマイクロソフトアズールまたはOffice 365との統合は、完全にアプリ中心です。 すべてのマイクロソフトクラウド API (OneDrive または SharePoint Online) は、Webex アプリから直接呼び出されます。 これらのAPIはOAuth2で保護されたリソースであり、安全にアクセスするにはアクセストークンが必要です。
アクセストークンを取得するには、ユーザーはまず Webex App を認証してから承認する必要があります。 発行されたアクセストークンは、API呼び出しのたびに認証ヘッダーでMicrosoft OneDriveまたはSharePoint Onlineに送信されます。 すべてのAPI呼び出しはHTTPSを使用して行われます。 詳細については、この記事の「ユースケース」セクションを参照してください。
認証と承認の一部として発行されるセッション Cookie とリフレッシュトークンは暗号化され、ユーザーの Webex アプリデバイスに安全に保存されます。 OneDriveまたはSharePoint Onlineのユーザーに関連する認証または承認情報は、Webexクラウドサービスに公開されることはありません。 Webex アプリキャッシュの詳細については、「技術運用とセキュリティ-よくある質問」を参照してください。
データ使用とストレージ
ドキュメントを共有したり、ドキュメントのサムネイルを表示したり、Microsoft OneDriveやSharePoint Onlineからドキュメントをプレビューしたりするために、Webex アプリはドライブID、アイテムID、ドキュメントタイトル、およびドキュメントの絶対URLまたは共有URLを使用します。 このデータは、Webex Appを使用して共有されるすべてのドキュメントのWebex Cloudに保存されます。 Webex アプリスペースで共有されている Microsoft OneDrive または SharePoint Online ファイルのコンテンツは、Webex クラウドには決して保存されません。
文書に関連して保存するデータは機密情報として扱われます。 Webex アプリは常に機密データ(ドライブID、アイテムID、ドキュメントタイトル、リンクなど)をWebex Cloudに送信する前に暗号化します。 つまり、暗号化されたドキュメントデータだけがWebex Cloudサービスに送信または保存されるということです。
データの暗号化には、Webex アプリは Webex クラウド暗号化サービスを使用します。 鍵管理は、クラウドの鍵管理サーバー(KMS)か、ハイブリッドデータセキュリティを導入する場合は自社のオンプレミスKMSによって提供されます。 詳細については、Webex アプリセキュリティペーパーを参照してください。
Webex Appは、データをユーザーのデバイスにローカルに個別にキャッシュします。 このデータはデバイスに保存されているときに暗号化されます。 Webex アプリキャッシュの詳細については、「技術運用とセキュリティ-よくある質問」を参照してください。
テナントはOffice 365のマルチジオ機能を使用して特定の場所にデータを保存できますが、Webex Appはデータをデータセンターにのみ保存します。 Webex Data Centerの場所に関する詳細については、Cisco Webexサービスプライバシーデータシートのセクション3を参照してください。
オフィス365テナントサポート
1つのOffice Cisco Webex 365テナントを1つの組織に設定できます。 私たちは、Office 365のワールドワイドおよびモデレートガバメントインスタンスのみをサポートしています。 サポートされていないその他のインスタンスには、USGovDod、usGovGCCigh、中国、ドイツなどがあります。
ユースケース
以下は、Microsoft OneDriveとSharePointオンラインインテグレーションリファレンスでサポートされているユースケースです。
フローには、次の大まかなステップが含まれます。
| 1 |
Webex アプリは、コンテンツリソースにアクセスするための認証を要求します。 |
| 2 |
Microsoft Cloudはユーザーに資格情報の入力を求めます。 |
| 3 |
Webex アプリはアクセストークンとリフレッシュトークンをリクエストします。 |
マイクロソフトアカウント接続プロセス

フローには、次の大まかなステップが含まれます。
| 1 |
ユーザーは添付ファイルをクリックします。 |
| 2 |
Webex アプリは Microsoft ファイルピッカーを開きます。 |
| 3 |
ユーザーはファイル、権限、編集、または表示モードを選択して、共有をクリックします。 |
| 4 |
Webex アプリはマイクロソフトクラウドと対話して共有リンクを構築します。 |
| 5 |
Webex アプリは新しい共有リンクを暗号化して投稿します。 |
| 6 |
Webex Conversationサービスは、リンクを保存してスペースのすべてのメンバーに伝播します。 |
文書の共有プロセス

フローには、次の大まかなステップが含まれます。
| 1 |
Webex アプリは、共有リンクを含むメッセージイベントを受信します。 |
| 2 |
Webex Appは共有リンクを復号化し、ユーザーの資格情報を使用してMicrosoftにサムネイルを要求します。 |
サムネイルのレンダリングプロセス

フローには、次の大まかなステップが含まれます。
| 1 |
ユーザーは共有リンクをクリックします。 |
| 2 |
Webex アプリはセッションクッキーを使用して、埋め込みブラウザで共有リンクを開きます。 |
書類の閲覧プロセス

マイクロソフトAPIの使い方
Webex アプリは Azure Active Directory (AD) v2 とマイクロソフトグラフの API を使用しています。 Azure ADはエンドユーザーの認証に使用されます。 マイクロソフトグラフは、マイクロソフトのOneDriveとSharePointのドキュメントにアクセスするために使用されます。 これらのAPIは幅広い操作をサポートしていますが、使用されるのはコマンドのサブセットだけです。
Azure AD v2 エンドポイント
|
アズール Active Directory v2 |
使い方 |
|---|---|
|
GET /oauth2/v2.0/オーソライズ |
GET /oauth2/v2.0/オーソライズ |
|
投稿 /oauth2/v2.0/トークン |
コードをアクセストークンに交換してください |
マイクロソフトグラフエンドポイント
|
グラフ操作 |
使い方 |
|---|---|
|
GET /私/ドライブ/ルート/子供 |
ルートディレクトリを読みます |
|
GET /私/ドライブ/アイテム/ {file_id} |
ファイルの詳細を読みます |
|
GET /me/drive/items/ {file_id} /サムネイル/0/large/content |
ファイルのサムネイルを読みます |
|
/items/ {file_id} /プレビューを投稿してください |
ファイルのプレビューを読みます |
|
POST /私/ドライブ/アイテム/ {file_id} /CreateLink |
ファイルへのリンクを作成します |
|
GET /シェア/ {アイテム} /ドライブアイテム |
共有リンクからメタデータを読みます |
|
GET /shares/ {item} /ルート/サムネイル/0/ラージ/コンテンツ |
共有リンクのサムネイルを読みます |
|
GET /私/ドライブ//アイテム/ {{file_id}} /権限 |
ファイルの読み取り権限 |