Zum Hauptinhalt springen
Version: Guardian v0.5.3

Einrichtung der Geräte-Attestierung

Die nativen SDKs attestieren das Gerät unter Android mit Google Play Integrity und unter iOS mit Apple App Attest. Diese Seite behandelt die Einstellungen, die deine Organisation im Surt-Dashboard steuert: wie oft Geräte attestieren, gegen welches Google-Cloud-Projekt Android attestiert und welche iOS-Apps App Attest akzeptiert. Keine dieser Einstellungen erfordert eine Codeänderung im SDK oder ein neues App-Release.

Alle Einstellungen findest du an einer Stelle:

  1. Melde dich in deinem Surt Dashboard an.
  2. Navigiere zu Settings → Developer.
  3. Scrolle zum Abschnitt Device Attestation.

Jede Änderung wird wirksam, wenn du auf Save klickst.

EinstellungPlattformErforderlich
Attestation cadenceAndroid und iOSNein. Standard ist Once every N days per user mit 7 Tagen
Android projectAndroidNein. Das gemeinsam genutzte Projekt von Surt funktioniert ohne Einrichtung
iOS appsiOSJa. App Attest besteht nur für die App-IDs, die du hinzufügst

Attestierungskadenz​

Attestation cadence legt fest, wie oft ein Gerät attestiert:

OptionVerhalten
Once every N days per userEmpfohlen. Gib die Anzahl der Tage unter Days ein (Minimum 1, Standard 7).
Every transactionDas Gerät attestiert bei jeder Transaktion. Das verbraucht das tägliche Play-Integrity-Kontingent (10.000 pro Tag) bei großem Volumen schnell.

Das Intervall wird pro Kunde gezählt, und nur ein sauberes Play-Integrity-Urteil startet es. Ein Urteil mit Risikosignalen oder eine Transaktion, bei der Google kein Urteil liefert, startet es nicht. App Attest hat kein Tageskontingent, daher starten iOS-Urteile das Intervall nie: Ein Kunde, der nur iOS-Geräte nutzt, attestiert bei jeder Transaktion.

Das SDK wendet die Kadenz an, wenn deine App ein JWT übergibt. Ein collect()-Aufruf ohne JWT attestiert bei jedem Aufruf. Siehe Authentifizierung.

Android: eigenes Play-Integrity-Projekt​

Android attestiert standardmäßig gegen das gemeinsam genutzte Google-Cloud-Projekt von Surt, sodass die Attestierung ohne Einrichtung funktioniert. Mit einem eigenen Projekt bekommst du ein eigenes Play-Integrity-Kontingent, einschließlich jeder Kontingenterhöhung, die du bei Google anfragst.

Bevor du beginnst, in deinem Google-Cloud-Projekt:

  • Aktiviere die Play Integrity API.
  • Erstelle ein Dienstkonto mit der Rolle playintegrity.verifier und lade seinen JSON-Schlüssel herunter.
  • Notiere die Projektnummer. Sie besteht nur aus Ziffern, zum Beispiel 817986950837, und ist nicht die Projekt-ID.

Dann im Abschnitt Device Attestation:

  1. Wähle unter Android project die Option Your own GCP project.
  2. Fülle die Felder aus:
    • Cloud Project Number: die Projektnummer, nur Ziffern.
    • Package Name: der Paketname deiner App, zum Beispiel com.example.app.
    • Service Account JSON: Klicke auf Upload file und wähle die Schlüsseldatei, oder füge das Schlüssel-JSON ein.
  3. Klicke auf Save.

Surt prüft den Schlüssel beim Speichern bei Google. Wenn Google ihn ablehnt, zeigt das Dashboard einen Fehler an. Eine häufige Ursache ist ein Dienstkonto ohne die Rolle playintegrity.verifier. Behebe das und speichere erneut. Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt. Wenn du später die Projektnummer oder den Paketnamen änderst, musst du den Schlüssel erneut hochladen.

iOS: eigene App-IDs​

App Attest akzeptiert nur Schlüssel von den iOS-Apps, die deine Organisation registriert. Solange du deine App-IDs nicht hinzufügst, schlägt die Validierung jedes App-Attest-Schlüssels deiner App fehl, und iOS-Transaktionen gelten nie als attestiert.

Eine App-ID besteht aus deiner Apple Team ID und der Bundle ID der App:

TeilWo du ihn findestFormat
Team IDIn deinem Apple-Developer-Konto unter Membership10 Zeichen, Großbuchstaben und Ziffern, zum Beispiel ABCDE12345
Bundle IDIn Xcode, im Tab General deines App-Targets, Bundle IdentifierBezeichner in umgekehrter Domain-Schreibweise, zum Beispiel com.example.app

Im Abschnitt Device Attestation:

  1. Wähle unter iOS apps die Option Your own iOS app(s).
  2. Gib Team ID und Bundle ID deiner ersten App ein.
  3. Klicke für jeden weiteren Build, der das SDK ausführt, auf Add app, zum Beispiel für deine Staging- und deine Produktions-App. Du kannst bis zu 20 App-IDs hinzufügen, und jede muss eindeutig sein.
  4. Klicke auf Save.
Produktion akzeptiert nur produktive App-Attest-Schlüssel

Apps, die aus dem App Store oder über TestFlight installiert werden, erzeugen produktive App-Attest-Schlüssel. Builds, die du aus Xcode installierst, erzeugen Entwicklungsschlüssel, und die Produktion lehnt sie ab. Teste die iOS-Attestierung mit einem TestFlight-Build.

Auf Surt-Standardwerte zurücksetzen​

Revert to Surt defaults entfernt dein Android-Projekt samt Schlüssel und deine iOS-App-IDs und setzt beide Plattformen auf die Standardwerte von Surt zurück. Die Attestierungskadenz bleibt erhalten. Nach dem Zurücksetzen schlägt die Validierung der App-Attest-Schlüssel deiner eigenen Apps wieder fehl, bis du deine App-IDs erneut hinzufügst.