はじめに
社外のコンテンツをイントラネットに取り込む 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 |
| UserId | Microsoft Entra ID におけるサインイン ユーザーのオブジェクト ID (GUID) |
| SiteUrl | Web パーツが動作しているサイトのアドレス |
| 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 パーツが読み込まれない場合があります。画像は発行元のホストから読み込まれるため、その要求がブロックされると表示されない場合があります。
推奨事項
- イントラネット上の他の外部コンテンツと同様に、組織が信頼する発行元のフィードを使用してください。タイトル、テキスト、画像は発行元のものであり、お客様の確認なしに変わります。
- フィードと画像の両方に HTTPS アドレスを使用してください。ブラウザーは HTTP の画像要求を HTTPS に変更するか、ブロックする場合があります。確実に表示するには、画像の HTTPS アドレスを直接使用してください。
- アドレスに個人用トークンを含むフィードは構成しないでください。そのアドレスは、ページを読み取れるすべてのユーザーおよびフィード サービスと共有されます。
- 共用のコンピューターでは、サインアウト時にブラウザーのサイト データを消去してください。ブラウザーがセッションを復元できる場合、タブを閉じるだけではデータの削除は保証されません。