Alle Artikel
Leitfaden8 Min. Lesezeit

Die Berechtigungen des Google Play-Dienstkontos entscheiden, wer Ihre Bestellungen erstatten kann, also vergeben Sie nur das Nötigste

Eine einzige Play Console-Berechtigung erlaubt einem Dienstkonto, jede Bestellung zu erstatten und jedes Abo zu kündigen. Hier erfahren Sie, welche Berechtigungen des Google Play-Dienstkontos ein Erstattungstool wirklich braucht, was ein geleakter Schlüssel in jedem Store anrichten kann und wie Sie Schlüssel eingrenzen, rotieren und widerrufen.

Ein Messingschlüssel auf einem dunklen Schreibtisch neben einem Laptop und einem Smartphone, stellvertretend für die Berechtigungen des Google Play-Dienstkontos, die Erstattungen steuern

Wichtigste Erkenntnisse

  • Die Google Play-Berechtigung Manage orders and subscriptions (Bestellungen und Abos verwalten) erlaubt es, Bestellungen einzusehen, Bestellungen zu erstatten und Abos zu kündigen. Jedes Dienstkonto mit dieser Berechtigung kann also Geld an Ihre Käufer zurückfließen lassen.
  • Laut dem Leitfaden zur Google Play Developer API benötigen die Google Play-Abrechnungs-APIs zwei Play Console-Berechtigungen: View financial data, orders, and cancellation survey responses sowie Manage orders and subscriptions.
  • Die Methode orders.refund der Google Play Developer API kann jede Bestellung eines Einmalkaufs oder Abos erstatten, die bis zu 3 Jahre alt ist, und mit revoke auf true endet der Zugang des Käufers sofort.
  • Schlüssel von Google Cloud-Dienstkonten laufen standardmäßig nicht ab, und Google sagt, dass ein in ein Code-Repository eingecheckter Schlüssel in IAM gelöscht werden muss, weil das Entfernen aus dem Repository nicht reicht.
  • Apples In-App Purchase key kann keine Erstattungen auslösen, aber die App Store Server API aufrufen, einschließlich der Endpunkte, die das Verlängerungsdatum eines Abos um bis zu 90 Tage verschieben. Laut Apple lässt sich diese Verlängerung nicht rückgängig machen.
  • Nur ein Account Holder oder Admin kann in App Store Connect einen In-App Purchase key erzeugen, der private Schlüssel lässt sich nur einmal herunterladen, und ein widerrufener Schlüssel kann nicht wiederhergestellt werden.

Geben Sie einem Dienstkonto zwei Play Console-Berechtigungen, und es kann jede Bestellung in Ihrer App erstatten. Das ist keine Fehlkonfiguration. Genau so hat Google die Google Play Developer API gebaut, und deshalb verdient der JSON-Schlüssel hinter Ihrem Erstattungstool dieselbe Sorgfalt wie der Login zu Ihrer Bank.

Die meisten Teams richten das einmal ein, unter Zeitdruck, und haken an, was den ersten API-Aufruf zum Laufen gebracht hat. Dieser Leitfaden geht den umgekehrten Weg. Er zeigt, welche Berechtigungen des Google Play-Dienstkontos Erstattungen und Chargebacks tatsächlich brauchen, was jeder Store einem gestohlenen Schlüssel erlaubt und wie Sie den Schadensradius klein halten.

Was die Berechtigungen des Google Play-Dienstkontos tatsächlich erlauben

Ein Dienstkonto ist ein Robot-Nutzer. Sie legen es in Google Cloud an und laden dann seine E-Mail-Adresse in der Play Console unter Users and permissions (Nutzer und Berechtigungen) ein, genau wie Sie eine Kollegin einladen würden. Ab dann kann es alles tun, was diese Berechtigungen erlauben, über die API, zu jeder Uhrzeit, ohne zweiten Faktor.

Die zwei Berechtigungen, die die Abrechnungs-APIs verlangen

Der Leitfaden zur Google Play Developer API ist eindeutig. Um die Google Play-Abrechnungs-APIs zu nutzen, vergeben Sie zwei Berechtigungen: View financial data, orders, and cancellation survey responses (Finanzdaten, Bestellungen und Antworten auf Kündigungsumfragen ansehen) sowie Manage orders and subscriptions (Bestellungen und Abos verwalten). Die erste erlaubt dem Konto, Bestellungen zu lesen und die Purchases-API zu nutzen. Die zweite ist die, bei der es um Geld geht.

Play Console-BerechtigungWas sie laut Google erlaubtKann sie Geld an Käufer zurückgeben?
View financial data, orders, and cancellation survey responsesFinanzberichte, Verkaufsberichte und Bestellungen ansehen, auf die Purchases-API zugreifen, Antworten auf Kündigungsumfragen herunterladenNein
Manage orders and subscriptionsBestellungen ansehen, Bestellungen erstatten, Abos kündigenJa
Admin (alle Berechtigungen)Alle anderen Berechtigungen, dazu Nutzer einladen und deren Berechtigungen ändernJa, und es kann sich selbst weitere Rechte geben

Was ein Schlüssel mit Erstattungsrechten kann

Die Methode orders.refund der Google Play Developer API erstattet die Bestellung eines Abos oder In-App-Kaufs. Google sagt, dass Bestellungen, die älter als 3 Jahre sind, nicht erstattet werden können. Alles Neuere also schon. Setzen Sie revoke auf true, endet der Zugang des Käufers sofort. Bei Abos erledigt purchases.subscriptionsv2.revoke mit voller Erstattung dasselbe.

Das sind die richtigen Werkzeuge, wenn Sie sie bewusst einsetzen. Googles eigene Betrugsempfehlungen raten, einen Kauf, der Ihre Prüfungen nicht besteht, zu erstatten und zu widerrufen, statt ihn auslaufen zu lassen. Das Problem ist ein Schlüssel, der das für jede App in Ihrem Konto kann, obwohl er nur eine gebraucht hätte.

Was ein geleakter Schlüssel Sie kosten kann

Rechnen Sie nach, bevor Sie entscheiden, wie viel Aufwand das wert ist. Bei Google Play kann ein Schlüssel mit Manage orders and subscriptions Bestellungen Aufruf für Aufruf erstatten, und jede Erstattung gibt den Verkauf an den Käufer zurück. Ein Skript wird nicht müde. Die Obergrenze ist Ihre Bestellhistorie der letzten 3 Jahre.

Die Kosten, die mit der Erstattung nicht zurückkommen

Eine Erstattung macht den Verkauf rückgängig. Sie macht nicht rückgängig, was Sie für seine Bereitstellung ausgegeben haben. Diese Ausgaben bleiben in Ihren Büchern, ob die Erstattung nun von einem Kunden oder einem Angreifer kam.

  • Bereits genutzte Rechenleistung: GPU- und Serverzeit hinter jeder Generierung, jedem Rendering oder jeder Modellantwort, die der Käufer erhalten hat.
  • Bereits bezahlte API-Aufrufe: Gebühren pro Anfrage von Anbietern für Modelle, Karten, Sprache oder Daten.
  • Speicher, für den Sie weiter zahlen: die Dateien und der Verlauf, die diese Konten noch auf Ihren Servern haben.
  • Bereits geleistete Auszahlungen: Auszahlungen an Creator, Affiliates oder Verkäufer, die an diese Käufe gebunden sind, kommen mit der Erstattung nicht zurück.

Bei Apple sieht das Risiko anders aus

Apples App Store Server API hat keinen Endpunkt, der eine Erstattung auslöst. Über Erstattungen entscheidet Apple. Derselbe In-App Purchase key kann aber das Verlängerungsdatum eines Abonnenten um bis zu 90 Tage verschieben, zweimal innerhalb von 365 Tagen pro Kunde, oder für alle aktiven Abonnenten eines Produkts in einer einzigen Massenanfrage. Laut Apple lässt sich eine Verlängerung nicht rückgängig machen. In diesen Tagen zahlt der Abonnent nichts und nutzt Ihre App weiter, Ihre Rechnungen für Rechenleistung, Speicher und APIs laufen also ohne Umsatz weiter.

Was ein gestohlener Schlüssel kannGoogle Play-Dienstkonto mit Manage orders and subscriptionsApple In-App Purchase key
Eine Bestellung erstattenJa, Bestellungen bis zu 3 Jahre altNein, nur Apple erstattet
Den Zugang eines Käufers beendenJa, mit revoke bei der ErstattungNein
Abos kündigen oder verlängernKündigen, jaVerlängerungsdaten um bis zu 90 Tage verschieben, unumkehrbar
Kaufdaten lesenJa, mit der AnsichtsberechtigungJa, Transaktions- und Erstattungshistorie
Auf Erstattungsprüfungen antwortenJa, orders.reviewrefundJa, Send Consumption Information
Auf eine App beschränkenJa, über App-BerechtigungenNein, der Schlüssel gilt für alle Apps Ihres Teams

So grenzen Sie die Berechtigungen des Google Play-Dienstkontos ein

Die Play Console trennt Kontoberechtigungen von App-Berechtigungen. App-Berechtigungen gelten nur für die Apps, die Sie auswählen. Diese eine Einstellung bringt mehr für Ihre Sicherheit als alles andere auf dieser Liste.

Für eine App vergeben, nicht für das ganze Konto

Laden Sie jedes Dienstkonto mit App-Berechtigungen für die Apps ein, die es bedient. Ein Erstattungstool für ein Spiel braucht keine Erstattungsrechte für Ihre Meditations-App. Eine Falle: View financial data, orders, and cancellation survey responses gibt es nur auf Kontoebene, das Gegenstück auf App-Ebene heißt View financial data. Wählen Sie beim Eingrenzen die Variante auf App-Ebene.

Lesen und Erstatten trennen

Nicht jede Aufgabe braucht Manage orders and subscriptions. Analysen, die nur Bestellungen lesen, können über ein Konto mit reinen Ansichtsrechten laufen. Belassen Sie den erstattungsfähigen Schlüssel bei dem einen Dienst, der tatsächlich orders.refund, orders.reviewrefund oder die revoke-Endpunkte aufruft.

Geben Sie einem Robot niemals Admin

Admin vergibt alle Berechtigungen, und Google zählt das Einladen von Nutzern und die Verwaltung ihrer Berechtigungen zu seinen Rechten. Ein geleakter Admin-Schlüssel kann seinen eigenen Zugriff erweitern oder jemand Neues einladen. Kein Erstattungsablauf braucht das.

Fragen Sie Anbieter, wie sie sich verbinden

Manche Tools verlangen, dass Sie einen JSON-Schlüssel hochladen. Andere geben Ihnen die E-Mail-Adresse ihres eigenen Dienstkontos zum Einladen. So verlässt keiner Ihrer Schlüssel je Ihre Kontrolle, und Sie können deren Zugriff unter Users and permissions mit einem Klick entfernen. Braucht ein Anbieter Erstattungsrechte, fragen Sie nach: welche Berechtigungen, für welche Apps und warum.

Eine Entwicklerin am Schreibtisch widerruft auf einem Laptop einen Zugriff, an der Wand hängt eine Reihe Schlüssel an Haken, ein Haken ist leer. Das Bild zeigt, wie man Berechtigungen des Google Play-Dienstkontos entzieht

So speichern, rotieren und widerrufen Sie die Schlüssel

Beide Stores sagen dasselbe mit anderen Worten. Legen Sie keine Schlüssel in ein Code-Repository und liefern Sie sie nicht mit Ihrer App aus. Die Unterschiede zeigen sich, wenn etwas schiefgeht.

Google Cloud-Schlüssel laufen nicht von selbst ab

Laut den Empfehlungen von Google Cloud haben Dienstkonto-Schlüssel standardmäßig kein Ablaufdatum. Google empfiehlt, sie regelmäßig zu rotieren und nicht mehr genutzte Schlüssel zu deaktivieren. Landet ein Schlüssel in einem Repository, sollen Sie ihn laut Google so schnell wie möglich in IAM löschen, weil das Löschen aus dem Repository nicht reicht. Google Cloud kann geleakte Schlüssel, die es erkennt, auch automatisch deaktivieren, wenn die Einschränkung Service Account Key Exposure Response auf DISABLE_KEY steht, garantiert aber nicht, jedes Leck zu erkennen.

Apple-Schlüssel lädt man einmal herunter und widerruft sie endgültig

Nur ein Account Holder oder Admin kann einen In-App Purchase key erzeugen. Apple behält den öffentlichen Teil, Sie laden die private .p8-Datei einmal herunter, und Apple bewahrt keine Kopie auf. Vermuten Sie, dass ein Schlüssel kompromittiert ist, sollen Sie ihn laut Apple sofort in App Store Connect unter Users and Access, Integrations, In-App Purchase widerrufen. Ein widerrufener Schlüssel kann nicht wiederhergestellt werden, und der Widerruf stoppt auch das Einlösen von Werbeangeboten, die damit signiert wurden. Aktualisieren Sie diese Angebote also vorher oder direkt danach.

AufgabeGoogle Play-DienstkontoApple In-App Purchase key
Wer ihn anlegen kannIn Google Cloud angelegt, dann in der Play Console unter Users and permissions eingeladenAccount Holder oder Admin
Lässt sich das Secret erneut herunterladen?Sie erstellen einen neuen SchlüsselNein, nur ein Download
StandardablaufKeinerKeiner, bis Sie ihn widerrufen
Zugriff schnell kappenSchlüssel in IAM löschen oder das Konto in der Play Console entfernenSchlüssel in App Store Connect widerrufen
Nebenwirkungen des KappensJedes Tool, das dieses Konto nutzt, kann die API nicht mehr aufrufenDamit signierte Werbeangebote lassen sich nicht mehr einlösen

Eine kurze Checkliste

  • Ein Dienstkonto pro Aufgabe, eingeladen mit App-Berechtigungen nur für die Apps, die es bedient.
  • Manage orders and subscriptions nur für das Konto, das wirklich erstattet, widerruft oder auf Prüfungen antwortet.
  • Kein Admin für ein Robot-Konto.
  • Schlüssel in einem Secret Manager, nie in einem Repository, einem Build-Log oder einer mobilen App.
  • Eine schriftliche Liste aller Schlüssel, wer sie angelegt hat und welcher Dienst sie nutzt, damit ein Widerruf Ihre Erstattungsantworten nicht lahmlegt.
  • Eine Prüfung von Users and permissions in der Play Console und der App Store Connect-Schlüssel, sobald jemand das Team verlässt oder ein Anbieter wegfällt.

Häufig gestellte Fragen

Welche Play Console-Berechtigungen braucht ein Dienstkonto für Erstattungen und Chargebacks?
Es braucht Manage orders and subscriptions, um Bestellungen zu erstatten, Abos zu kündigen und mit Bestellungen zu arbeiten, dazu Lesezugriff auf Bestellungen. Der Leitfaden zur Google Play Developer API nennt View financial data, orders, and cancellation survey responses und Manage orders and subscriptions als die zwei Berechtigungen, die die Google Play-Abrechnungs-APIs voraussetzen.
Kann ein Google Play-Dienstkonto Bestellungen erstatten?
Ja, wenn es die Berechtigung Manage orders and subscriptions hat. Laut Googles Hilfeseite erlaubt diese Berechtigung, Bestellungen einzusehen, Bestellungen zu erstatten und Abos zu kündigen, und die API-Methode orders.refund erstattet jede Bestellung, die bis zu 3 Jahre alt ist.
Kann jemand mit meinem App Store In-App Purchase key meinen Kunden etwas erstatten?
Nein. Die App Store Server API hat keinen Erstattungsendpunkt, weil Apple über Erstattungen entscheidet. Ein gestohlener Schlüssel kann aber trotzdem die Transaktions- und Erstattungshistorie lesen, Verbrauchsinformationen senden und Verlängerungsdaten von Abos um bis zu 90 Tage verschieben, was sich laut Apple nicht rückgängig machen lässt.
Laufen Schlüssel von Google Play-Dienstkonten ab?
Standardmäßig nicht. Laut den Empfehlungen von Google Cloud haben Schlüssel, die Sie erstellen und herunterladen, kein Ablaufdatum, sofern Sie keines festlegen. Google empfiehlt, Schlüssel regelmäßig zu rotieren und nicht mehr genutzte zu deaktivieren.
Was tun, wenn der JSON-Schlüssel meines Dienstkontos auf GitHub eingecheckt wurde?
Löschen Sie den Schlüssel sofort in Google Cloud IAM und erstellen Sie einen neuen. Laut Google reicht es nicht, den Schlüssel aus dem Repository zu entfernen, denn wer ihn kopiert hat, kann ihn weiter nutzen, bis der Schlüssel selbst gelöscht ist.

Quellen und weiterführende Informationen

RefundHalt

Der Rückerstattungs-Autopilot für App Store und Google Play

Weiterlesen

Die nächste Rückerstattungsanfrage ist bereits unterwegs.

Richten Sie RefundHalt in der Zeit ein, die Sie brauchen, um eine weitere Support-E-Mail über eine Rückerstattung zu lesen, die Sie nicht anfechten konnten.