Zusammenfassung: Diese Anleitung richtet sich an IT-Administratoren, die eine individuell gebrandete (Whitelabel) iOS-App einrichten. Sie führt Sie durch die Anmeldung Ihrer Organisation im Apple Developer Program, das Einladen 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 spezifischer Link zum Herunterladen benötigt wird und die App nicht über die reguläre Namenssuche im App Store gefunden werden kann. Diese Option ist wesentlich einfacher zu verteilen als VPP-Apps, für die Sie individuelle Codes kaufen und diese unter Ihren Nutzern 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 befolgen Sie diese Schritte, um sich im Apple Developer Program anzumelden. Beachten Sie, dass Sie als 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, Mitglied des Führungsteams, leitender Projektleiter oder ein Mitarbeiter mit von einem leitenden Angestellten erteilter Rechtsbefugnis sein, wie sie in der Handelskammer / DUNS gelistet sind.
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 verlässlichen 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 Gesellschaft, 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 Standard-Geschäftskennungen. Sie können Ihre Nummer nachschlagen und kostenlos eine anfordern. Mehr Details: https://developer.apple.com/support/D-U-N-S/
Starten Sie die Anmeldung und geben Sie die Angaben 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“.
Geben Sie die Informationen Ihrer Organisation ein:
Geben Sie auf den nächsten Seiten Folgendes an:
- Art der Einheit.
- Rechtlicher Name der Einheit: DBAs, fiktive Unternehmen, Handelsnamen oder Zweigstellen sind nicht erlaubt. Der rechtliche Name der Einheit erscheint als „Verkäufer“ für die von Ihnen verteilten Apps. Der Name sollte exakt mit dem auf dem DUNS-Bericht übereinstimmen.
- D-U-N-S-Nummer: Ihre Organisation muss eine D-U-N-S-Nummer besitzen, damit Apple die Identität und den rechtlichen Status der Einheit überprüfen kann.
- Hauptsitz-Adresse und Telefonnummer.
- Website: Die Website Ihrer Organisation muss öffentlich zugänglich sein und der Domainname muss mit Ihrer Organisation verbunden sein.
- Bestätigung der Zeichnungsberechtigung: Bestätigen Sie, dass Sie befugt sind, Ihre Organisation an rechtliche Vereinbarungen zu binden, und geben Sie die Kontaktinformationen eines Mitarbeiters an, der Ihre Zeichnungsberechtigung verifizieren kann.
- (Optional) Wenn Ihre Organisation gemeinnützig, eine Bildungseinrichtung oder eine Regierungsorganisation ist, können Sie eine Gebührenbefreiung beantragen.
Abschluss der Anmeldung und 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 als automatisch verlängerbares Abonnement bereitgestellt, das sich jährlich erneuert, bis es gekündigt wird. Wir empfehlen die automatische Verlängerung, damit die App nicht nach einem Jahr 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üssen, fügen Sie diese der Apple-ID hinzu, die in den Geräteeinstellungen angemeldet ist. Dies kann eine andere Apple-ID sein als die, mit der Sie sich anmelden.
Eine Quittung wird Ihnen per E-Mail zugeschickt, und Sie können diese 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. Für das Jahr, in dem Sie kündigen, sind die Mitgliedsgebühren nicht erstattungsfähig. Erfahren Sie mehr über die Verwaltung Ihrer Apple-ID-Zahlungsmethoden.
Schritt 2: Laden Sie Speakap zu Ihrem 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 die E-Mail-Adresse ein: mobile-development@speakap.nl.
- Wählen Sie die Rolle Admin aus.
Wir bitten um die Admin-Rolle, da sie uns alle benötigten Zugriffsrechte gibt und Verzögerungen durch falsche Berechtigungen vermeidet. Wenn Sie keine Admin-Rechte vergeben möchten, benötigen wir mindestens 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, darf Ihr Apple Developer-Konto weniger als 3 „bereits erstellte“ Verteilungszertifikate enthalten. Wenn Sie bereits 3 Verteilungszertifikate in Ihrem Konto haben, können Sie uns eines der bestehenden Zertifikate freigeben.
Schritt 3: Erteilen 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 „Account Holder“ des Apple-Kontos generiert 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. Normalerweise wird der Zugriff innerhalb weniger Stunden bis zu einigen Werktagen gewährt. Manchmal sofort. In der Zwischenzeit können Sie fortfahren und diesen Abschnitt 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 nicht Teil des Schlüssels.
- 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 die Erneuerung von Zertifikaten zu verwalten.
- Klicken Sie auf Generate.
- Klicken Sie auf den Link Download API Key neben dem neuen API-Schlüssel. Dieser Schlüssel kann nur einmal heruntergeladen werden. Bewahren Sie ihn sicher und zugänglich auf.
- Notieren Sie sich die API Key ID und die Issuer ID. Diese benötigen Sie 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 uns diese zur Verfügung stellen, 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 dennoch Push-Benachrichtigungen nutzen, müssen dann aber ein .p12-Zertifikat erstellen und dieses bei Ablauf (normalerweise jährlich) erneuern.
Hinweis: Diesen Schritt können wir für Sie durchführen, wenn Sie unserem mobile-development@speakap.nl-Benutzer die oben beschriebenen Admin-Berechtigungen erteilen. 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 wählen Sie die blaue + Schaltfläche.
- 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)“, klicken Sie dann auf „Configure“.
- Wählen Sie genau diese Optionen: Environment: Production und Key Restriction: Team Scoped (All Topics).
- Speichern, weiter, und auf der nächsten Seite Register wählen.
- Laden Sie Ihren neuen Schlüssel herunter und speichern Sie ihn an einem sicheren Ort (der Download ist nur einmal möglich).
- Notieren Sie sich den Development Team Name und die ID (oben rechts auf dem Bildschirm) sowie die APNs Key ID. Diese benötigen Sie 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 den Zugang zum Portal über Ihren CSM anfragen. 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.
Bevor Sie beginnen, suchen Sie Ihren Development Team Name und Ihre Development Team ID. Diese Werte finden Sie, indem Sie sich unter 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.
- Entwicklerteam: Geben Sie Ihren Development Team Name und Development Team ID (eine 10-stellige alphanumerische Zeichenfolge) ein.
- API-Zugriff: Laden Sie Ihre heruntergeladene API Key (.p8) Datei 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 den Apple Unlisted App Antrag bereitzustellen.
- Push-Benachrichtigungen: Laden Sie Ihre APNs Key (.p8) Datei 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 angezeigt werden.
Zum Antrag für die nicht gelistete App: Wenn Ihre App fertig ist, senden wir sie zur Überprüfung ein und weisen die Apple-Prüfer darauf hin, dass sie für das Unlisted-Programm vorgesehen ist. Wir können diesen Antrag nur in Ihrem Namen stellen, wenn Sie uns Admin-Rechte im Konto gegeben haben. Wenn Sie uns weniger Berechtigungen erteilt haben, müssen Sie den Antrag für die nicht gelistete App selbst über https://developer.apple.com/contact/request/unlisted-app/ stellen und „Ja“ auf die Frage „Haben Sie Ihre App zur Überprüfung im App Store eingereicht?“ antworten. Wir müssen dann das Timing koordinieren, damit App und Antrag von Apple zusammen bearbeitet werden. Werden sie nicht zusammen bearbeitet, würde die App automatisch abgelehnt.
Schritt 6: Abschließende Überprüfungen
Überprüfen Sie noch einmal, ob Sie alles auf dieser Liste entweder an Ihren CSM gesendet oder im White Label App Portal hochgeladen haben:
- Development Team Name
- Development Team ID
- Konto-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, an dem Sie hängen geblieben sind, und eventuellen Fehlermeldungen, die Sie sehen. Wir helfen Ihnen gerne weiter.