Richtlinien für Berechtigungswarnungen

Chrome-Erweiterungen verbessern die Nutzererfahrung im Browser. Dazu verwenden Sie Chrome APIs, für die bestimmte Berechtigungen erforderlich sind. Einige Berechtigungen sind weniger aufdringlich und zeigen keine Warnung an. Andere Berechtigungen lösen eine Warnung aus, die die Nutzer zulassen müssen. Auf dieser Seite finden Sie Richtlinien zum Umgang mit Berechtigungswarnungen. Spezifische Warnungen sind in den Berechtigungen unter der Berechtigung aufgeführt, für die sie gelten.

Abbildung 1: Dialogfeld mit Berechtigungswarnungen, die bei der Installation angezeigt wird.

Wenn eine neue Berechtigung hinzugefügt wird, die eine Warnung auslöst, wird die Erweiterung deaktiviert, bis der Nutzer die neue Berechtigung akzeptiert. Wie Sie dieses Verhalten testen können, erfahren Sie unter Berechtigungen aktualisieren.

Abbildung 2: Eine Erweiterung, die deaktiviert bleibt, bis der Nutzer die neue Berechtigung akzeptiert.

Für einige Berechtigungen werden in Kombination mit anderen Berechtigungen möglicherweise keine Warnungen angezeigt. Die Warnung "tabs" wird beispielsweise nicht angezeigt, wenn die Erweiterung auch "<all_urls>" anfordert.

Best Practices

Berechtigungswarnungen beschreiben die Funktionen, die eine API gewährt. Einige Warnungen sind jedoch schwerer zu verstehen als andere. Die Wahrscheinlichkeit, dass Nutzer Erweiterungen installieren, ist höher:

Relevante Berechtigungen anfordern

Erweiterungen sollen einem einzigen Zweck dienen und der Richtlinie zur Verwendung von Berechtigungen entsprechen. Fordern Sie nur Berechtigungen an, die die Hauptfunktion der Erweiterung unterstützen.

Optionale Berechtigungen verwenden

Verbessern Sie das Onboarding, indem Sie Berechtigungen zur Laufzeit anfordern. So können Sie mehr Kontext für eine bestimmte Berechtigung bereitstellen und Nutzer auswählen, welche Funktionen sie aktivieren möchten. Weitere Informationen zur Implementierung finden Sie unter Permissions API.

Die Berechtigung „activeTab“ verwenden

Bei dieser Berechtigung wird keine Warnung zu einer Berechtigung angezeigt. Er gewährt der Website, auf der sich der Nutzer befindet, eine temporäre Hostberechtigung. Weitere Informationen finden Sie unter Informationen zur Berechtigung „activeTab“.

Warnungen ansehen

Sie haben folgende Möglichkeiten, die Berechtigungswarnungen einer Erweiterung aufzurufen:

Test-Tool für die Aktualisierung von Erweiterungen verwenden

Hinweis

1. Installieren Sie Node.js und NPM.
2. Chromium installieren
3. Klonen Sie das Repository extension-update-testing-tool.
4. Führen Sie npm install im Stammverzeichnis des Repositorys aus.

Verwendung des Tools

1. Führen Sie npm start aus.
2. Öffnen Sie den lokalen Server in Chromium unter http://localhost:8080.
3. Ziehen Sie eine entpackte Erweiterung (Ordner oder ZIP-Datei) auf die Seite.
4. Folgen Sie der Anleitung unter „Manuell installieren“, um die Erweiterung herunterzuladen und zu installieren.

Durch manuelles Packen der Erweiterung

1. Zu chrome://extensions wechseln
2. Entwicklermodus aktivieren
3. Klicken Sie auf Erweiterung packen.

   

   Abbildung 3: Aktivierung des Entwicklermodus auf der Seite zum Verwalten von Erweiterungen

4. Geben Sie im Feld für das Stammverzeichnis der Erweiterung den Pfad zum Ordner der Erweiterung an. Ignorieren Sie bei einem erstmaligen Paket das Feld Privater Schlüssel.

5. Klicken Sie auf die Schaltfläche Erweiterung packen.

   

   Abbildung 4: Erweiterungspfad angeben

6. Chrome erstellt zwei Dateien, eine .crx-Datei und eine .pem-Datei. Die Datei .pem enthält den privaten Schlüssel, mit dem die Erweiterung signiert wurde. Merken Sie sich, in welchem Verzeichnis diese Dateien gespeichert wurden.

   

   Abbildung 5: Gepackte Erweiterungsdateien

7. Bewahren Sie die Datei .pem an einem geheimen und sicheren Ort auf. Sie ist erforderlich, um die Erweiterung zu aktualisieren.

8. Installieren Sie die Datei .crx, indem Sie sie auf die Verwaltungsseite der Erweiterung ziehen.

   

   Abbildung 6: Zu installierende Datei ablegen

9. Nachdem Sie die .crx-Datei abgelegt haben, werden Sie vom Browser gefragt, ob die Erweiterung hinzugefügt werden kann, und es werden Warnungen angezeigt.

   

   Abbildung 7: Warnung für die Erweiterung „Neuer Tab“

Berechtigungen aktualisieren

Wenn eine Erweiterung eine neue Berechtigung hinzufügt, die eine Warnung auslöst, kann sie vorübergehend deaktiviert werden. Die Erweiterung wird erst wieder aktiviert, wenn der Nutzer zustimmt, die neue Berechtigung zu akzeptieren.

So prüfen Sie, ob Ihre Erweiterung beim Hinzufügen einer neuen Berechtigung deaktiviert wird:

Aktualisierung mit dem Testtool für die Aktualisierung von Erweiterungen

Bei diesen Schritten wird davon ausgegangen, dass Sie den Server gemäß der Anleitung unter Test-Tool für die Aktualisierung von Erweiterungen verwenden gestartet haben.

Verwendung des Tools

1. Fügen Sie eine neue Berechtigung mit Warnung hinzu.
2. Geben Sie einen höheren Wert für die Versionsnummer der Erweiterung an.
3. Ziehen Sie die entpackte Erweiterung (Ordner oder ZIP-Datei) auf die Seite.
4. Öffnen Sie chrome://extensions.
5. Klicken Sie auf die Schaltfläche Aktualisieren.

Erweiterung manuell aktualisieren

1. Suchen Sie die Datei .crx, die Sie gerade unter Warnungen ansehen erstellt haben.
2. Benennen Sie sie um oder löschen Sie sie.
3. Öffnen Sie die manifest.json und fügen Sie alle Berechtigungen hinzu, die eine Warnung auslösen.
4. Öffnen Sie chrome://extensions. Entfernen Sie das zuvor installierte Paket nicht.
5. Packen Sie die Erweiterung noch einmal, aber fügen Sie diesmal die PEM-Datei in der zweiten Eingabe hinzu.

   

   Abbildung 8: Dialogfeld für die Packungserweiterung mit PEM-Datei.

6. Ziehen Sie die neue gepackte Erweiterung auf die Seite „Erweiterungsverwaltung“.

7. Daraufhin wird ein Dialogfeld angezeigt, in dem der Nutzer aufgefordert wird, die neuen Berechtigungen zu akzeptieren.

   

   Abbildung 9: Warnung bei deaktivierter Erweiterung

   

   Abbildung 10: Dialogfeld zum Anfordern einer neuen Berechtigung