はじめに

社外のコンテンツをイントラネットに取り込む Web パーツは、管理者にとって 2 つの疑問を生みます。何がテナントから出ていくのか、そして何が入ってくるのか、です。RSS Reader は、そのコンテンツが Vitextra のサーバー (フィードをダウンロードするフィード サービス) を経由するという点で、Vitextra 製品の中では特別です。この記事では、その要求に正確に何が含まれるのか、Web パーツがテナント内で何を許可されているのか、構成がどこに保存されるのか、ブラウザーに何を保持するのか、発行元がフィードに入れた HTML をどのように扱うのかを説明します。

管理者向けの概要

質問回答
パッケージはどの API アクセス許可を要求しますか?なし
Web パーツは、SharePoint のリスト、ファイル、ユーザー プロファイルを読み取りますか?いいえ
フィードをダウンロードするのは誰ですか?ブラウザーからの要求を受けた Vitextra フィード サービス
フィード サービスへの要求には何が含まれますか?フィードのアドレス、テナント ID、ユーザーのオブジェクト ID、サイトのアドレス、製品とそのバージョン
テナントのコンテンツが Vitextra に送信されますか?いいえ
構成はどこに保存されますか?ページ上の Web パーツ プロパティ。Teams 個人用アプリの場合は、お客様のテナント用に Vitextra のサービス内
ブラウザーには何が保持されますか?最後に読み込まれたフィード アイテムをセッション ストレージに保持します。キャッシュの再利用期限は 30 分です
フィードの HTML はページ内で実行されますか?いいえ。不活性な方法で解析され、プレーン テキストとイメージのアドレスだけが使用されます

ソリューションのアクセス許可

RSS Reader は、アプリ カタログから展開される SharePoint Framework Web パーツです。

  • パッケージは API アクセス許可を要求しません。SharePoint 管理センターの API アクセスページには何も表示されず、Web パーツがデータのために Microsoft Graph や SharePoint REST API を呼び出すこともありません。
  • ページ コンテキストから読み取るのは、すべての Web パーツが持つ情報だけです。テーマ、言語、サイトのアドレス (ライセンス確認とフィード要求のため)、サインインしているユーザーの ID (同じ要求のためのオブジェクト ID) です。
  • フィードのコンテンツは、SharePoint、OneDrive、Microsoft Entra ID には保存しません。

ユーザーに必要なもの

タスク必要なアクセス許可
パッケージをアプリ カタログにアップロードする、Teams に追加するSharePoint 管理者、またはアプリ カタログの所有者
Web パーツをページに追加し、フィードを構成するページの編集アクセス許可
Teams 個人用アプリの既定の構成を保存するWeb パーツを含むページの編集アクセス許可
フィードを読む、ソースを切り替える、絞り込む、検索するページの閲覧アクセス許可

フィードの読み込み方法と送信される情報

ブラウザーは、発行元が CORS ヘッダーで許可していない限り、別のオリジンへのスクリプトからの要求を制限します。RSS Reader は vitextra.com のサーバー側のフィード サービスを使用します。ブラウザーがフィードのアドレスを送信し、サービスがフィードをダウンロードして解析し、チャネルとアイテムを構造化データとして返します。

読み込みと自動更新のたびに、次の内容を含む 1 つの要求がフィード サービスに送られます。

フィールド値
Sources構成されたフィードのアドレス
TenantIdお客様の Microsoft 365 テナントの ID
UserIdMicrosoft Entra ID におけるサインイン ユーザーのオブジェクト ID (GUID)
SiteUrlWeb パーツが動作しているサイトのアドレス
ProductId、ProductName、ProductVersion製品の識別子、内部名、バージョン

応答には、フィード アイテム (タイトル、リンク、説明、日付、作成者、分類、イメージのアドレス) と、ダウンロードできなかったソースの一覧が含まれます。サービスは、お客様のテナントのコンテンツを受け取ることも返すこともありません。ユーザーは名前や電子メール アドレスではなく、GUID によって識別されます。

3 つの影響:

  • 構成したフィードのアドレスはサービスに送信されます。個人用トークンや API キーなどの機密情報を含むアドレスは使用しないでください。サービスとページを閲覧できるすべてのユーザーに、その認証情報が共有されます。
  • 社内ネットワーク内でのみ到達可能なフィードは表示できません。
  • ブラウザーがフィードのために発行元のサーバーに接続することはありません。接続するのは、アイテムのイメージのためです。イメージは、Web ページ上の他の画像と同様にブラウザーが直接読み込むため、発行元にはユーザーのブラウザーからの通常の画像要求が見えます。

📝 注
Vitextra によるこれらの要求の処理については、プライバシー ポリシーで説明しています。要求がサービスに伝えるのは、ページにどのフィードが構成されているかであり、ユーザーがどの記事を開いたかではありません。記事へのリンクは発行元に直接つながり、クリックが Vitextra に報告されることはありません。

構成の格納場所

SharePoint ページ上では、構成 (アドレス、名前、順序を持つフィード、レイアウト、スイッチ) は、Site Pages (サイトのページ) ライブラリ内のページの中にある Web パーツのプロパティに格納されます。ページを読み取れるユーザーは誰でも構成を読み取れます。ページのバージョンには以前の構成が保持されます。

Teams 個人用アプリの場合、管理者が個人用アプリ (Microsoft Teams) グループの設定の保存で構成を保存します。この構成 (同じフィールドで、Web パーツのタイトルを除く) は、個人用アプリには格納先となるページがないため、お客様のテナントと製品に対して Vitextra のサービスに格納されます。テナント内のすべてのユーザーの個人用アプリによって読み取られ、次の設定の保存で上書きされます。含まれるのは設定とフィードのアドレスだけで、ユーザー データは含まれません。

Teams チャネル タブでは、構成はページ上と同様にタブと一緒に格納されます。

ブラウザーに保持される内容

読み込みが成功すると、Web パーツはフィードのアドレスの組み合わせをキーとして、受信したアイテムをセッション ストレージに保存します。新しいアイテムをバックグラウンドで読み込む間、保存から 30 分以内のキャッシュを再利用します。この期限は再利用の制限であり、自動削除の期限ではありません。キャッシュにはフィード アイテムが含まれ、ユーザー情報は含まれません。キャッシュはタブのセッションに属し、ブラウザーのセッション復元時に復元されることがあります。フィードのキャッシュ自体には、ローカル ストレージや Cookie は使用しません。

Web パーツはユーザーが開いた記事を記録しません。ブラウザーは閲覧履歴を保存する場合があり、訪問済みリンクの状態を使って開いたタイトルを淡色表示します。

フィード コンテンツの表示方法

フィード アイテムには、発行元が書いた HTML (マークアップ付きの説明、埋め込まれた画像、場合によってはスクリプトやトラッキング ピクセル) が含まれています。RSS Reader は、この HTML をページに挿入することはありません。

  • 説明は DOMParser で別のドキュメントとして解析されます。スクリプトは実行されず、プレーン テキストだけが表示されます。不活性な解析であっても、埋め込みリソースへの要求が発生しないとは限りません。
  • 画像はフィードのメディア要素または説明から取得されます。説明内で画像を探す際、指定された幅または高さが 1 ピクセル以下の画像は除外されますが、すべてのトラッキング画像をブロックするわけではありません。選択した画像は、発行元のアドレスを持つ通常の <img> 要素として表示されます。
  • リンクは、発行元のサイトの元の記事を新しいタブで開きます。Web パーツがトラッキング パラメーターを追加することはありません。

不正な形式のアイテム (要素の欠落、壊れたマークアップ) は、持っているデータで表示され、他のアイテムの表示を妨げることはありません。

Vitextra のサービスへの要求

目的送信される内容送信先
フィード サービス上記の表を参照vitextra.com
ライセンスの確認テナント ID、ユーザーのオブジェクト ID、サイトのアドレス、製品の識別子、名前、バージョンvitextra.com
Teams 個人用アプリの構成個人用アプリの読み込みのたびに読み取られ、設定の保存で書き込まれる、上記の構成フィールドvitextra.com
使用状況テレメトリWeb パーツの読み込み時のイベント: 製品の名前とバージョン、サイトの ID とアドレス、ユーザーのオブジェクト ID、インターフェイスの言語、Web パーツが Teams で実行されているかどうか。エラーの技術的な詳細Azure Application Insights
製品ファイルWeb パーツのスクリプトとアイコンに対する通常のファイル要求static.vitextra.com、vitextra-storage.azureedge.net

すべての Vitextra 製品にわたる同じ情報については、KB10363. Vitextra 製品がデータを保存する場所: プライバシー、データ所在地、GDPRを参照してください。

ネットワーク要件

ユーザーのネットワークと Teams クライアントから vitextra.com、static.vitextra.com、vitextra-storage.azureedge.net への送信 HTTPS を許可してください。フィード サービスがブロックされると、新しいアイテムを読み込めません。以前に読み込んだデータがない場合は、エラーが表示されます。製品ファイルのホストをブロックすると、Web パーツが読み込まれない場合があります。画像は発行元のホストから読み込まれるため、その要求がブロックされると表示されない場合があります。

推奨事項

  1. イントラネット上の他の外部コンテンツと同様に、組織が信頼する発行元のフィードを使用してください。タイトル、テキスト、画像は発行元のものであり、お客様の確認なしに変わります。
  2. フィードと画像の両方に HTTPS アドレスを使用してください。ブラウザーは HTTP の画像要求を HTTPS に変更するか、ブロックする場合があります。確実に表示するには、画像の HTTPS アドレスを直接使用してください。
  3. アドレスに個人用トークンを含むフィードは構成しないでください。そのアドレスは、ページを読み取れるすべてのユーザーおよびフィード サービスと共有されます。
  4. 共用のコンピューターでは、サインアウト時にブラウザーのサイト データを消去してください。ブラウザーがセッションを復元できる場合、タブを閉じるだけではデータの削除は保証されません。

質問と回答

この記事について質問すると、サポートチームから公式回答を受け取れます。

まだ質問はありません。最初の質問を投稿しましょう。

注目の記事

Microsoft Teams に RSS Reader を追加する方法

Microsoft Teams で Vitextra RSS Reader を使用する手順を説明します。SharePoint アプリ カタログからのアプリの発行、独自のフィードを持つチャネル タブとしての追加、個人用アプリとしての追加、個人用アプリが全員に対して使用する既定の構成の保存、アプリのセットアップ ポリシーによるピン留め、フィードが表示されない場合の確認事項を扱います。

88 2 分
代理者のいない不在を見つける方法

マネージャーが Vitextra Substitutions Web パーツの [代理者なし] タブを使って、今後 120 日間の直属の部下の承認済みの不在のうち、確定した代理者がまだいないものを見つける方法を説明します。3 つの状態の意味と、[割り当て] ボタンで未対応を解消する手順も紹介します。

96 1 分
Employee Directory: 読み取るデータと、お気に入りと設定の保存場所

セキュリティ審査担当者と管理者向けのリファレンス: Vitextra Employee Directory Web パーツがサインインしているユーザーの委任された ID で読み取る Microsoft 365 のデータ、Web パーツの設定と Teams 個人用アプリの既定の保存場所、ブラウザーに保持されるもの (お気に入り、ディレクトリ キャッシュ)、Vitextra と Application Insights に送信されるもの、許可が必要なホストについて説明します。

22 5 分

共有