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 de flux chargés, pendant 30 minutes au plus de la session de l'onglet
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'écrit rien 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 n'autorisent pas un script d'un site web à télécharger un document depuis un autre site web, sauf si ce site le permet au moyen d'en-têtes cross-origin ; les éditeurs de flux ne le font presque jamais. Un composant WebPart RSS fonctionnant uniquement dans le navigateur échouerait donc pour la plupart des flux. RSS Reader résout ce problème avec un service de flux côté serveur hébergé sur vitextra.com : le navigateur lui envoie la liste des adresses des flux, le service télécharge les flux depuis Internet, les analyse et renvoie les canaux et les é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 que vous configurez sont connues du service de flux. N'utilisez pas de flux dont l'adresse contient elle-même un secret (un jeton personnel ou une clé d'API dans la chaîne de requête) : ces flux ne sont pas destinés à être partagés avec un agrégateur, et ils ne sont de toute façon pas pris en charge, car le service télécharge les flux de façon anonyme ;
  • 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 adresses des flux sont de toute façon visibles dans les onglets de sources) ; 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 écrit les éléments reçus dans le stockage de session du navigateur, indexés par le jeu d'adresses des flux, et les utilise pendant 30 minutes au plus pour afficher instantanément le contenu à la visite suivante pendant que les nouveaux éléments se chargent en arrière-plan. Le cache contient les éléments de flux tels que renvoyés par le service de flux et rien concernant l'utilisateur ; il appartient à la session de l'onglet du navigateur et est supprimé à la fermeture de l'onglet. Le composant WebPart n'utilise ni le stockage local, ni les cookies, ni aucun autre stockage persistant.

Les articles qu'un utilisateur a ouverts ne sont enregistrés nulle part. L'estompage des titres déjà ouverts repose sur la mémoire des liens visités propre au navigateur, qu'aucun script ne peut lire.

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 avec un analyseur inerte (DOMParser), qui n'exécute aucun script et ne charge aucune ressource incorporée, et seul son texte brut est affiché ;
  • l'image d'un élément est tirée des éléments média du flux ou de la première image de la description, et les images d'un pixel — les pixels de suivi typiques — sont ignorées ; l'image est ensuite affichée 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 depuis le réseau des utilisateurs (et depuis le client Teams) vers vitextra.com, static.vitextra.com et vitextra-storage.azureedge.net. Sans le premier hôte, le composant WebPart affiche Désolé, nous avons rencontré un problème… à la place des éléments ; sans les deux autres, il ne se charge pas du tout. Les images des éléments sont chargées depuis les hôtes des éditeurs ; si votre proxy bloque un éditeur, ses éléments apparaissent sans images.

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. Préférez les adresses de flux en HTTPS avec des images en HTTPS ; les images servies en HTTP sont bloquées par le navigateur sur les pages HTTPS.
  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, comme pour toute page de l'intranet ; le cache des flux disparaît de toute façon avec l'onglet.

Articles à la une

Employee Directory : guide de démarrage rapide pour les utilisateurs

Guide de démarrage rapide du composant WebPart Vitextra Employee Directory : rechercher des collègues, utiliser les filtres rapides, changer de vue et regrouper, puis ouvrir la carte de profil pour consulter les coordonnées et contacter la personne dans Microsoft Teams.

47 6 min
Employee Details : présentation de la solution

Vitextra Employee Details est un composant WebPart SharePoint Online qui crée, à partir des données Microsoft 365, une page personnelle complète pour chaque employé : carte de contact, présence, heure locale et disponibilité, responsable et rapports directs, compétences, langues, documents, aperçus et modification du profil en libre-service. Découvrez ce qu'il affiche, comment il fonctionne et ce dont il a besoin.

75 10 min
Announcements Carousel : prise en main du composant WebPart d’annonces SharePoint

Présentation du composant WebPart Vitextra Announcements Carousel pour SharePoint Online : fonctionnalités clés, ajout à une page, choix ou création de la liste d’annonces et gestion des annonces dans Microsoft Lists, y compris l’automatisation avec Power Automate.

57 4 min

Partager