QR Code Generator Introduction
Un code QR contient souvent des données qui ne doivent pas sortir de l'entreprise : un lien interne, un numéro de téléphone, le mot de passe d'un réseau invité. Avant d'autoriser sur l'intranet un outil qui crée de tels codes, un administrateur veut savoir où vont ces données. Cet article répond à la question pour QR Code Generator : où le code est créé, ce que la solution est autorisée à faire, où les données saisies sont stockées et quelles requêtes le composant WebPart envoie en dehors du tenant.
L'essentiel pour les administrateurs
| Question | Réponse |
|---|---|
| Où le code QR est-il généré ? | Dans le navigateur de l'utilisateur |
| Les données encodées sont-elles envoyées à Vitextra ou à un tiers ? | Non |
| 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 |
| Où une configuration enregistrée est-elle stockée ? | Dans les propriétés du composant WebPart, à l'intérieur de la page SharePoint |
| Qui peut lire une configuration enregistrée ? | Toute personne qui peut ouvrir la page |
| Qu'est-ce qui est envoyé aux services Vitextra ? | Des identifiants techniques pour la vérification de la licence et la télémétrie d'utilisation ; aucun contenu des codes |
Le code est généré dans le navigateur
Le composant WebPart transforme les données saisies en code QR au moyen d'un script qui s'exécute dans le navigateur. Les données des champs ne sont pas envoyées à un serveur pour y être encodées, et l'image est dessinée sur l'appareil de l'utilisateur. Télécharger et Copier fonctionnent eux aussi dans le navigateur : le fichier est créé localement, puis placé dans le dossier de téléchargements ou dans le Presse-papiers.
Autorisations de la solution
QR Code Generator 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 pour approbation sur la page API access du SharePoint admin center, et le composant WebPart n'appelle pas Microsoft Graph.
- Le composant WebPart ne lit ni ne modifie aucune liste, bibliothèque, fichier ou profil utilisateur. De la page, il ne récupère que l'adresse du site actuel, pour préremplir le champ URL.
- Le logo chargé n'est pas enregistré dans une bibliothèque : il est conservé dans la configuration du composant WebPart.
Ce dont les utilisateurs ont besoin
| Tâche | Autorisation requise |
|---|---|
| Téléverser le package dans le catalogue d'applications | Administrateur SharePoint, ou propriétaire du catalogue d'applications |
| Ajouter le composant WebPart à une page, enregistrer un code préparé | Autorisation de modification sur la page |
| Voir le code préparé, créer, copier et télécharger des codes | Autorisation de lecture sur la page |
Où une configuration enregistrée est stockée
Lorsqu'une page contenant le composant WebPart est modifiée puis enregistrée, toute la configuration du générateur est enregistrée avec elle : les valeurs des champs de tous les onglets de données, l'apparence, le logo et la taille. Techniquement, il s'agit de l'une des propriétés du composant WebPart, stockée à l'intérieur de la page dans la bibliothèque Site Pages du site.
Trois conséquences en découlent.
Les données sont stockées en clair. La configuration n'est pas chiffrée. Les champs, y compris Mot de passe dans l'onglet Wi-Fi, sont affichés comme du texte ordinaire à côté du code.
Les autorisations de la page sont celles des données. Toute personne qui peut ouvrir la page peut lire tout ce qui est enregistré dans le composant WebPart. Le composant WebPart ne dispose d'aucun paramètre permettant de masquer les champs aux lecteurs.
Les versions précédentes sont conservées. SharePoint conserve l'historique des versions d'une page. Un mot de passe enregistré dans le composant WebPart puis remplacé reste présent dans les versions antérieures de la page, accessibles à ceux qui peuvent consulter l'historique des versions.
❗ Important
N'enregistrez pas dans le composant WebPart les mots de passe des réseaux de l'entreprise ni d'autres secrets. Utilisez-le pour des données que toute l'audience de la page est autorisée à connaître, comme le mot de passe d'un réseau invité sur une page destinée aux employés.
Les données qu'un visiteur saisit sur une page publiée sans la modifier ne sont stockées nulle part. Elles existent dans le navigateur jusqu'à la fermeture ou au rechargement de la page.
Requêtes vers les services Vitextra
Le composant WebPart contacte des services extérieurs au tenant dans trois buts. Aucune de ces requêtes ne contient les données saisies dans le générateur ni le code généré.
| Objet | Ce qui est envoyé | Destination |
|---|---|---|
| Vérification de la licence | L'ID du tenant, l'ID du compte d'utilisateur dans Microsoft Entra ID, l'adresse du site, l'identifiant, le nom et la version du produit | 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 du compte d'utilisateur, la langue de l'interface et le fait que le composant WebPart s'exécute ou non dans Teams | Azure Application Insights |
| Chargement des fichiers du produit | Rien d'autre qu'une requête ordinaire de fichier : les scripts du composant WebPart et ses icônes sont téléchargés depuis le réseau de distribution de contenu de Vitextra | static.vitextra.com, vitextra-storage.azureedge.net |
Dans ces requêtes, l'utilisateur est identifié par l'ID de son compte — un GUID —, et non par son nom ou son adresse e-mail.
📝 Remarque
Si votre organisation restreint les connexions sortantes, autorisez les hôtes indiqués ci-dessus. Sans accès au réseau de distribution de contenu, le composant WebPart ne peut pas se charger. Le traitement des données par Vitextra est décrit dans la Politique de confidentialité.
Ce que contient un code QR
Un code QR n'est protégé d'aucune manière. Il contient les données elles-mêmes, et n'importe quel lecteur les affiche. Trois points méritent d'être retenus :
- un code contenant un mot de passe est aussi confidentiel que ce mot de passe — quiconque possède une photo du code possède le mot de passe ;
- un code n'expire pas et ne peut pas être révoqué. Pour rendre un code imprimé inutilisable, modifiez ce vers quoi il pointe : le mot de passe du réseau, l'adresse de la page ;
- un code contenant un lien interne ne s'ouvre que pour les personnes qui ont accès à la page liée ; le code lui-même ne révèle que l'adresse.
Recommandations
- Publiez les codes contenant des données sensibles sur des pages dont l'audience correspond à celle du code, et vérifiez les autorisations de la page avant de publier.
- N'utilisez l'onglet Wi-Fi que pour les réseaux invités, et renouvelez le code lorsque le mot de passe est modifié.
- Avant de publier, videz les champs des onglets inutilisés — leurs valeurs sont elles aussi enregistrées.
- Lorsqu'un lien suffit, préférez l'onglet URL avec un lien vers une page protégée à un code qui contient les données elles-mêmes.
Résumé
QR Code Generator crée le code dans le navigateur, ne nécessite aucune autorisation d'API et ne lit rien dans SharePoint. Le seul endroit où les données saisies sont conservées est la page sur laquelle un éditeur les enregistre, et ces données y sont aussi accessibles que la page elle-même.
💡 Astuce
La façon dont un code préparé est enregistré et ce que voient les visiteurs de la page sont décrits dans KB10269. Publier un code QR préconfiguré sur une page SharePoint.
