Samenvatting: Deze gids is bedoeld voor IT-beheerders die een op maat gemaakte (whitelabel) iOS-app opzetten. Het begeleidt je bij het inschrijven van je organisatie in het Apple Developer Program, het uitnodigen van Speakap voor je account, het genereren van de benodigde API-sleutels en het invoeren van alles in het Speakap Whitelabel Portal zodat wij je app kunnen publiceren.
Wat is een niet-geliste app?
Een niet-geliste app is een app die niet openbaar wordt geïndexeerd in de App Store. Het wordt verspreid via een enkele URL. Dit betekent dat je een specifieke link nodig hebt om het te downloaden, en het kan niet worden gevonden via de reguliere naamzoekfunctie in de App Store. Deze optie is veel gemakkelijker te verspreiden dan VPP-apps, waarvoor je individuele codes zou moeten kopen en deze onder je gebruikers zou moeten verdelen om hen toe te staan de app te downloaden. De link naar de niet-geliste app in de App Store kan worden getoond op introductiematerialen via een QR-code en kan worden opgenomen in de uitnodigingsmails.
Meer informatie van Apple: https://developer.apple.com/support/unlisted-app-distribution/
Stap 1: Maak een Apple Developer-account aan
Als werknemer bij een bedrijf, non-profitorganisatie, joint venture, partnerschap of overheidsorganisatie volg je deze stappen om je in te schrijven voor het Apple Developer Program. Houd er rekening mee dat jij als persoon die je organisatie inschrijft, de wettelijke bevoegdheid moet hebben om je organisatie aan juridische overeenkomsten te binden. Je moet de eigenaar/oprichter van de organisatie zijn, lid van het directieteam, senior projectleider of een werknemer met wettelijke bevoegdheid die door een senior medewerker is verleend, zoals vermeld bij de Kamer van Koophandel / DUNS.
Wat je vooraf nodig hebt:
- Een Apple ID voor je organisatie met twee-factor-authenticatie ingeschakeld. Je Apple ID-gegevens moeten geldig en up-to-date zijn, inclusief je voornaam, achternaam, adres, telefoonnummer, vertrouwd telefoonnummer en vertrouwde apparaten. Belangrijk: gebruik een Apple ID die gekoppeld is aan een betrouwbaar e-mailadres. We raden een Apple ID aan die door het bedrijf wordt beheerd, zodat toekomstige teamleden het account indien nodig kunnen beheren. Bewaar de inloggegevens veilig in een wachtwoordmanager.
- Een D-U-N-S-nummer dat niet is gekoppeld aan een eenmanszaak, maar aan een naamloze vennootschap, besloten vennootschap (BV), vennootschap onder firma (in sommige gevallen) of non-profitorganisatie. Deze unieke negencijferige nummers worden toegekend door Dun & Bradstreet en worden veel gebruikt als standaard zakelijke identificatoren. Je kunt je nummer opzoeken en er gratis een aanvragen. Meer details: https://developer.apple.com/support/D-U-N-S/
Begin met inschrijven en voer de gegevens van de Account Holder in:
- Ga naar developer.apple.com.
- Ga naar 'Account' en log in met je Apple ID.
- Klik op 'Enroll today' (Vandaag inschrijven), daarna op 'Continue enrollment on the web' (Inschrijving voortzetten op het web).
- Voer je wettelijke voornaam, wettelijke achternaam en telefoonnummer in. Vul geen alias, bijnaam of bedrijfsnaam in als je wettelijke naam, want dit veroorzaakt vertraging bij de beoordeling van je inschrijving.
- Klik op 'Continue' en selecteer 'I develop as a COMPANY/organization' (Ik ontwikkel als een BEDRIJF/organisatie).
Voer de gegevens van je organisatie in:
Geef de volgende gegevens op de volgende schermen:
- Type entiteit.
- Juridische entiteitsnaam: DBAs, fictieve bedrijven, handelsnamen of filialen zijn niet toegestaan. De juridische entiteitsnaam verschijnt als de "verkoper" voor apps die je distribueert. De naam moet exact hetzelfde zijn als op het DUNS-rapport.
- D-U-N-S-nummer: Je organisatie moet een D-U-N-S-nummer hebben zodat de identiteit en juridische status door Apple kunnen worden geverifieerd.
- Hoofdkantooradres en telefoonnummer.
- Website: De website van je organisatie moet openbaar beschikbaar zijn en de domeinnaam moet aan je organisatie gekoppeld zijn.
- Bevestiging van ondertekeningsbevoegdheid: Bevestig dat je de bevoegdheid hebt om je organisatie aan juridische overeenkomsten te binden en geef de contactgegevens van een medewerker die je ondertekeningsbevoegdheid kan verifiëren.
- (Optioneel) Als je organisatie een non-profit, educatieve of overheidsorganisatie is, kun je een vrijstelling van kosten aanvragen.
Voltooi de inschrijving en aankoop:
Nadat je je gegevens hebt ingediend, worden deze door Apple beoordeeld. Zodra ze zijn geverifieerd, ontvang je een e-mail waarin staat dat je je inschrijving kunt voltooien. Dit duurt meestal 7-10 werkdagen.
- Accepteer de Apple Developer Program Licentieovereenkomst/algemene voorwaarden.
- Apple rekent een jaarlijkse lidmaatschapsbijdrage van $99 (USD) voor een organisatieaccount. Lidmaatschap wordt jaarlijks verstrekt als een automatisch verlengbaar abonnement dat doorloopt totdat het wordt geannuleerd. We raden automatische verlenging aan zodat de app niet een jaar later uit de App Store verdwijnt.
- Je kunt je aankoop doen met een van de betaalmethoden van je Apple ID. Als je de creditcard van je organisatie wilt gebruiken, voeg deze dan toe aan de Apple ID die is ingelogd in de instellingen van je apparaat. Dit kan een andere Apple ID zijn dan degene die je gebruikt om je in te schrijven.
Een ontvangstbewijs wordt per e-mail naar je gestuurd en je kunt deze op elk moment opnieuw naar jezelf sturen vanuit Aankoopgeschiedenis in Instellingen. Je kunt je abonnement tot één dag voor de jaarlijkse verlengingsdatum annuleren in Instellingen. Betaalde lidmaatschapskosten voor het jaar waarin je annuleert worden niet terugbetaald. Meer informatie over het beheren van je Apple ID-betaalmethoden.
Stap 2: Nodig Speakap uit voor je Apple-account
- Log in op https://appstoreconnect.apple.com/login.
- Selecteer Users and Access > People en klik op het blauwe plus-teken.
- Voer Voornaam in: Speakap, Achternaam: Development.
- Voer E-mail in: mobile-development@speakap.nl.
- Selecteer de rol Admin.
We vragen om de Admin-rol omdat deze alle benodigde toegang geeft en vertragingen voorkomt als verkeerde permissies worden toegekend. Als je liever geen Admin-toegang geeft, zijn de minimale permissies die we nodig hebben de rol App Manager met de volgende ingeschakelde rechten:
- Toegang tot Certificaten, Identifiers & Profielen
- Toegang tot Cloud Managed Distribution Certificate
- Apps aanmaken
Let op: Om de app te kunnen genereren, moet het Apple Developer-account minder dan 3 "al aangemaakte" distributiecertificaten hebben. Als je al 3 distributiecertificaten in je account hebt, kun je een van de bestaande met ons delen.
Stap 3: Geef ons API-machtigingen
Om de app en updates naar je account te uploaden, hebben we een App Store Connect API-sleutel nodig. Deze kan alleen worden gegenereerd door de "Account Holder" gebruiker van het Apple-account.
- Log in op https://appstoreconnect.apple.com/login.
- Selecteer Users and Access > Integrations > App Store Connect API.
- Je moet mogelijk 'Request Access' (Toegang aanvragen). Gewoonlijk wordt toegang binnen enkele uren tot enkele werkdagen verleend. Soms direct. Ondertussen kun je doorgaan en later terugkeren om dit API-sleutelgedeelte te voltooien.
- Als je toegang hebt, klik je op de knop Toevoegen (+).
- Voer een naam in voor de sleutel. De naam is alleen voor je eigen referentie en maakt geen deel uit van de sleutel zelf.
- Selecteer onder Toegang de rol voor de sleutel. We raden "Admin" aan, omdat dit ons toestaat het uploaden van appversies en het vernieuwen van certificaten te beheren.
- Klik op Generate (Genereren).
- Klik op de link Download API Key naast de nieuwe API-sleutel. Deze sleutel kan maar één keer worden gedownload. Zorg dat je hem op een veilige en toegankelijke plek bewaart.
- Noteer de API Key ID en Issuer ID. Je hebt deze nodig in stap 5.
Meer informatie over het genereren van de API-sleutel: https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api
Stap 4: Lever een .p8-sleutel voor Apple Push Notifications (APNs)
Een geauthenticeerde verbinding met APNs is vereist om pushmeldingen naar een iOS-app te verzenden. Onze aanbeveling is dat je een .p8-bestand aanmaakt en met ons deelt, omdat het .p8-certificaat niet verloopt, terwijl het .p12-certificaat dat wel doet. Als je besluit geen .p8 met ons te delen, kun je nog steeds pushmeldingen ontvangen, maar moet je een .p12-certificaat aanmaken en dit vernieuwen wanneer het verloopt (normaal gesproken jaarlijks).
Let op: Dit is een stap die wij voor je kunnen uitvoeren als je onze gebruiker mobile-development@speakap.nl de hierboven uitgelegde Admin-permissies hebt gegeven. Als je zelf een lokale kopie van de sleutel wilt bewaren, volg dan deze stappen:
- Log in op je Apple Developer-account (https://developer.apple.com/) en ga naar Certificates, Identifiers & Profiles > Keys, klik vervolgens op de blauwe + knop.
- Selecteer Apple Push Notifications service (APNs) en voer een naam in voor de sleutel.
- Vink het vakje 'Apple Push Notifications service (APNs)' aan en klik op 'Configure'.
- Kies exact deze opties: Environment: Production en Key Restriction: Team Scoped (All Topics).
- Sla op, ga verder en selecteer op de volgende pagina Register.
- Download je nieuwe sleutel en bewaar deze op een veilige plek (je kunt hem maar één keer downloaden).
- Noteer de Development Team Name en ID (rechtsboven in het scherm) en de APNs Key ID. Je hebt deze nodig in stap 5.
- Klik op "Done".
Stap 5: Voer je gegevens in het Whitelabel Portal in
Om het proces te voltooien, voer je je Apple Developer-gegevens rechtstreeks in ons portal in. Je kunt toegang tot het portal aanvragen door contact op te nemen met je CSM. Als je CSM al de app-configuratie uploadt naar ons portal, kun je de Apple-accountgegevens ook rechtstreeks per e-mail aan hen sturen. Dus als je toegang hebt tot het White Label App-portal, volg dan deze stappen of deel de onderstaande informatie rechtstreeks met je CSM via e-mail.
Voordat je begint, zoek je je Development Team Name en Development Team ID op. Je vindt deze waarden door in te loggen op https://developer.apple.com/account/resources/certificates/list met je account.
- Log in op het Speakap white-labels portal en ga naar de iOS-sectie (of deel de onderstaande informatie rechtstreeks met je CSM via e-mail).
- Developer team: Voer je Development team naam en Development team ID in (een alfanumerieke tekenreeks van 10 tekens).
- API toegang: Upload je gedownloade API Key (.p8) bestand. Voer de API Key ID en de Issuer ID in.
- Niet-geliste apps: Klik op Fill out questionnaire om de vereiste antwoorden te geven voor het Apple Unlisted App-verzoek.
- Pushmeldingen: Upload je APNs Key (.p8) bestand en voer de APNs Key ID in.
- Klik op Save details om je configuratie af te ronden.
- Er zou een groen icoon aan de linkerkant moeten staan, rechts van het woord Apple.
Over het verzoek voor niet-geliste apps: wanneer je app klaar is, sturen wij deze ter beoordeling in en geven we aan de beoordelaars van Apple door dat het bedoeld is voor hun Unlisted-programma. We kunnen dit verzoek alleen namens jou indienen als je ons Admin-rechten in het account hebt gegeven. Als je ons minder rechten hebt gegeven, moet je het verzoek voor niet-geliste apps zelf indienen via https://developer.apple.com/contact/request/unlisted-app/, waarbij je "Ja" antwoordt op "Have you submitted your app to the App Store for review?". We moeten dan de timing afstemmen zodat de app en het verzoek samen door Apple worden verwerkt. Als ze niet samen worden verwerkt, wordt de app automatisch afgewezen.
Stap 6: Laatste controles
Controleer dubbel of je alles op deze lijst hebt gestuurd naar je CSM of hebt geüpload naar het White Label App Portal:
- Development Team Name
- Development Team ID
- Account e-mail
- APNS .p8 bestand
- APNS Key ID
- API Key .p8 bestand
- API Key ID
- Issuer ID
Blijf je vastlopen?
Stuur ons een e-mail op technicalimplementations@speakap.nl met de naam van je organisatie, de stap waar je vastloopt en eventuele foutmeldingen die je ziet, dan helpen wij je verder.