Follow the instructions below to generate the MDM Apple Push Notification Service (APNS) certificate:
Why is this step required?
You can register an iOS device with WSO2 IoT Server, with or without the WSO2 IoT Server's iOS agent. This certificate is required to carry out operations on the device that need to be triggered via the iOS agent, such as ringing the device, getting the device location, and sending notifications or messages to the device. Therefore, if you are not installing the iOS agent on your devices, you don't need this certificate.
Further, in iOS, the server passes messages to the client via the Apple Push Notification Service (APNS). When doing so in order to establish a secure connection between WSO2 IoT Server and the APNS server, a client SSL certificate needs to be generated and downloaded from Apple Inc. This APNS certificate is used to send an awake message to the iOS agent application.
Go to the Apple Push Certificate Portal at https://identity.apple.com/pushcert/ and log in with your customer account details.
You do not need to have an enterprise account for this purpose, all you need is your Apple ID. If you don't have one, create your Apple ID.
- Click Create Certificate and agree to the terms and conditions.
- Upload the encoded
.plistfile you received via email from WSO2.
- Download the generated MDM signing certificate (
MDM_Certificate.pem). The MDM signing certificate is a certificate for 3rd party servers provided by Apple.
Note down the
USERID(TOPIC ID) from the MDM signing certificate (
MDM_Certificate.pem)as it will be used later in the configuration. The MDM signing certificate can be decoded to obtain the
USERIDby executing the following command:
Remove the password from your private key file (e.g.,
Merge the customer key file that was derived in the latter step, with the MDM signing certificate to generate the MDM Apple Push Notification Service (APNS) Certificate.
For example, merge the
customerKey.pemfile with the
MDM_Certificate.pemfile to generate the
- Open the MDM Apple Push Notification service (APNs) Certificate (
MDM_APNSCert.pem) and ensure that there is a line break between the contents of the two files.
The content will look as follows:
-----END CERTIFICATE----------BEGIN RSA PRIVATE KEY-----
Therefore, add a line break to separate the 2 certificates after 5
-(dashes) so that the content will look like what's shown below:
MDM_APNSCert.pemfile to the
MDM_APNSCert.pfxfile. You will need to provide a password when converting the file. Thereafter, follow the steps mentioned under iOS Platform Configurations.
- Next, you need to generate the APNS certificate.
- If you are not using the WSO2 IoTS iOS agent, you don't need to generate the APNS certificate.
Therefore, you can more to the next step of configuring WSO2 IoTS with the iOS features by installing the P2 repository and configuring the server side settings. For more information, see iOS Server Configurations.