In diesem Artikel lernst du, welche vier Apple-Werte der Brand Configurator in Schritt 7 von dir braucht, woher du jeden einzelnen bekommst und wie du den API-Schlüssel im App Store Connect erstellst.
Inhalt
- Was Schritt 7 von dir braucht
- API-Schlüssel im App Store Connect erstellen
- Schlüssel im Konfigurator hochladen
- Wenn du den Schlüssel verlierst
Fast lane
- Gehe im App Store Connect zu Users and Access / Integrations / App Store Connect API / Team Keys.
- Klicke auf Generate API Key, gib einen beliebigen Namen ein, setze Access auf Admin und klicke auf Generate.
- Lade die Schlüsseldatei herunter. Apple erlaubt das nur einmal.
- Kopiere den Wert für API Key Issuer ID oben auf derselben Seite und den Wert für API Key ID aus der Schlüsselliste.
- Deine Apple Team ID findest du in deinem Apple-Developer-Konto unter Membership details. Dieser Wert steht nicht im App Store Connect.
- Trage alle vier Werte in Schritt 7 des Konfigurators ein und lade die Schlüsseldatei in das Feld API Key hoch.
Was Schritt 7 von dir braucht
Schritt 7 heißt API Keys und besteht aus einem Apple- und einem Google-Block. Der Apple-Block hat vier Felder. Sammle alle vier, bevor du den Schritt öffnest, denn der Konfigurator prüft sie gegen Apple, sobald du weiterklickst.
| Feld im Konfigurator | Woher du es bekommst |
|---|---|
| Apple Team ID | Aus deinem Apple-Developer-Konto unter Membership details. Eine Zeichenfolge aus zehn Zeichen. Dieser Wert steht nicht im App Store Connect, suche ihn also nicht bei deinen Schlüsseln. |
| API Key Issuer ID | Im App Store Connect oben auf der Seite Integrations, über deiner Schlüsselliste. Klicke daneben auf Copy. Eine lange Kennung im UUID-Format. |
| API Key ID | Im App Store Connect in der Schlüsselliste unter Active. Fahre über die Zeile und nutze Copy Key ID. Eine Zeichenfolge aus zehn Zeichen. |
| API Key | Die Schlüsseldatei, die du beim Erstellen des Schlüssels herunterlädst, siehe unten. Das ist ein Datei-Upload, kein Textfeld. |
Die beiden Kennungen werden leicht verwechselt. Die API Key Issuer ID ist eine lange UUID und gehört zu deinem gesamten Konto. Die API Key ID ist eine kurze Zeichenfolge aus zehn Zeichen und gehört zu dem einen Schlüssel, den du gerade erstellt hast.
Du wählst in diesem Schritt keine App aus. Der Schlüssel gilt auf Kontoebene und für alle deine Apps, es gibt also nichts App-spezifisches auszuwählen. Deine Branded App wird erst erstellt, nachdem du deine Konfiguration eingereicht hast.
API-Schlüssel im App Store Connect erstellen
Wir brauchen Zugriff auf die App Store Connect API, um deine Branded App für dich zu veröffentlichen. Diesen Schlüssel kann nur der Kontoinhaber erstellen.
- Melde dich bei App Store Connect an.
- Gehe zu Users and Access.
- Öffne den Tab Integrations.
- Wähle in der linken Spalte App Store Connect API. Meist ist der Eintrag schon ausgewählt.
- Achte darauf, dass der Tab Team Keys aktiv ist und nicht Individual Keys. Ein individueller Schlüssel hängt am Konto einer einzelnen Person und ist hier nicht verwendbar.
- Klicke auf Generate API Key oder auf das Plus-Symbol neben der Überschrift Active.
- Gib einen Namen ein. Der Name dient nur deiner eigenen Orientierung, es passt also alles, was du wiedererkennst.
- Wähle unter Access die Rolle Admin.
- Klicke auf Generate und lade die Schlüsseldatei herunter.
Apple erlaubt den Download der Schlüsseldatei nur einmal und behält keine Kopie davon. Bewahre sie sicher auf und gib sie nicht an Dritte weiter. Übermittle sie uns ausschließlich über den Brand Configurator, denn der Schlüssel gewährt Administratorzugriff auf dein Store-Konto.
Wenn du später weitere Branded Apps einrichtest, kannst du denselben Schlüssel wiederverwenden.
Schlüssel im Konfigurator hochladen
Die heruntergeladene Datei kommt in Schritt 7 in das Feld API Key, zusammen mit den drei Kennungen aus der Tabelle oben.
Wenn du weiterklickst, fragen wir bei Apple nach, ob die Zugangsdaten funktionieren. Stimmt etwas nicht, erscheint Api Key Validierung fehlgeschlagen und du kommst nicht weiter. Diese Meldung ist für jede Ursache dieselbe. Prüfe deshalb alle vier Werte, statt davon auszugehen, dass auf unserer Seite etwas fehlt. Die häufigste Ursache sind vertauschte Werte in API Key Issuer ID und API Key ID.
Wenn du den Schlüssel verlierst
Ein verlorener Schlüssel lässt sich nicht wiederherstellen, weil Apple keine Kopie behält. Widerrufe ihn stattdessen und erstelle einen neuen. Nutze im App Store Connect Edit neben deiner Liste der aktiven Schlüssel, dann Revoke Key, und bestätige mit Revoke. Ein widerrufener Schlüssel kann nicht wieder aktiviert werden und bleibt 30 Tage unter Revoked sichtbar.
Der neue Schlüssel hat eine neue API Key ID. Trage diesen neuen Wert im Konfigurator ein. Deine Apple Team ID und deine API Key Issuer ID ändern sich dabei nicht.
Name und Zugriffsrolle eines bestehenden Schlüssels lassen sich nicht nachträglich ändern. Auch dafür musst du den Schlüssel widerrufen und einen neuen erstellen.