Referenzhandbuch für IAM-Berechtigungen

Dieses Dokument enthält Referenzinformationen zum Konfigurieren von Test Lab-IAM-Berechtigungen und -Rollen. Wenn Sie detailliertere Rollen konfigurieren möchten, bietet Test Lab Berechtigungen zum Ausführen von Tests und zum Streamen von Geräten mit Android Studio. Für die Testausführung sind zusätzliche Anforderungen erforderlich, um Berechtigungen und Rollen für IAM und die Streaminggeräte richtig zu konfigurieren.

Testausführung

Damit Sie Test Lab richtig konfigurieren und Tests ausführen und die Ergebnisse lesen können, müssen Sie den Zugriff auf Cloud Storage-Buckets konfigurieren. Dazu ist eine bestimmte Konfiguration von Berechtigungen erforderlich, die nicht alle in den standardmäßigen vordefinierten Firebase-Rollen enthalten sind. Verwenden Sie eine der folgenden Optionen, um Zugriff auf Test Lab zu gewähren.

Tests über die Firebase Console

Für Tests, die über die Firebase-Konsole oder die Firebase Test Lab-Gerätematrix in Android Studio gestartet wurden:

  1. Testen Sie Ihre App in einem separaten Firebase-Projekt.
  2. Fügen Sie Nutzer hinzu, die Test Lab-Zugriff benötigen, und weisen Sie ihnen über die Firebase-Konsole alte Projektrollen zu.
  3. Optional: Weisen Sie die Projektrolle Bearbeiter zu, damit ein Nutzer Tests mit Test Lab ausführen kann.
  4. Optional: Weisen Sie die Projektrolle Betrachter zu, damit ein Nutzer Testergebnisse mit Test Lab ansehen kann.

Tests über die gcloud-CLI

Für Tests, die über die gcloud CLI, die Testing API oder von Gradle verwaltete Geräte gestartet werden, wird standardmäßig ein von Firebase erstellter Cloud Storage-Bucket verwendet. Dazu muss das Prinzipal, das den Test ausführt, die Rolle „roles/editor“ für Ihr Firebase-Projekt haben.

Wenn Sie diese Rolle nicht zuweisen können oder detaillierte Testergebnisse länger als 90 Tage aufbewahren möchten, können Sie diese Testergebnisse mit der gcloud-Befehlszeilenoption --results-bucket an einen Cloud Storage-Bucket senden, der Ihnen gehört.

Wenn Sie Ihren eigenen Cloud Storage-Bucket verwenden:

  1. Weisen Sie über die Google Cloud-Konsole ein Paar vordefinierter Rollen zu, die zusammen die erforderlichen Berechtigungen gewähren.
  2. Wenn ein Nutzer Tests mit Test Lab ausführen soll, weisen Sie ihm die Rollen „Firebase Test Lab-Administrator“ (roles/cloudtestservice.testAdmin) und „Firebase Analytics-Betrachter“ (roles/firebase.analyticsViewer) zu.
  3. Wenn ein Nutzer Testergebnisse in Test Lab aufrufen soll, weisen Sie ihm die Rollen „Firebase Test Lab-Betrachter“ (roles/cloudtestservice.testViewer) und „Firebase Analytics-Betrachter“ (roles/firebase.analyticsViewer) zu.

Berechtigungen für Device Streaming aktivieren

Geräte-Streaming ist eine separate Funktion, die auf Test Lab-Geräten basiert. Sie erhalten damit direkten Zugriff auf Test Lab-Geräte. Firebase-Bearbeiter und -Administratoren können Device Streaming ohne zusätzliche Rollen verwenden. Bei Bedarf können Sie jedoch auch detailliertere Rollen zuweisen.

Wenn Sie einem Nutzer die Verwendung von Gerätestreaming erlauben möchten, weisen Sie ihm in der Google Cloud-Konsole eine vordefinierte Rolle zu, die die erforderlichen Berechtigungen enthält. Die zuzuweisende Rolle ist „Firebase Test Lab Direct Access Admin“ (roles/cloudtestservice.directAccessAdmin).

Weitere Informationen zum Gerätestreaming in Android Studio finden Sie unter Gerätestreaming in Android Studio.