Introduction

Un composant WebPart qui amène sur l'intranet du contenu provenant de l'extérieur de l'entreprise soulève deux questions pour un administrateur : qu'est-ce qui sort du locataire, et qu'est-ce qui y entre. RSS Reader est inhabituel parmi les produits Vitextra en ce que son contenu transite bel et bien par un serveur Vitextra - le service de flux qui télécharge les flux. Cet article indique précisément ce que contient cette requête, ce que le composant WebPart est autorisé à faire dans votre locataire, où réside sa configuration, ce qu'il conserve dans le navigateur et comment il traite le HTML que les éditeurs placent dans leurs flux.

Résumé pour les administrateurs

QuestionRéponse
Quelles autorisations d'API le package demande-t-il ?Aucune
Le composant WebPart lit-il des listes SharePoint, des fichiers ou des profils utilisateur ?Non
Qui télécharge les flux ?Le service de flux Vitextra, à la demande du navigateur
Que contient la requête envoyée au service de flux ?Les adresses des flux, le Tenant ID, l'ID d'objet de l'utilisateur, l'adresse du site, le produit et sa version
Du contenu de votre locataire est-il envoyé à Vitextra ?Non
Où la configuration est-elle stockée ?Dans les propriétés du composant WebPart sur la page ; pour l'application personnelle Teams, dans le service Vitextra pour votre locataire
Qu'est-ce qui est conservé dans le navigateur ?Les derniers éléments chargés dans le stockage de session ; le cache est réutilisé pendant 30 minutes au maximum
Le HTML des flux est-il exécuté dans la page ?Non - il est analysé de façon inerte ; seuls le texte brut et les adresses des images sont utilisés

Autorisations de la solution

RSS Reader est un composant WebPart SharePoint Framework déployé depuis le catalogue d'applications.

  • Le package ne demande aucune autorisation d'API. Rien n'apparaît sur la page Accès aux API (API access) du Centre d'administration SharePoint, et le composant WebPart n'appelle ni Microsoft Graph ni l'API REST SharePoint pour obtenir des données.
  • Du contexte de la page, il ne lit que ce dont dispose tout composant WebPart : le thème, la langue, l'adresse du site (pour la vérification de licence et la requête de flux) et l'identité de l'utilisateur connecté (l'ID d'objet, pour les mêmes requêtes).
  • Il n’enregistre pas le contenu des flux dans SharePoint, OneDrive ou Microsoft Entra ID.

Ce dont les utilisateurs ont besoin

TâcheAutorisation requise
Téléverser le package dans le catalogue d'applications, l'ajouter à TeamsAdministrateur SharePoint, ou propriétaire du catalogue d'applications
Ajouter le composant WebPart à une page et configurer les fluxAutorisation de modification sur la page
Enregistrer la configuration par défaut de l'application personnelle TeamsAutorisation de modification sur une page contenant le composant WebPart
Lire les flux, changer de source, filtrer et rechercherAutorisation de lecture sur la page

Comment les flux sont chargés et ce qui est envoyé

Les navigateurs limitent les requêtes de scripts entre origines, sauf si l’éditeur du flux les autorise par des en-têtes CORS. RSS Reader utilise un service de flux côté serveur sur vitextra.com : le navigateur lui envoie les adresses, puis le service télécharge et analyse les flux et renvoie les canaux et éléments sous forme de données structurées.

Chaque chargement et chaque actualisation automatique constituent une requête au service de flux, dont voici le contenu :

ChampValeur
SourcesLes adresses des flux configurés
TenantIdL'ID de votre locataire Microsoft 365
UserIdL'ID d'objet (GUID) de l'utilisateur connecté dans Microsoft Entra ID
SiteUrlL'adresse du site sur lequel le composant WebPart s'exécute
ProductId, ProductName, ProductVersionL'identifiant, le nom interne et la version du produit

La réponse contient les éléments des flux - titres, liens, descriptions, dates, auteurs, catégories et adresses des images - ainsi que la liste des sources qui n'ont pas pu être téléchargées. Le service ne reçoit ni ne renvoie aucun contenu de votre locataire ; l'utilisateur est identifié par un GUID, et non par son nom ou son adresse e-mail.

Trois conséquences :

  • les adresses des flux configurés sont transmises au service. N’utilisez pas d’adresses contenant des secrets, tels que des jetons personnels ou des clés d’API : ces identifiants seraient accessibles au service et à toute personne pouvant lire la page ;
  • les flux accessibles uniquement à l'intérieur de votre réseau ne peuvent pas être affichés ;
  • le navigateur ne se connecte jamais aux serveurs des éditeurs pour le flux. Il s'y connecte en revanche pour les images des éléments, qui sont chargées directement par le navigateur comme n'importe quelle image d'une page web - l'éditeur voit la requête d'image ordinaire du navigateur de l'utilisateur.

📝 Remarque
Le traitement de ces requêtes par Vitextra est décrit dans la Politique de confidentialité. La requête indique au service avec quels flux une page est configurée, et non quels articles un utilisateur ouvre - les liens vers les articles mènent directement à l'éditeur, et aucun clic n'est signalé à Vitextra.

Où la configuration est stockée

Sur une page SharePoint, la configuration - les flux avec leurs adresses, noms et ordre, la mise en page et les commutateurs - est stockée dans les propriétés du composant WebPart, à l'intérieur de la page dans la bibliothèque Pages du site. Toute personne qui peut lire la page peut lire la configuration ; les versions de la page conservent les configurations antérieures.

Pour l'application personnelle Teams, un administrateur enregistre la configuration avec Enregistrer les paramètres dans le groupe Application personnelle (Microsoft Teams). Cette configuration - les mêmes champs, sans le titre du composant WebPart - est stockée par le service Vitextra pour votre locataire et votre produit, car l'application personnelle n'a aucune page où la stocker. Elle est lue par l'application personnelle de chaque utilisateur du locataire et remplacée par le prochain Enregistrer les paramètres. Elle ne contient que des paramètres et des adresses de flux, aucune donnée utilisateur.

Dans un onglet de canal Teams, la configuration est stockée avec l'onglet, comme sur une page.

Ce qui est conservé dans le navigateur

Après un chargement réussi, le composant WebPart conserve les éléments dans le stockage de session, avec l’ensemble des adresses comme clé. Un cache datant de 30 minutes au maximum est réutilisé pendant le chargement des éléments récents en arrière-plan. Ce délai limite la réutilisation, sans déclencher de suppression automatique. Le cache contient des éléments de flux, aucune information sur l’utilisateur. Il appartient à la session de l’onglet et peut être rétabli lors de la restauration de cette session. Le cache des flux lui-même n’utilise ni stockage local ni cookies.

Le composant WebPart n’enregistre pas les articles ouverts par l’utilisateur. Le navigateur peut conserver un historique et utilise son propre état des liens visités pour estomper les titres déjà ouverts.

Comment le contenu des flux est affiché

Les éléments de flux contiennent du HTML écrit par l'éditeur - des descriptions avec balisage, des images incorporées, parfois des scripts ou des pixels de suivi. RSS Reader n'insère jamais ce HTML dans la page :

  • la description est analysée dans un document séparé avec DOMParser : les scripts ne sont pas exécutés et seul le texte brut est affiché. Cette analyse inerte ne garantit pas l’absence de requêtes vers des ressources incorporées ;
  • l’image provient des éléments média du flux ou de la description. Lors de la recherche dans la description, le composant ignore les images dont la largeur ou la hauteur déclarée est inférieure ou égale à un pixel ; cela ne bloque pas toutes les images de suivi. L’image choisie s’affiche comme un élément <img> ordinaire avec l’adresse de l’éditeur ;
  • les liens ouvrent l'article d'origine dans un nouvel onglet sur le site de l'éditeur ; le composant WebPart n'ajoute aucun paramètre de suivi.

Un élément malformé - éléments manquants, balisage corrompu - est affiché avec les données dont il dispose et n'empêche pas l'affichage des autres éléments.

Requêtes vers les services Vitextra

ObjetCe qui est envoyéDestination
Service de fluxVoir le tableau ci-dessusvitextra.com
Vérification de la licenceLe Tenant ID, l'ID d'objet de l'utilisateur, l'adresse du site, l'identifiant, le nom et la version du produitvitextra.com
Configuration de l'application personnelle TeamsLue à chaque chargement de l'application personnelle ; écrite par Enregistrer les paramètres : les champs de configuration énumérés ci-dessusvitextra.com
Télémétrie d'utilisationUn événement au chargement du composant WebPart : le nom et la version du produit, l'ID et l'adresse du site, l'ID d'objet de l'utilisateur, la langue de l'interface et le fait que le composant WebPart s'exécute ou non dans Teams ; les détails techniques des erreursAzure Application Insights
Fichiers du produitUne requête ordinaire de fichier pour les scripts et les icônes du composant WebPartstatic.vitextra.com, vitextra-storage.azureedge.net

Pour les mêmes informations à l'échelle de tous les produits Vitextra, voir KB10363. Où les produits Vitextra stockent vos données : confidentialité, résidence des données et RGPD.

Exigences réseau

Autorisez le trafic HTTPS sortant du réseau des utilisateurs et du client Teams vers vitextra.com, static.vitextra.com et vitextra-storage.azureedge.net. Le blocage du service de flux empêche le chargement des éléments récents ; une erreur apparaît si aucune donnée précédente n’est disponible. Le blocage des hôtes de fichiers du produit peut empêcher le chargement du composant WebPart. Les images proviennent des hôtes des éditeurs et peuvent manquer si ces requêtes sont bloquées.

Recommandations

  1. Utilisez les flux d'éditeurs auxquels votre organisation fait confiance, comme pour tout contenu externe sur l'intranet : les titres, les textes et les images sont les leurs et changent sans votre relecture.
  2. Privilégiez les adresses HTTPS pour les flux et les images. Le navigateur peut convertir les requêtes d’images HTTP en HTTPS ou les bloquer ; utilisez directement des adresses HTTPS pour un affichage fiable.
  3. Ne configurez pas de flux dont l'adresse contient un jeton personnel ; ils sont partagés avec toute personne qui peut lire la page et avec le service de flux.
  4. Sur les ordinateurs partagés, effacez les données de site du navigateur à la déconnexion. Fermer l’onglet ne garantit pas leur suppression si le navigateur peut restaurer la session.

Questions et réponses

Posez une question sur cet article et obtenez une réponse officielle de notre équipe.

Aucune question pour le moment. Posez la première !

Articles à la une

Discussions : questions fréquentes

Réponses courtes aux questions courantes sur le composant WebPart Vitextra Discussions pour SharePoint Online et Microsoft Teams : si Viva Engage est nécessaire, où le contenu est stocké, le renommage des listes, les autorisations d'API, qui peut lire, publier et modérer, les invités, les modes de forum et les catégories, l'approbation et la visibilité, les notifications, l'importation d'un Forum de discussion classique, Teams et le mobile, les langues, les limites, la version d'évaluation et les plans.

14 min
Comment les demandes d'absence et les remplacements fonctionnent ensemble

Référence sur le lien entre les demandes d'absence et les remplacements dans Vitextra Absence & Coverage : quand un remplacement est créé, ce qui se passe à l'approbation, au refus et à l'annulation, comment apparaissent les absences non couvertes et pourquoi les remplacements autonomes se comportent différemment.

99 6 min
Employee Details : renseigner Je me présente, centres d’intérêt, responsabilités, projets précédents et écoles

Comment renseigner la carte Je me présente de votre page Vitextra Employee Details : rédigez un court texte sur vous-même et tenez à jour les listes de centres d'intérêts, de responsabilités, de projets précédents et d'écoles, un élément par ligne. Découvrez comment le texte est affiché, qui le voit et quoi écrire.

96 4 min

Partager