Zum Inhalt springen

Anleitung

App-Store-Connect-API-Schlüssel für Preise erstellen

Jedes Tool, das in Ihrem Auftrag Preise ändert – Ihr eigenes Skript oder RepriceCat –, authentifiziert sich mit einem App-Store-Connect-API-Schlüssel. So erstellen Sie einen, der die Aufgabe erledigen kann und nicht mehr als das.

Aktualisiert am 7 Min. Lesezeit

Die kurze Antwort

Gehen Sie in App Store Connect zu „Benutzer und Zugriff“ → „Integrationen“ → „App Store Connect API“ → „Team-Schlüssel“ und erzeugen Sie einen Schlüssel mit der Rolle App Manager (oder Admin, wenn Sie auch Verkaufsberichte lesen wollen). Laden Sie die .p8-Datei herunter – Sie haben nur einen Versuch – und kopieren Sie Key ID und Issuer ID. Diese drei Werte sind die Zugangsdaten.

Den Schlüssel erstellen, Schritt für Schritt

Die Schritte von Apple (Apple: API-Schlüssel erstellen) erfordern einen Admin-Account; wurde die API in Ihrem Team noch nie genutzt, muss zuerst der Account Holder den Zugriff darauf beantragen.

  1. Melden Sie sich in App Store Connect an, öffnen Sie „Benutzer und Zugriff“ und wählen Sie den Tab „Integrationen“.
  2. Wählen Sie in der linken Spalte „App Store Connect API“ und stellen Sie sicher, dass der Tab „Team-Schlüssel“ ausgewählt ist.
  3. Klicken Sie auf „API-Schlüssel generieren“ oder auf die Plus-Schaltfläche (+).
  4. Geben Sie einen Namen ein, den Sie später wiedererkennen, zum Beispiel „Preise — RepriceCat“. Der Name dient nur Ihrer Orientierung.
  5. Wählen Sie unter „Zugriff“ die Rolle (siehe Tabelle unten) und klicken Sie auf „Generieren“.
  6. Klicken Sie neben dem neuen Schlüssel auf „API-Schlüssel laden“. Der private Schlüssel wird einmalig als .p8-Datei geladen, meist benannt wie AuthKey_2X9R4HXF34.p8; Apple behält keine Kopie, und der Link verschwindet nach dem Download.
  7. Kopieren Sie die Key ID aus der Liste der aktiven Schlüssel und die Issuer ID, die oben auf der Seite steht.
WertSieht so ausWo Sie ihn finden
Issuer IDEine UUID, z. B. 57246542-96fe-1a63-e053-0824d011072aOben auf der Seite „App Store Connect API“; für alle Team-Schlüssel gleich
Key ID10 Zeichen, z. B. 2X9R4HXF34Neben dem Schlüssel in der Liste der aktiven Schlüssel
Privater SchlüsselEine .p8-Textdatei, die mit -----BEGIN PRIVATE KEY----- beginntIhr Download; er lässt sich nicht erneut laden

Die Beispiele sind Apples eigene Beispielwerte aus der Token-Dokumentation.

Welche Rolle sollte der Schlüssel haben?

Die Rolle eines Team-Schlüssels bestimmt, was er kann, und Team-Schlüssel haben unabhängig von der Rolle Zugriff auf alle Apps. Apples Hilfeseiten zu Preisen nennen Account Holder, Admin oder App Manager als erforderliche Rolle, um Preise von Apps, In-App-Käufen und Abonnements zu ändern (Apple: Preis festlegen, Apple: Rollenberechtigungen).

RolleKann Preise ändernSales-and-Trends-BerichteFür Preise nutzen?
App ManagerJaVon Apple für diese Rolle nicht beschriebenJa – die kleinste Rolle, die Preise verwaltet
AdminJaJaJa, wenn derselbe Schlüssel auch Verkaufsberichte lesen soll
FinanceNeinJaNein – nur Berichte
SalesNeinJaNein – nur Berichte
Developer, Marketing, Customer SupportNeinVon Apple nicht beschriebenNein

Admin-Schlüssel sind mächtig – laut Apple können sie Benutzer anlegen und löschen –, nehmen Sie also App Manager, es sei denn, Sie brauchen Verkaufsdaten über denselben Schlüssel. Wie Sie Verkäufe nach Land lesen, steht in der Anleitung zu Vendor-Nummer und Verkaufsberichten.

Team-Schlüssel oder individuelle Schlüssel

App Store Connect bietet beides. Nehmen Sie für Preise einen Team-Schlüssel:

  • Team-Schlüssel haben eine ausdrückliche Rolle und überdauern es, wenn die Person, die sie erstellt hat, das Team verlässt.
  • Individuelle Schlüssel tragen Zugriff und Rollen eines einzelnen Benutzers und werden aus dessen Profil erzeugt – nur wenn ein Admin die Berechtigung „Individuelle API-Schlüssel generieren“ erteilt hat.
  • Individuelle Schlüssel können die Endpunkte für Sales und Finance, Provisioning oder notarytool nicht nutzen und taugen daher nicht für Verkaufsberichte.

Den Schlüssel testen, bevor Sie sich darauf verlassen

  1. Signieren Sie ein JWT: Header alg ES256 und kid = Key ID; Payload iss = Issuer ID, iat = jetzt, exp = höchstens 20 Minuten später, aud = appstoreconnect-v1.
  2. Rufen Sie GET https://api.appstoreconnect.apple.com/v1/apps mit dem Token als Bearer-Header auf. Eine Liste Ihrer Apps heißt, dass der Schlüssel funktioniert.
  3. Ein 401 bedeutet meist eine falsche Issuer ID oder Key ID, ein mit einem anderen Schlüssel signiertes Token oder ein Token, dessen Laufzeit zu lang oder schon abgelaufen ist (prüfen Sie Ihre Uhr).
  4. Ein 403 bei einem Preisaufruf bedeutet meist, dass die Rolle des Schlüssels keine Preise verwalten darf – nutzen Sie einen Schlüssel mit der Rolle App Manager oder Admin.

Wenn er funktioniert, führt die Anleitung zur Preis-API durch die Endpunkte für Preispunkte und Preispläne.

Sicher aufbewahren

  • Behandeln Sie die .p8 wie ein Passwort. Wer sie und die beiden IDs hat, kann mit der Rolle des Schlüssels in allen Apps des Teams handeln.
  • Apples Rat: Schlüssel nicht teilen, nicht in einem Code-Repository ablegen und nicht in clientseitigen Code einbauen.
  • Halten Sie einen Schlüssel pro Zweck. Ein Preisschlüssel muss nicht der Schlüssel sein, den Ihre CI für Uploads nutzt, sodass sich jeder widerrufen lässt, ohne den anderen zu stören.
  • Wenn Sie ihn in ein Tool einfügen, prüfen Sie, was das Tool damit macht. RepriceCat verschlüsselt den Schlüssel vor dem Speichern mit AES-256-GCM, sendet ihn nie an den Browser zurück und nutzt ihn nur, um kurzlebige Tokens für Ihren eigenen Account zu signieren.

Häufige Fehler

  • Developer oder Marketing zu wählen, weil es „sicherer klingt“. Der Schlüssel liest dann Daten, aber jede Preisänderung schlägt fehl.
  • Einen individuellen Schlüssel aus Ihrem Profil zu erstellen und sich später zu wundern, warum Verkaufsberichte abgelehnt werden – individuelle Schlüssel können die Endpunkte für Sales und Finance nicht nutzen.
  • Key ID und Issuer ID zu verwechseln. Die Key ID ist kurz und gehört als kid in den Token-Header; die Issuer ID ist eine lange UUID und gehört als iss in die Payload.
  • Tokens zu signieren, die länger als 20 Minuten gelten. Apple lehnt sie für Preis-Endpunkte ab; ein langer Job sollte regelmäßig ein neues Token signieren und jedes bis zum Ablauf wiederverwenden.
  • Die .p8-Datei in ein Repository einzuchecken, auch in ein privates. Verschieben Sie sie in einen Secret-Store und widerrufen Sie den offengelegten Schlüssel.
  • Einen Schlüssel für CI-Uploads, ein Preisskript und ein Drittanbieter-Tool gemeinsam zu nutzen. Wenn Sie ihn aus einem Grund widerrufen, geht alles andere ebenfalls kaputt.

Sie überlegen, ob Sie mit diesem Schlüssel ein eigenes Preisskript schreiben oder ein Tool nutzen? RepriceCat vs. API-Skripte zeigt die Abwägungen.

Widerrufen

Widerrufen Sie einen Schlüssel, wenn jemand geht, wenn er möglicherweise abgeflossen ist oder wenn Sie ein Tool nicht mehr nutzen. Ein Admin kann Team-Schlüssel in der Liste der API-Schlüssel unter „Benutzer und Zugriff“ widerrufen (Apple: API-Schlüssel widerrufen). Das Widerrufen ist endgültig: Ein widerrufener Schlüssel lässt sich nicht wiederherstellen, jedes damit signierte Token funktioniert nicht mehr, und er bleibt 30 Tage unter „Widerrufen“ gelistet. Wenn Sie die .p8 verlieren, widerrufen Sie den Schlüssel und erzeugen einen neuen.

Den Schlüssel mit RepriceCat nutzen

Zum Verbinden von RepriceCat brauchen Sie die Issuer ID, die Key ID und die .p8-Datei eines Team-Schlüssels mit der Rolle App Manager oder Admin. Ab dann gilt:

  • Der Schlüssel wird verschlüsselt gespeichert und kann von Ihnen jederzeit in App Store Connect widerrufen werden.
  • Nichts wird an Apple gesendet, bis Sie ein Review jedes Produkts und Landes freigeben; ein Probelauf sendet nichts.
  • Die Seite „Sales“ braucht zusätzlich Ihre Vendor-Nummer und einen Schlüssel mit der Rolle Admin, Finance oder Sales – ein Admin-Schlüssel deckt also Preise und Verkäufe in einem ab.

Bereit? Verbinden Sie einen Schlüssel und passen Sie Ihre erste App an – der erste Monat ist kostenlos, danach kostet es 1 $ pro App und Monat.

Häufige Fragen

Wo finde ich die Issuer ID?

In App Store Connect unter „Benutzer und Zugriff“, „Integrationen“, „App Store Connect API“. Sie steht oben auf der Seite, mit einer Kopieren-Schaltfläche, und ist für jeden Team-Schlüssel des Accounts gleich.

Ich habe die .p8-Datei verloren. Kann ich sie erneut herunterladen?

Nein. Apple lässt Sie den privaten Schlüssel einmal laden und behält keine Kopie. Widerrufen Sie den Schlüssel und erzeugen Sie einen neuen.

Welche App-Store-Connect-Rolle darf Preise ändern?

Admin und App Manager sowie der Account Holder. App Manager ist die kleinste Rolle, die Preise verwaltet; Developer, Marketing, Finance und Sales können es nicht.

Wer kann einen App-Store-Connect-API-Schlüssel erstellen?

Team-Schlüssel erzeugt jemand mit einem Admin-Account, nachdem der Account Holder den API-Zugriff für das Team beantragt hat. Individuelle Schlüssel werden aus dem eigenen Profil eines Benutzers erzeugt, wenn ein Admin diese Berechtigung erteilt hat.

Kann ich einen individuellen API-Schlüssel für Preise nutzen?

Er funktioniert für Preise, wenn die eigene Rolle des Benutzers Preise erlaubt, aber ein Team-Schlüssel ist die bessere Wahl: Er hat eine ausdrückliche Rolle und überdauert das Ausscheiden des Benutzers. Individuelle Schlüssel haben außerdem keinen Zugriff auf Sales- und Finance-Berichte.

Ist es sicher, einem Preis-Tool meinen API-Schlüssel zu geben?

Nur wenn Sie darauf vertrauen, wie es den Schlüssel speichert, denn der Schlüssel kann alles, was seine Rolle erlaubt. Nutzen Sie einen eigenen Team-Schlüssel mit der kleinsten Rolle, die funktioniert, und widerrufen Sie ihn, wenn Sie das Tool nicht mehr nutzen.

Ausprobieren

Jedes Land aus einem Basispreis neu bepreisen

Preisstufen, Anpassung an Preispunkte, eine Prüftabelle, eine Bestätigung – über die App Store Connect API. Erster Monat gratis, danach 1 $ pro App und Monat.