Samenvatting: Deze handleiding is bedoeld voor IT-beheerders die een op maat gemaakte (whitelabel) iOS-app instellen. Het leidt je door het inschrijven van je organisatie bij 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 publiekelijk geïndexeerd wordt in de App Store. Het wordt verspreid via een enkele URL. Dit betekent dat een specifieke link nodig is om het te downloaden en dat het niet gevonden kan worden via de reguliere naamzoekfunctie in de App Store. Deze optie is veel gemakkelijker te verspreiden dan VPP-apps, waarvoor je individuele codes moet aanschaffen en deze onder je gebruikers moet 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 je 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 uitvoerend team, senior projectleider, of een werknemer met wettelijke bevoegdheid die aan jou is verleend door een senior medewerker, zoals vermeld in de Kamer van Koophandel / DUNS.
Voordat je begint, heb je het volgende nodig:
- Een Apple ID voor je organisatie met twee-factor-authenticatie ingeschakeld. Je Apple ID-informatie moet 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. Wij raden een door het bedrijf beheerde Apple ID aan, zodat toekomstige teamleden het account indien nodig kunnen beheren. Bewaar de inloggegevens veilig in een wachtwoordbeheerder.
- Een D-U-N-S-nummer dat niet verbonden is aan een eenmanszaak, maar aan een vennootschap, besloten vennootschap (BV), vennootschap onder firma (in sommige gevallen) of non-profitorganisatie. Deze unieke negen-cijferige nummers worden toegewezen door Dun & Bradstreet en worden veel gebruikt als standaard bedrijfsidentificatoren. 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 Accounthouder in:
- Ga naar developer.apple.com.
- Ga naar 'Account' en log in met je Apple ID.
- Klik op 'Enroll today', daarna op 'Continue enrollment on the web'.
- Voer je wettelijke voornaam, wettelijke achternaam en telefoonnummer in. Voer 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'.
Voer de gegevens van je organisatie in:
Geef het volgende 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 precies 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 entiteitsstatus door Apple geverifieerd kunnen worden.
- Hoofdkantooradres en telefoonnummer.
- Website: De website van je organisatie moet publiekelijk 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 informatie hebt ingediend, wordt deze door Apple beoordeeld. Zodra dit is 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. Het lidmaatschap wordt jaarlijks verstrekt als een automatisch verlengbaar abonnement dat wordt verlengd totdat het wordt geannuleerd. Wij raden automatische verlenging aan zodat de app niet na 1 jaar 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 naar je gemaild en je kunt het 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 gerestitueerd. 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 plusteken.
- 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 toegang geeft die we nodig hebben en helpt vertragingen te voorkomen als verkeerde rechten worden toegekend. Als je liever geen Admin-toegang geeft, zijn de minimale rechten 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
Opmerking: 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 er een van de bestaande met ons delen.
Stap 3: Geef ons API-machtigingen
Om de app en de 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' aanvragen. Meestal wordt toegang binnen enkele uren tot enkele werkdagen verleend. Soms direct. Ondertussen kun je doorgaan en later terugkeren om deze API-sleutelsectie te voltooien.
- Klik op de knop Toevoegen (+).
- Voer een naam in voor de sleutel. De naam is alleen voor jouw referentie en maakt geen deel uit van de sleutel zelf.
- Selecteer onder Toegang de rol voor de sleutel. Wij raden "Admin" aan, omdat dit ons toestaat het uploaden van app-versies en het vernieuwen van certificaten te beheren.
- Klik op Generate.
- Klik op de link Download API Key naast de nieuwe API-sleutel. Deze sleutel kan slechts één keer worden gedownload. Zorg dat je deze op een veilige en toegankelijke plek opslaat.
- 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 aan voor Apple Push Notifications (APNs)
Een geauthenticeerde verbinding met APNs is vereist om pushmeldingen naar een iOS-app te sturen. 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 elk jaar).
Opmerking: Dit is een stap die wij voor je kunnen uitvoeren als je onze gebruiker mobile-development@speakap.nl de hierboven uitgelegde Admin-machtigingen hebt gegeven. Als je zelf een lokale kopie van de sleutel wilt bewaren, volg dan zelf 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 selectievakje 'Apple Push Notifications service (APNs)' aan en klik vervolgens op 'Configure'.
- Kies precies deze opties: Environment: Production en Key Restriction: Team Scoped (All Topics).
- Sla op, klik op Doorgaan, en selecteer op de volgende pagina Register.
- Download je nieuwe sleutel en bewaar deze op een veilige plek (je kunt deze 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 bezig is met het uploaden van de app-configuratie naar ons portal, kun je hen eenvoudig je Apple-accountgegevens rechtstreeks mailen.
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-label portal en ga naar de sectie iOS.
- Developer team: Voer je Development teamnaam 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 voor het Apple Unlisted App-verzoek te geven.
- 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 pictogram aan de linkerkant moeten zijn, rechts van het woord Apple.
Over het verzoek voor de niet-geliste app: wanneer je app klaar is, sturen wij deze ter beoordeling in en geven wij aan de beoordelaars van Apple door dat deze 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 coördineren 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 naar je CSM hebt gestuurd 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
Nog steeds vastgelopen?
Stuur een e-mail naar technicalimplementations@speakap.nl met je organisatienaam, de stap waar je vastloopt en eventuele foutmeldingen die je ziet, dan helpen we je verder.