Consignes concernant les avertissements concernant les autorisations

Les extensions Chrome améliorent l'expérience utilisateur. Pour ce faire, les extensions utilisent des API Chrome qui nécessitent certaines autorisations. Certaines autorisations sont moins intrusives et n'affichent pas d'avertissement. Les autres autorisations déclenchent un avertissement que les utilisateurs doivent accorder. Cette page fournit des instructions concernant l'utilisation des avertissements d'autorisation. Les avertissements spécifiques sont notés dans la section Autorisations sous l'autorisation à laquelle ils s'appliquent.

Figure 1: La boîte de dialogue d'avertissements concernant les autorisations s'affiche lors de l'installation.

Lorsqu'une nouvelle autorisation déclenche un avertissement est ajoutée, l'extension est désactivée jusqu'à ce que l'utilisateur accepte la nouvelle autorisation. Pour découvrir comment tester ce comportement, consultez la section Mettre à jour les autorisations.

Figure 2: Extension désactivée jusqu'à ce que l'utilisateur accepte la nouvelle autorisation

Certaines autorisations peuvent ne pas afficher d'avertissements lorsqu'elles sont associées à d'autres autorisations. Par exemple, l'avertissement "tabs" ne s'affiche pas si l'extension demande également "<all_urls>".

Bonnes pratiques

Les avertissements concernant les autorisations décrivent les fonctionnalités accordées par une API, mais certains sont plus difficiles à comprendre que d'autres. Les utilisateurs sont plus susceptibles d'installer des extensions qui respectent ces consignes:

Demander les autorisations appropriées

Les extensions doivent remplir une seule fonction et respecter le règlement sur l'utilisation des autorisations. Veillez à ne demander que des autorisations compatibles avec la fonctionnalité principale de l'extension.

Utiliser des autorisations facultatives

Améliorez l'expérience d'intégration en demandant des autorisations lors de l'exécution. Cela vous permet de fournir plus de contexte sur une autorisation particulière et de permettre aux utilisateurs de choisir les fonctionnalités qu'ils souhaitent activer. Consultez API Permissions pour en savoir plus sur l'implémentation.

Utiliser l'autorisation "activeTab"

Cette autorisation n'affiche pas d'avertissement. Il accorde une autorisation d'hôte temporaire au site sur lequel se trouve l'utilisateur. Pour en savoir plus, consultez Comprendre l'autorisation activeTab.

Afficher les avertissements

Pour afficher les avertissements d'autorisation d'une extension, vous disposez des options suivantes:

Utiliser l'outil de test de mise à jour des extensions

Avant de commencer

1. Installez Node.js et NPM.
2. Installez Chromium.
3. Clonez le dépôt extension-update-testing-tool.
4. Exécutez npm install à la racine du dépôt.

Utiliser l'outil

1. Exécutez npm start.
2. Ouvrez le serveur local à l'adresse http://localhost:8080 dans Chromium.
3. Faites glisser une extension non empaquetée (dossier ou fichier .zip) sur la page.
4. Suivez les instructions de la section "Installer manuellement" pour télécharger et installer l'extension.

En empaquetant manuellement l'extension

1. Accéder à chrome://extensions
2. Activer le mode développeur
3. Cliquez sur Empaqueter l'extension.

   

   Figure 3: Mode développeur activé sur la page "Gestion des extensions"

4. Indiquez le chemin d'accès au dossier de l'extension dans le champ du répertoire racine de l'extension. Ignorez le champ Private key (Clé privée) pour un package de première fois.

5. Cliquez sur le bouton Empaqueter l'extension.

   

   Figure 4: Spécification du chemin d'accès de l'extension

6. Chrome crée deux fichiers : un fichier .crx et un fichier .pem. Le fichier .pem contient la clé privée utilisée pour signer l'extension. Assurez-vous de vous souvenir du répertoire dans lequel ces fichiers ont été enregistrés.

   

   Figure 5: Fichiers d'extension empaquetés

7. Conservez le fichier .pem dans un endroit secret et sécurisé. Vous en aurez besoin pour mettre à jour l'extension.

8. Installez le fichier .crx en le déposant dans la page de gestion de l'extension.

   

   Figure 6: Déposez le fichier pour l'installer

9. Après avoir supprimé le fichier .crx, le navigateur vous demande si l'extension peut être ajoutée et affiche des avertissements.

   

   Figure 7: Avertissement concernant l'extension "Nouvel onglet"

Modifier les autorisations

Lorsqu'une extension ajoute une autorisation qui déclenche un avertissement, elle peut la désactiver temporairement. L'extension ne sera réactivée qu'une fois que l'utilisateur aura accepté la nouvelle autorisation.

Pour vérifier si votre extension sera désactivée lors de l'ajout d'une autorisation, vous disposez des options suivantes:

Effectuer une mise à jour à l'aide de l'outil de test des mises à jour des extensions

Cette procédure suppose que vous avez suivi les instructions de l'article Utiliser l'outil de test de mise à jour des extensions pour démarrer le serveur.

Utiliser l'outil

1. Ajoutez une autorisation avec avertissement.
2. Augmentez le numéro de version de l'extension.
3. Faites glisser l'extension non empaquetée (dossier ou fichier .zip) sur la page.
4. Accédez à chrome://extensions.
5. Cliquez sur le bouton Mettre à jour.

Mettre à jour votre extension manuellement

1. Recherchez le fichier .crx que vous venez de créer dans Afficher les avertissements.
2. Renommez-le ou supprimez-le.
3. Ouvrez manifest.json et ajoutez toute autorisation qui déclenche un avertissement.
4. Accédez à chrome://extensions. Ne supprimez pas le package précédemment installé.
5. Empaquetez à nouveau l'extension, mais cette fois, ajoutez le fichier .pem dans la deuxième entrée.

   

   Figure 8: Empaquetage de la boîte de dialogue de l'extension avec le fichier .pem inclus

6. Faites glisser la nouvelle extension empaquetée vers la page "Gestion des extensions".

7. Une boîte de dialogue s'affiche et invite l'utilisateur à accepter les nouvelles autorisations.

   

   Figure 9: Avertissement concernant la désactivation des extensions

   

   Figure 10: Boîte de dialogue "Demander une nouvelle autorisation"