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

FrageAntwort
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

AufgabeErforderliche Berechtigung
Das Paket in den App-Katalog hochladen, zu Teams hinzufügenSharePoint-Administrator oder Besitzer des App-Katalogs
Das Webpart einer Seite hinzufügen und die Feeds konfigurierenBearbeitungsberechtigung für die Seite
Die Standardkonfiguration der persönlichen Teams-App speichernBearbeitungsberechtigung für eine Seite mit dem Webpart
Die Feeds lesen, Quellen wechseln, filtern und suchenLeseberechtigung 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:

FeldWert
SourcesDie Adressen der konfigurierten Feeds
TenantIdDie ID Ihres Microsoft 365-Mandanten
UserIdDie Objekt-ID (GUID) des angemeldeten Benutzers in Microsoft Entra ID
SiteUrlDie Adresse der Website, auf der das Webpart ausgeführt wird
ProductId, ProductName, ProductVersionBezeichner, 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 DOMParser in 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

ZweckWas gesendet wirdWohin
FeeddienstSiehe die Tabelle obenvitextra.com
LizenzprüfungDie Mandanten-ID, die Objekt-ID des Benutzers, die Websiteadresse sowie Bezeichner, Name und Version des Produktsvitextra.com
Konfiguration der persönlichen Teams-AppGelesen bei jedem Laden der persönlichen App; geschrieben durch Einstellungen speichern: die oben aufgeführten Konfigurationsfeldervitextra.com
NutzungstelemetrieEin 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 FehlernAzure Application Insights
ProduktdateienEine gewöhnliche Dateianforderung für die Skripts und Symbole des Webpartsstatic.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

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Fragen und Antworten

Stellen Sie eine Frage zu diesem Artikel und erhalten Sie eine offizielle Antwort von unserem Team.

Noch keine Fragen. Stellen Sie die erste Frage.

Ausgewählte Artikel

Discussions in der SharePoint Mobile App und in Teams Mobile

Was das Vitextra-Discussions-Webpart auf dem Smartphone bietet: wo es läuft (SharePoint Mobile App, Browser des Smartphones, Microsoft Teams Mobile als Kanalregisterkarte oder persönliche App), wie sich Themenliste, Themenseite und Antwort-Thread an einen schmalen Bildschirm anpassen, wie Sie vom Smartphone aus antworten, ein Foto von der Kamera einfügen, eine Datei anhängen und eine Kollegin oder einen Kollegen erwähnen, was Moderatoren unterwegs tun können, was weiterhin einen Desktopbrowser erfordert und welche Grenzen der Editor auf Touchgeräten hat.

51 5 Min.
Wo Password Vault Ihre Kennwörter speichert: Der App-Ordner in OneDrive

Wo das Vitextra-Webpart Password Vault Ihre Anmeldeinformationen aufbewahrt: eine verschlüsselte Datei, vitextra-password-vault.json, im App-Ordner Ihres eigenen OneDrive; ein Tresor pro Benutzer auf allen Seiten und in Teams; automatische Erstellung; was passiert, wenn die Datei gelöscht oder verschoben wird; OneDrive-Voraussetzungen; wie auf zwei Geräten vorgenommene Änderungen zusammengeführt werden; und was nach der Umstellung auf das neue Dateiformat aktualisiert werden muss.

41 6 Min.
So fügen Sie das Short URL Management-Webpart hinzu und konfigurieren es

Schritt-für-Schritt-Anleitung zum Hinzufügen des Vitextra Short URL Management-Webparts zu einer SharePoint Online-Seite, zum Festlegen seines Titels, zum Genehmigen der verwendeten Microsoft Graph-Berechtigungen und zur Prüfung, ob die Liste der Kurzlinks geladen wird.

21 3 Min.

Teilen