Zusammenfassung: Dieser Leitfaden richtet sich an IT-Administratoren, die eine individuell gebrandete (Whitelabel-) iOS-App einrichten. Er führt Sie durch die Anmeldung Ihrer Organisation im Apple Developer Program, die Einladung von Speakap zu Ihrem Konto, das Erstellen der erforderlichen API-Schlüssel und das Eingeben aller Daten im Speakap Whitelabel-Portal, damit wir Ihre App veröffentlichen können.
Was ist eine nicht gelistete App?
Eine nicht gelistete App ist eine App, die im App Store nicht öffentlich indexiert ist. Sie wird über eine einzelne URL verteilt. Das bedeutet, dass ein spezieller Link benötigt wird, um sie herunterzuladen, und sie über die reguläre Namenssuche im App Store nicht gefunden werden kann. Diese Option ist wesentlich einfacher zu verteilen als VPP-Apps, für die Sie einzelne Codes kaufen und an Ihre Nutzer verteilen müssten, damit diese die App herunterladen können. Der Link zur nicht gelisteten App im App Store kann auf Einführungsmaterialien per QR-Code angezeigt und in Einladungsemails eingefügt werden.
Weitere Informationen von Apple: https://developer.apple.com/support/unlisted-app-distribution/
Schritt 1: Erstellen Sie ein Apple Developer-Konto
Als Mitarbeiter eines Unternehmens, einer gemeinnützigen Organisation, eines Joint Ventures, einer Partnerschaft oder einer Regierungsorganisation folgen Sie diesen Schritten, um sich für das Apple Developer Program anzumelden. Beachten Sie, dass Sie als die Person, die Ihre Organisation anmeldet, die rechtliche Befugnis haben müssen, Ihre Organisation an rechtliche Vereinbarungen zu binden. Sie müssen Eigentümer/Gründer der Organisation sein, Mitglied des Führungsteams, leitender Projektleiter oder ein Mitarbeiter mit von einem leitenden Angestellten erteilter rechtlicher Befugnis, wie sie in der Handelskammer / DUNS aufgeführt ist.
Bevor Sie beginnen, benötigen Sie:
- Eine Apple-ID für Ihre Organisation mit aktivierter Zwei-Faktor-Authentifizierung. Ihre Apple-ID-Informationen müssen gültig und aktuell sein, einschließlich Vorname, Nachname, Adresse, Telefonnummer, vertrauenswürdige Telefonnummer und vertrauenswürdige Geräte. Wichtig: Verwenden Sie eine Apple-ID, die mit einer zuverlässigen E-Mail-Adresse verknüpft ist. Wir empfehlen eine von der Firma verwaltete Apple-ID, damit zukünftige Teammitglieder das Konto bei Bedarf verwalten können. Speichern Sie die Zugangsdaten sicher in einem Passwortmanager.
- Eine D-U-N-S-Nummer, die nicht mit einem Einzelunternehmen verbunden ist, sondern mit einer Kapitalgesellschaft, einer Gesellschaft mit beschränkter Haftung (LLC), einer Partnerschaft (in einigen Fällen) oder einer gemeinnützigen Organisation. Diese einzigartigen neunstelligen Nummern werden von Dun & Bradstreet vergeben und sind weit verbreitet als standardisierte Geschäftserkennungsnummern. Sie können Ihre Nummer suchen und kostenlos eine anfordern. Weitere Details: https://developer.apple.com/support/D-U-N-S/
Beginnen Sie die Anmeldung und geben Sie die Informationen des Kontoinhabers ein:
- Gehen Sie zu developer.apple.com.
- Gehen Sie zu „Account“ und melden Sie sich mit Ihrer Apple-ID an.
- Klicken Sie auf „Enroll today“, dann auf „Continue enrollment on the web“.
- Geben Sie Ihren rechtlichen Vor- und Nachnamen sowie Ihre Telefonnummer ein. Geben Sie keinen Alias, Spitznamen oder Firmennamen als rechtlichen Namen ein, da dies zu Verzögerungen bei der Überprüfung Ihrer Anmeldung führt.
- Klicken Sie auf „Continue“ und wählen Sie „I develop as a COMPANY/organization“ aus.
Geben Sie die Informationen Ihrer Organisation ein:
Geben Sie auf den nächsten Bildschirmen Folgendes an:
- Rechtsform.
- Rechtlicher Name der Organisation: DBAs, fiktive Unternehmen, Handelsnamen oder Zweigstellen sind nicht erlaubt. Der rechtliche Name erscheint als „Verkäufer“ für die von Ihnen verteilten Apps. Der Name sollte exakt mit dem im DUNS-Bericht übereinstimmen.
- D-U-N-S-Nummer: Ihre Organisation muss eine D-U-N-S-Nummer haben, damit Apple die Identität und den rechtlichen Status verifizieren kann.
- Adresse und Telefonnummer des Hauptsitzes.
- Webseite: Die Webseite Ihrer Organisation muss öffentlich zugänglich sein und die Domain muss mit Ihrer Organisation verbunden sein.
- Bestätigung der Zeichnungsberechtigung: Bestätigen Sie, dass Sie berechtigt sind, Ihre Organisation an rechtliche Vereinbarungen zu binden, und geben Sie die Kontaktdaten eines Mitarbeiters an, der Ihre Zeichnungsberechtigung verifizieren kann.
- (Optional) Wenn Ihre Organisation gemeinnützig, Bildungs- oder Regierungsorganisation ist, können Sie eine Gebührenerlass beantragen.
Schließen Sie die Anmeldung ab und tätigen Sie den Kauf:
Nachdem Sie Ihre Informationen eingereicht haben, werden diese von Apple überprüft. Nach der Verifizierung erhalten Sie eine E-Mail, die Ihnen mitteilt, dass Sie Ihre Anmeldung abschließen können. Dies dauert in der Regel 7-10 Werktage.
- Akzeptieren Sie die Apple Developer Program Lizenzvereinbarung/AGB.
- Apple erhebt eine jährliche Mitgliedsgebühr von 99 USD für ein Organisationskonto. Die Mitgliedschaft wird jährlich als automatisch verlängerbares Abonnement bereitgestellt, das sich bis zur Kündigung erneuert. Wir empfehlen die automatische Verlängerung, damit die App nicht ein Jahr später aus dem App Store verschwindet.
- Sie können den Kauf mit einer Ihrer Apple-ID-Zahlungsmethoden tätigen. Wenn Sie die Kreditkarte Ihrer Organisation verwenden möchten, fügen Sie diese der Apple-ID hinzu, mit der Sie in den Geräteeinstellungen angemeldet sind. Dies kann eine andere Apple-ID sein als die, mit der Sie sich anmelden.
Eine Quittung wird Ihnen per E-Mail zugesandt, und Sie können sie jederzeit über Kaufverlauf in den Einstellungen erneut anfordern. Sie können Ihr Abonnement bis einen Tag vor dem jährlichen Verlängerungsdatum in den Einstellungen kündigen. Mitgliedsgebühren, die für das Jahr bezahlt wurden, in dem Sie kündigen, sind nicht erstattungsfähig. Erfahren Sie mehr über die Verwaltung Ihrer Apple-ID-Zahlungsmethoden.
Schritt 2: Laden Sie Speakap in Ihr Apple-Konto ein
- Melden Sie sich an unter https://appstoreconnect.apple.com/login.
- Wählen Sie Users and Access > People und klicken Sie auf das blaue Pluszeichen.
- Geben Sie Vorname: Speakap, Nachname: Development ein.
- Geben Sie E-Mail ein: mobile-development@speakap.nl.
- Wählen Sie die Rolle Admin aus.
Wir bitten um die Admin-Rolle, weil sie uns alle benötigten Zugriffsrechte gibt und Verzögerungen vermeidet, wenn falsche Berechtigungen vergeben werden. Wenn Sie keine Admin-Rechte vergeben möchten, sind die Mindestrechte, die wir benötigen, die Rolle App Manager mit den folgenden aktivierten Berechtigungen:
- Zugriff auf Zertifikate, Identifikatoren & Profile
- Zugriff auf Cloud Managed Distribution Certificate
- Apps erstellen
Hinweis: Um die App erstellen zu können, muss das Apple Developer-Konto weniger als 3 „bereits erstellte“ Verteilungszertifikate haben. Falls Sie bereits 3 Verteilungszertifikate in Ihrem Konto haben, können Sie uns eines der bestehenden Zertifikate freigeben.
Schritt 3: Geben Sie uns API-Berechtigungen
Um die App und ihre Updates in Ihrem Konto hochzuladen, benötigen wir einen App Store Connect API-Schlüssel. Dieser kann nur vom „Kontoinhaber“-Benutzer des Apple-Kontos erstellt werden.
- Melden Sie sich an unter https://appstoreconnect.apple.com/login.
- Wählen Sie Users and Access > Integrations > App Store Connect API.
- Möglicherweise müssen Sie „Request Access“ anfordern. In der Regel wird der Zugriff innerhalb weniger Stunden bis zu einigen Werktagen gewährt. Manchmal sofort. In der Zwischenzeit können Sie fortfahren und diesen Abschnitt mit dem API-Schlüssel später abschließen.
- Sobald Sie Zugriff haben, klicken Sie auf die Schaltfläche Hinzufügen (+).
- Geben Sie einen Namen für den Schlüssel ein. Der Name dient nur Ihrer Referenz und ist kein Teil des Schlüssels selbst.
- Wählen Sie unter Zugriff die Rolle für den Schlüssel aus. Wir empfehlen „Admin“, da dies uns erlaubt, den Upload der App-Version und den Zertifikats-Erneuerungsprozess zu verwalten.
- Klicken Sie auf Generate.
- Klicken Sie neben dem neuen API-Schlüssel auf den Link Download API Key. Dieser Schlüssel kann nur einmal heruntergeladen werden. Bewahren Sie ihn an einem sicheren und für Sie zugänglichen Ort auf.
- Notieren Sie sich die API Key ID und die Issuer ID. Sie benötigen diese in Schritt 5.
Weitere Informationen zum Erstellen des API-Schlüssels: https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api
Schritt 4: Stellen Sie einen .p8-Schlüssel für Apple Push Notifications (APNs) bereit
Eine authentifizierte Verbindung zu APNs ist erforderlich, um Push-Benachrichtigungen an eine iOS-App zu senden. Unsere Empfehlung ist, dass Sie eine .p8-Datei erstellen und diese mit uns teilen, da das .p8-Zertifikat nicht abläuft, während das .p12-Zertifikat abläuft. Wenn Sie sich entscheiden, uns keine .p8-Datei zu geben, können Sie trotzdem Push-Benachrichtigungen erhalten, müssen aber ein .p12-Zertifikat erstellen und es erneuern, wenn es abläuft (normalerweise jährlich).
Hinweis: Diesen Schritt können wir für Sie durchführen, wenn Sie unserem Benutzer mobile-development@speakap.nl die oben beschriebenen Admin-Berechtigungen gegeben haben. Wenn Sie eine lokale Kopie des Schlüssels behalten möchten, führen Sie die folgenden Schritte selbst aus:
- Melden Sie sich bei Ihrem Apple Developer-Konto (https://developer.apple.com/) an und gehen Sie zu Certificates, Identifiers & Profiles > Keys, dann klicken Sie auf den blauen +-Button.
- Wählen Sie Apple Push Notifications service (APNs) und geben Sie einen Namen für den Schlüssel ein.
- Aktivieren Sie das Kontrollkästchen „Apple Push Notifications service (APNs)“ und klicken Sie auf „Configure“.
- Wählen Sie genau diese Optionen: Environment: Production und Key Restriction: Team Scoped (All Topics).
- Speichern Sie, klicken Sie auf Weiter und wählen Sie auf der nächsten Seite Register.
- Laden Sie Ihren neuen Schlüssel herunter und speichern Sie ihn an einem sicheren Ort (Sie können ihn nur einmal herunterladen).
- Notieren Sie sich den Development Team Name und die ID (oben rechts auf dem Bildschirm) sowie die APNs Key ID. Sie benötigen diese in Schritt 5.
- Klicken Sie auf „Done“.
Schritt 5: Geben Sie Ihre Daten im Whitelabel-Portal ein
Um den Prozess abzuschließen, geben Sie Ihre Apple Developer-Daten direkt in unser Portal ein. Sie können Zugang zum Portal anfordern, indem Sie Ihren CSM kontaktieren. Wenn Ihr CSM bereits die App-Konfigurationsdaten in unser Portal hochlädt, können Sie ihm Ihre Apple-Kontodaten einfach per E-Mail direkt senden. Wenn Sie also Zugang zum White Label App-Portal haben, befolgen Sie diese Schritte oder teilen Sie die untenstehenden Informationen direkt per E-Mail mit Ihrem CSM.
Bevor Sie beginnen, suchen Sie Ihren Development Team Name und Ihre Development Team ID. Diese Werte finden Sie, indem Sie sich bei https://developer.apple.com/account/resources/certificates/list mit Ihrem Konto anmelden.
- Melden Sie sich im Speakap Whitelabel-Portal an und gehen Sie zum Bereich iOS (oder teilen Sie die untenstehenden Informationen direkt per E-Mail mit Ihrem CSM).
- Entwicklerteam: Geben Sie Ihren Development Team Name und Development Team ID (eine 10-stellige alphanumerische Zeichenfolge) ein.
- API-Zugriff: Laden Sie Ihre heruntergeladene API-Schlüsseldatei (.p8) hoch. Geben Sie die API Key ID und die Issuer ID ein.
- Nicht gelistete Apps: Klicken Sie auf Fragebogen ausfüllen, um die erforderlichen Antworten für die Apple-Anfrage zur nicht gelisteten App bereitzustellen.
- Push-Benachrichtigungen: Laden Sie Ihre APNs-Schlüsseldatei (.p8) hoch und geben Sie die APNs Key ID ein.
- Klicken Sie auf Details speichern, um Ihre Konfiguration abzuschließen.
- Links neben dem Wort Apple sollte ein grünes Symbol erscheinen.
Zur Anfrage für die nicht gelistete App: Wenn Ihre App bereit ist, senden wir sie zur Überprüfung ein und weisen die Apple-Prüfer darauf hin, dass sie für deren Unlisted-Programm bestimmt ist. Wir können diese Anfrage nur in Ihrem Namen stellen, wenn Sie uns Admin-Rechte im Konto gegeben haben. Wenn Sie uns weniger Berechtigungen gegeben haben, müssen Sie die Anfrage für die nicht gelistete App selbst über https://developer.apple.com/contact/request/unlisted-app/ einreichen und auf die Frage „Haben Sie Ihre App zur Überprüfung im App Store eingereicht?“ mit „Ja“ antworten. Dann müssen wir die Zeitplanung koordinieren, damit die App und die Anfrage gemeinsam von Apple bearbeitet werden. Werden sie nicht zusammen bearbeitet, wird die App automatisch abgelehnt.
Schritt 6: Letzte Überprüfungen
Überprüfen Sie noch einmal, dass Sie entweder alles auf dieser Liste an Ihren CSM gesendet oder im Whitelabel-App-Portal hochgeladen haben:
- Development Team Name
- Development Team ID
- Account-E-Mail
- APNS .p8 Datei
- APNS Key ID
- API Key .p8 Datei
- API Key ID
- Issuer ID
Immer noch Probleme?
Schreiben Sie uns eine E-Mail an technicalimplementations@speakap.nl mit dem Namen Ihrer Organisation, dem Schritt, bei dem Sie feststecken, und einer eventuellen Fehlermeldung, die Sie sehen. Wir helfen Ihnen gerne weiter.