Einführung
Ein Webpart, das Inhalte von außerhalb des Unternehmens ins Intranet bringt, wirft für einen Administrator zwei Fragen auf: Was verlässt den Mandanten, und was kommt herein? RSS Reader ist unter den Vitextra-Produkten insofern ungewöhnlich, als seine Inhalte tatsächlich über einen Vitextra-Server laufen – den Feeddienst, der die Feeds herunterlädt. Dieser Artikel beschreibt genau, was diese Anfrage enthält, was das Webpart in Ihrem Mandanten tun darf, wo seine Konfiguration liegt, was es im Browser aufbewahrt und wie es mit dem HTML umgeht, das Herausgeber in ihre Feeds einfügen.
Zusammenfassung für Administratoren
| Frage | Antwort |
|---|---|
| Welche API-Berechtigungen fordert das Paket an? | Keine |
| Liest das Webpart SharePoint-Listen, Dateien oder Benutzerprofile? | Nein |
| Wer lädt die Feeds herunter? | Der Vitextra-Feeddienst, auf Anfrage des Browsers |
| Was enthält die Anfrage an den Feeddienst? | Die Feedadressen, die Mandanten-ID, die Objekt-ID des Benutzers, die Websiteadresse, das Produkt und seine Version |
| Werden Inhalte Ihres Mandanten an Vitextra gesendet? | Nein |
| Wo wird die Konfiguration gespeichert? | In den Webpart-Eigenschaften auf der Seite; für die persönliche Teams-App im Vitextra-Dienst für Ihren Mandanten |
| Was wird im Browser aufbewahrt? | Die zuletzt geladenen Feedelemente im Sitzungsspeicher; Wiederverwendung des Caches für höchstens 30 Minuten |
| Wird Feed-HTML auf der Seite ausgeführt? | Nein – es wird inert analysiert; nur Nur-Text und Bildadressen werden verwendet |
Berechtigungen der Lösung
RSS Reader ist ein SharePoint Framework-Webpart, das aus dem App-Katalog bereitgestellt wird.
- Das Paket fordert keine API-Berechtigungen an. Auf der Seite API-Zugriff des SharePoint Admin Centers erscheint nichts, und das Webpart ruft für Daten weder Microsoft Graph noch die SharePoint-REST-API auf.
- Aus dem Seitenkontext liest es nur, was jedes Webpart hat: das Design, die Sprache, die Websiteadresse (für die Lizenzprüfung und die Feedanfrage) und die Identität des angemeldeten Benutzers (die Objekt-ID, für dieselben Anfragen).
- Es speichert keine Feedinhalte in SharePoint, OneDrive oder Microsoft Entra ID.
Was Benutzer benötigen
| Aufgabe | Erforderliche Berechtigung |
|---|---|
| Das Paket in den App-Katalog hochladen, zu Teams hinzufügen | SharePoint-Administrator oder Besitzer des App-Katalogs |
| Das Webpart einer Seite hinzufügen und die Feeds konfigurieren | Bearbeitungsberechtigung für die Seite |
| Die Standardkonfiguration der persönlichen Teams-App speichern | Bearbeitungsberechtigung für eine Seite mit dem Webpart |
| Die Feeds lesen, Quellen wechseln, filtern und suchen | Leseberechtigung für die Seite |
Wie Feeds geladen werden und was gesendet wird
Browser beschränken websiteübergreifende Skriptanfragen, sofern der Feedherausgeber sie nicht durch CORS-Header erlaubt. RSS Reader verwendet einen serverseitigen Feeddienst unter vitextra.com: Der Browser sendet die Feedadressen, und der Dienst lädt die Feeds herunter, analysiert sie und gibt Kanäle und Elemente als strukturierte Daten zurück.
Jedes Laden und jede automatische Aktualisierung ist eine Anfrage an den Feeddienst mit folgendem Inhalt:
| Feld | Wert |
|---|---|
| Sources | Die Adressen der konfigurierten Feeds |
| TenantId | Die ID Ihres Microsoft 365-Mandanten |
| UserId | Die Objekt-ID (GUID) des angemeldeten Benutzers in Microsoft Entra ID |
| SiteUrl | Die Adresse der Website, auf der das Webpart ausgeführt wird |
| ProductId, ProductName, ProductVersion | Bezeichner, interner Name und Version des Produkts |
Die Antwort enthält die Feedelemente – Titel, Links, Beschreibungen, Datumsangaben, Autoren, Kategorien und Bildadressen – und die Liste der Quellen, die nicht heruntergeladen werden konnten. Der Dienst empfängt keine Inhalte Ihres Mandanten und gibt keine zurück; der Benutzer wird über eine GUID identifiziert, nicht über Namen oder E-Mail-Adresse.
Drei Konsequenzen:
- die konfigurierten Feedadressen werden an den Feeddienst gesendet. Verwenden Sie keine Adressen mit vertraulichen Werten wie persönlichen Tokens oder API-Schlüsseln: Diese Zugangsdaten wären für den Dienst und alle Leser der Seite zugänglich;
- Feeds, die nur innerhalb Ihres Netzwerks erreichbar sind, können nicht angezeigt werden;
- der Browser stellt für den Feed nie eine Verbindung zu den Servern der Herausgeber her. Er verbindet sich mit ihnen für die Bilder der Elemente, die der Browser wie jedes Bild auf einer Webseite direkt lädt – der Herausgeber sieht die gewöhnliche Bildanfrage des Browsers des Benutzers.
📝 Hinweis
Die Verarbeitung dieser Anfragen durch Vitextra ist in der Datenschutzerklärung beschrieben. Die Anfrage teilt dem Dienst mit, mit welchen Feeds eine Seite konfiguriert ist, nicht welche Artikel ein Benutzer öffnet – die Links zu den Artikeln führen direkt zum Herausgeber, und kein Klick wird an Vitextra gemeldet.
Wo die Konfiguration gespeichert wird
Auf einer SharePoint-Seite wird die Konfiguration – die Feeds mit ihren Adressen, Namen und ihrer Reihenfolge, das Layout und die Schalter – in den Eigenschaften des Webparts innerhalb der Seite in der Bibliothek Websiteseiten gespeichert. Jeder, der die Seite lesen kann, kann die Konfiguration lesen; Seitenversionen bewahren frühere Konfigurationen auf.
Für die persönliche Teams-App speichert ein Administrator die Konfiguration mit Einstellungen speichern in der Gruppe Persönliche App (Microsoft Teams). Diese Konfiguration – dieselben Felder, ohne den Webparttitel – wird vom Vitextra-Dienst für Ihren Mandanten und Ihr Produkt gespeichert, weil die persönliche App keine Seite hat, in der sie gespeichert werden könnte. Sie wird von der persönlichen App jedes Benutzers im Mandanten gelesen und vom nächsten Einstellungen speichern überschrieben. Sie enthält nur Einstellungen und Feedadressen, keine Benutzerdaten.
In einer Teams-Kanalregisterkarte wird die Konfiguration mit der Registerkarte gespeichert, wie auf einer Seite.
Was im Browser aufbewahrt wird
Nach erfolgreichem Laden speichert das Webpart die Feedelemente im Sitzungsspeicher, mit der Menge der Feedadressen als Schlüssel. Ein höchstens 30 Minuten alter Cache wird verwendet, während neue Elemente im Hintergrund laden. Diese Frist begrenzt die Wiederverwendung, nicht die automatische Löschung. Der Cache enthält Feedelemente, keine Benutzerinformationen. Er gehört zur Registerkartensitzung und kann bei deren Wiederherstellung erneut verfügbar sein. Der Feedcache selbst verwendet weder lokalen Speicher noch Cookies.
Das Webpart zeichnet nicht auf, welche Artikel ein Benutzer öffnet. Der Browser kann einen Verlauf speichern und verwendet seinen eigenen Status besuchter Links, um geöffnete Titel abzublenden.
Wie Feedinhalte dargestellt werden
Feedelemente enthalten vom Herausgeber geschriebenes HTML – Beschreibungen mit Markup, eingebettete Bilder, manchmal Skripts oder Tracking-Pixel. RSS Reader fügt dieses HTML nie in die Seite ein:
- die Beschreibung wird mit
DOMParserin einem separaten Dokument analysiert; Skripts werden nicht ausgeführt und nur reiner Text wird angezeigt. Die inerte Verarbeitung garantiert nicht, dass keine eingebetteten Ressourcen angefordert werden; - das Bild stammt aus den Medienelementen des Feeds oder der Beschreibung. Bei der Bildsuche in der Beschreibung überspringt das Webpart Bilder mit einer angegebenen Breite oder Höhe von höchstens einem Pixel; dies blockiert nicht alle Tracking-Bilder. Das ausgewählte Bild wird als gewöhnliches
<img>-Element mit der Adresse des Herausgebers angezeigt; - Links öffnen den Originalartikel in einer neuen Registerkarte auf der Website des Herausgebers; das Webpart fügt keine Tracking-Parameter hinzu.
Ein fehlerhaftes Element – fehlende Elemente, defektes Markup – wird mit den vorhandenen Daten angezeigt und verhindert nicht die Darstellung der anderen Elemente.
Anfragen an Vitextra-Dienste
| Zweck | Was gesendet wird | Wohin |
|---|---|---|
| Feeddienst | Siehe die Tabelle oben | vitextra.com |
| Lizenzprüfung | Die Mandanten-ID, die Objekt-ID des Benutzers, die Websiteadresse sowie Bezeichner, Name und Version des Produkts | vitextra.com |
| Konfiguration der persönlichen Teams-App | Gelesen bei jedem Laden der persönlichen App; geschrieben durch Einstellungen speichern: die oben aufgeführten Konfigurationsfelder | vitextra.com |
| Nutzungstelemetrie | Ein Ereignis beim Laden des Webparts: Name und Version des Produkts, ID und Adresse der Website, die Objekt-ID des Benutzers, die Sprache der Benutzeroberfläche und ob das Webpart in Teams ausgeführt wird; technische Details von Fehlern | Azure Application Insights |
| Produktdateien | Eine gewöhnliche Dateianforderung für die Skripts und Symbole des Webparts | static.vitextra.com, vitextra-storage.azureedge.net |
Dieselben Informationen für alle Vitextra-Produkte finden Sie in KB10363. Wo Vitextra-Produkte Ihre Daten speichern: Datenschutz, Datenresidenz und DSGVO.
Netzwerkanforderungen
Erlauben Sie ausgehendes HTTPS aus dem Benutzernetzwerk und dem Teams-Client zu vitextra.com, static.vitextra.com und vitextra-storage.azureedge.net. Wird der Feeddienst blockiert, können keine aktuellen Elemente geladen werden; ohne zuvor geladene Daten erscheint eine Fehlermeldung. Das Blockieren der Hosts für Produktdateien kann das Laden des Webparts verhindern. Bilder stammen von den Hosts der Herausgeber und können fehlen, wenn diese Anfragen blockiert werden.
Empfehlungen
- Verwenden Sie Feeds von Herausgebern, denen Ihre Organisation vertraut, wie bei allen externen Inhalten im Intranet: Titel, Texte und Bilder gehören ihnen und ändern sich ohne Ihre Prüfung.
- Bevorzugen Sie HTTPS-Adressen für Feeds und Bilder. Browser können HTTP-Bildanfragen auf HTTPS umstellen oder blockieren; direkte HTTPS-Bildadressen sorgen für eine zuverlässige Anzeige.
- Konfigurieren Sie keine Feeds, deren Adresse ein persönliches Token enthält; sie werden mit allen geteilt, die die Seite lesen können, und mit dem Feeddienst.
- Löschen Sie auf gemeinsam genutzten Computern beim Abmelden die Websitedaten des Browsers. Das Schließen der Registerkarte allein gewährleistet keine Löschung, wenn der Browser die Sitzung wiederherstellen kann.