App Store Connect API-Schlüssel für Appstead einrichten

Erstelle den API-Schlüssel mit Sales and Reports, lade die .p8 Datei einmal herunter und füge die Zugangsdaten hinzu, die Appstead für einen Live-Workspace braucht.

Ein Live-Workspace in Appstead verbindet sich direkt mit App Store Connect. Du gibst Appstead einen API-Schlüssel mit der Rolle Sales and Reports, und die App nutzt ihn, um deine App- und Sales-Report-Daten zu lesen. Kein Appstead Account und kein Server sind beteiligt.

Live-Workspaces gehören zu Appstead Pro. Wenn du die App ausprobieren willst, bevor du einen Account verbindest, braucht der eingebaute Demo-Workspace gar keinen Schlüssel.

Was du brauchst

Appstead fragt beim Hinzufügen eines Live-Workspace nach vier Dingen:

• Eine App Store Connect Issuer ID
• Eine API Key ID
• Die private .p8 Schlüsseldatei
• Deine Vendor Number für Sales Reports

Bevor du startest

Du brauchst einen Admin Account in App Store Connect, um Team Keys zu erzeugen. Wenn du dich mit der Rolle Developer oder App Manager anmeldest, erscheint der Button Generate nicht. Bitte den Admin oder Account Holder deines Teams, den Schlüssel zu erstellen, oder dich zum Admin zu machen.

Der Schlüssel muss ein Team Key sein, kein Individual Key. Apple erlaubt Individual Keys keinen Zugriff auf Sales and Finance Daten, daher scheitert die Validierung eines Individual Keys in Appstead.

Erstelle einen neuen Schlüssel für Appstead, statt einen Schlüssel aus einem anderen Tool wiederzuverwenden. Der Schlüssel braucht die Rolle Sales and Reports. Das ist die Zugriffsstufe, die Appstead für den Live-Workspace-Setup nutzt.

Apple lässt dich die private .p8 Datei nur einmal herunterladen. Halte sie privat und bereit, bis du sie importierst. Lege sie nie in ein Code-Repository und sende sie nicht per E-Mail oder Chat.

1. API-Schlüssel erstellen

1. Melde dich bei App Store Connect an und öffne API Keys. Wenn du von Hand navigierst: unter Users and Access, im Tab Integrations, unter App Store Connect API.
2. Stelle sicher, dass der Tab Team Keys ausgewählt ist, und wähle Generate API Key oder den Button Add (+).
3. Benenne den Schlüssel Appstead oder einen anderen Namen, den du wiedererkennst.
4. Unter Access wähle Sales and Reports.
5. Wähle Generate.

Apples API-key guide beschreibt den aktuellen Ablauf und die Rollen im Detail.

2. IDs kopieren und .p8 Datei herunterladen

Sammle auf der Seite Team Keys diese drei Dinge zusammen:

• Issuer ID: die accountweite ID oben auf der Seite. Sie ist für jeden Schlüssel im Account gleich.
• Key ID: die ID in der Zeile für diesen neuen Schlüssel.
• Private Key: wähle Download API Key in dieser Zeile, um die .p8 Datei zu speichern.

Key ID und .p8 Datei müssen zum selben API-Schlüssel gehören. Der Download-Link verschwindet, sobald du ihn genutzt hast. Ist er weg, erstelle einen Ersatzschlüssel. Apple behält keine weitere Kopie der privaten Datei.

3. Vendor Number finden

Appstead nutzt deine Vendor Number, um Sales Reports anzufordern. Öffne Payments and Financial Reports in App Store Connect. Die Nummer erscheint als Vendor # oben links. Es ist eine accountweite Nummer, nicht die Apple ID einer App.

4. Live-Workspace in Appstead hinzufügen

1. Öffne Appstead, gehe zu Settings und wähle Add Workspace. Wenn du noch keinen Workspace hast, bietet der leere Screen Add Live Workspace an, und die Demo-Overview bietet Connect App Store. Alle drei öffnen dasselbe Formular.
2. Wenn du noch nicht auf Appstead Pro bist, erscheint zuerst der Pro-Screen. Das Formular öffnet sich, sobald Pro aktiv ist.
3. Gib dem Workspace einen Namen, den du wiedererkennst, zum Beispiel deinen Studio-Namen.
4. Füge Issuer ID und Key ID ein.
5. Wähle Choose .p8 File und wähle den heruntergeladenen privaten Schlüssel.
6. Gib die Vendor Number ein.
7. Wähle Validate & Save. Appstead prüft die Zugangsdaten bei Apple, bevor etwas gespeichert oder importiert wird.

Wenn du diesen Workspace schon auf einem anderen Gerät mit demselben iCloud Account eingerichtet hast, kann Appstead die Zugangsdaten in iCloud Keychain finden und anbieten, damit weiterzumachen.

Was nach dem Verbinden passiert

• Der erste Import lädt die letzten 90 Tage täglicher Sales Reports, damit Overview und Trends sofort gefüllt sind. Du kannst die App weiter nutzen, während der Import läuft.
• Spätere Aktualisierungen reichen die Historie weiter zurück, bis zum rollierenden Jahr täglicher Reports, die Apple bereitstellt.
• Apple veröffentlicht den Report von gestern typischerweise gegen 7 Uhr Pacific. Bis dahin fehlt der neueste Tag, er ist nicht null.
• Die letzten fünf Tage werden bei jedem Refresh erneut geholt und als vorläufig angezeigt, weil Apple sie noch korrigieren kann.

Mehr als ein App Store Connect Account

Jeder Appstead Workspace hält die Zugangsdaten eines Accounts. Für einen zweiten Account, zum Beispiel einen Kunden oder ein altes Team, wiederhole diese Schritte mit einem Schlüssel unter diesem Account und füge ihn als eigenen Workspace hinzu. Zwischen Workspaces wechselst du mit einem Tipp.

Wenn der .p8 Download auf iPhone oder iPad fehlschlägt

Apples Download kann auf iPhone oder iPad fehlschlagen. Lade die Datei stattdessen auf einem Mac herunter, übertrage sie direkt mit AirDrop oder Dateien und importiere sie in Appstead. Lösche temporäre Kopien, sobald der Import geklappt hat.

Wenn Appstead den Schlüssel nicht validieren kann

Wenn Apple die Zugangsdaten ablehnt, prüfe der Reihe nach:

• Issuer ID und Key ID haben keine Extra-Leerzeichen.
• Die gewählte .p8 Datei gehört zu dieser Key ID.
• Der Schlüssel ist ein Team Key mit der Rolle Sales and Reports und wurde nicht widerrufen.
• Die Vendor Number gehört zum App Store Connect Account, den du hinzufügst.

Wenn Appstead meldet, dass die Zugangsdaten funktionieren, aber eine Vereinbarung fehlt, hat App Store Connect den Schlüssel akzeptiert, aber dein Account Holder muss noch eine erforderliche Vereinbarung annehmen, bevor Sales Reports ausgeliefert werden. Nimm sie auf der Seite Agreements in App Store Connect an und versuche es erneut.

Workspace entfernen oder Schlüssel widerrufen

Zum Trennen öffne den Workspace in Settings und wähle Remove Workspace. Du kannst ihn nur von diesem Gerät entfernen, wodurch er auf anderen Geräten bleibt, oder von allen Geräten.

Einen Workspace zu entfernen widerruft den Schlüssel bei Apple nicht. Wenn die .p8 Datei jemals freigelegt wurde oder du sie einfach nicht mehr brauchst, widerrufe den Schlüssel auf der Seite Team Keys in App Store Connect. Ein widerrufener Schlüssel funktioniert in Appstead sofort nicht mehr. Erzeuge daher einen neuen, bevor du widerrufst, wenn du den Workspace behalten willst.

Dein Schlüssel bleibt privat

Appstead behält den privaten Schlüssel für diesen Workspace in der Keychain. Die App sendet deinen API-Schlüssel, Sales-Daten oder Geschäftsmetriken nicht an einen Appstead Server.