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
| Question | Ré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âche | Autorisation requise |
|---|---|
| Téléverser le package dans le catalogue d'applications, l'ajouter à Teams | Administrateur SharePoint, ou propriétaire du catalogue d'applications |
| Ajouter le composant WebPart à une page et configurer les flux | Autorisation de modification sur la page |
| Enregistrer la configuration par défaut de l'application personnelle Teams | Autorisation de modification sur une page contenant le composant WebPart |
| Lire les flux, changer de source, filtrer et rechercher | Autorisation 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 :
| Champ | Valeur |
|---|---|
| Sources | Les adresses des flux configurés |
| TenantId | L'ID de votre locataire Microsoft 365 |
| UserId | L'ID d'objet (GUID) de l'utilisateur connecté dans Microsoft Entra ID |
| SiteUrl | L'adresse du site sur lequel le composant WebPart s'exécute |
| ProductId, ProductName, ProductVersion | L'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
| Objet | Ce qui est envoyé | Destination |
|---|---|---|
| Service de flux | Voir le tableau ci-dessus | vitextra.com |
| Vérification de la licence | Le Tenant ID, l'ID d'objet de l'utilisateur, l'adresse du site, l'identifiant, le nom et la version du produit | vitextra.com |
| Configuration de l'application personnelle Teams | Lue à chaque chargement de l'application personnelle ; écrite par Enregistrer les paramètres : les champs de configuration énumérés ci-dessus | vitextra.com |
| Télémétrie d'utilisation | Un é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 erreurs | Azure Application Insights |
| Fichiers du produit | Une requête ordinaire de fichier pour les scripts et les icônes du composant WebPart | static.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
- 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.
- 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.
- 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.
- 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.