Certificates
Introduction
In order to communicate with Apple devices, CapaInstaller relies on the Apple Push Notification service (APNs). The APNs require that each service identifies itself by using a certificate issued by Apple, ensuring that only authorized services can contact Apple devices.
Before an APNs certificate can be issued using the Apple Push Certificate Portal, a certificate request must be generated and signed by an authorized MDM vendor, in this case, CapaSystems A/S.
To upload the certificate request to Apple, an Apple ID is required. It is strongly recommended that a unique Apple ID is created for this purpose, DO NOT use your personal Apple ID for this.
New Apples Push Certificate Protocol
Apple has announced a new protocol must be used for the Apple Push Notification service as of March 29th, 2021 as well a new root certificate must be incorporated in the MDM solution.
In CapaInstaller 6.1 both were implemented. To make installations simpler and easier to maintain, Apple Push Certificate is uploaded to CapaInstaller's Cloud service - the certificate is no longer installed on MDM server(s).
Apple Push Notification Certificate in CapaOne
From CapaInstaller 6.1 Push messages for Apple and Android are sent from CapaOne and new features are available only on the MDM Portal. To link between your installation and CapaOne you must have a Portal Access Token in the console.
Check if you already have a Portal Access Token:
Portal Access Token | |
|---|---|
Open System Administration module in CapaInstaller Console, select Software Accounts and then right click on CapaOne and select Properties. If you have a Portal Access Token you don't need to do further. If you don’t have an access token, follow this guide: 
|
To generate a new APN Certificate follow the Apple Push Certificate Request from CapaInstaller Console. Uploading the certificate is done automatically. Just follow the guide below.
Request and generate or update an Apple Push Certificate
Step | Action |
|---|---|
1 | It’s recommended to run this wizard in console on the CapaInstaller Server. In the System Administration module, select menu item Actions, then select Apple Push Certificate request. 
|
2 | Wizard starts, press the Next button to proceed
|
3 | If the "Verify OpenSSL" isn't status Passed go to Install OpenSSL If the "Verify access to CapaInstaller certificate request signing service" isn't status passed you must: Try to open a browser on the machine from which you run this wizard. Open the following URL: https://api.capaone.com/certservice/status Ensure that port 443 is opened from the CapaInstaller server out to the internet. The certificate request signing service is placed on a CapaInstaller server at port 443. If “Verify OpenSSL” is passed, click Next
|
4 | Select an output folder. Press the Start button, and click Next when the certificate request is finished
|
5 | Now you have created the certificate request which has been signed by CapaSystems and stored in the previously selected output folder |
6 | Select Open Apple Push Certificates Portal
|
7 | Log in with your Apple Push Certificates Portal account
|
8 | Select Renew on the proper certificate
|
9 | If this disclaimer appears then just accept it |
10 | Select Choose File and select the file named: “plist_encoded”, it is stored in the output directory. In Notes field, type the name of the MDM server. Click Upload
|
11 | The certificate is created. Click Download to download the certificate. NB! It’s recommended to add an event in your calendar about it will expire a month before the certificate's expiring date.
|
12 | Continue the wizard in the CapaInstaller Console. Select Create Certificate File button in the CapaInstaller certificate Wizard in order to continue the certificate issuing process.
|
13 | In the "Apple certificate File" select the certificate downloaded from the Apple push Cert page. (Named: MDM_something.pem) When that is done, press the start tab and then click next
|
14 | Now you have the Apple Push Certificate in your output folder (File extension is pfx)
|
15 | A new Apple Push Certificate has been generated and uploaded to CapaOne.
|
16 | Logon to CapaOne for CapaInstaller and select Certificates Check the certificate is uploaded and valid
|