SDK

Platform configuration

Before you can start sending messages in iOS, you will have to issue a APNS certificate. This is done via Apple's Developer Portal. Keep reading this document to learn how to create an APNS certificate.

Creating an App ID

In this document we will assume you did not create an App ID yet and we will guide through this process.

Start by signing in Apple's Developer Portal. Once you've sign in, you should click in the Certificates, IDs & Profiles menu item:

Developer portal menu 26d9f13017

This will take you to a new page where you should locate the Identifiers menu item:

Developer portal identifiers 9733ae6534

In this new page, click in the plus icon:

Developer portal create app id 69beff6298

In this page, select the App IDs option:

Developer portal app ids a12d740678

Then go ahead and click in Continue:

Developer portal continue button 7a2ba64f8e

You are now about to register a new app, start by providing a name for your app and the identifier for your app, this should take the form of a reverse DNS name (eg.: com.mydomain.myapp):

Developer portal app id settings 95d26260e1

Finally you should select which capabilities your app will use. Obviously you should check all the services you want to use:

Developer portal capabilities 4d49d42c6b

Once you are done selecting your app's capabilities, click in Continue:

Developer portal continue button 7a2ba64f8e

You will then see the confirmation screen with all the services you've selected, if everything is OK go ahead and finish creating your App ID by clicking in Register:

Developer portal app id confirm c59c96c4fc

After that, your app will be in the list of App IDs as shown below:

Developer portal app id e243cd11ec

Generate an APNS Certificate

Once you've created an App ID or at least have one, you are now ready to create an APNS certificate. This certificate will allow your app to send messages to APNS.

In Apple's Developer Portal, locate the Certificates, IDs & Profiles menu item:

Developer portal menu 26d9f13017

In this new page, click in the Certificates menu item:

Developer portal create certificate e50a547578

Then go ahead and click in the plus icon:

Developer portal create certificate icon 1f8936ae01

In this page, locate the select the following option:

Developer portal ssl certificate select bd98193784

For the sake of simplicity, let's create an Apple Push Notification Service certificate that works for both Sandbox and Production. You can then use the same certificate for both environments in Notificare.

Go ahead and click in Continue:

Developer portal continue button 7a2ba64f8e

In this new page, locate and select the App ID you want to use:

Developer portal select app id for apns e0da7eb2aa

To proceed, click in Continue:

Developer portal continue button 7a2ba64f8e

In this new tab, you will need to provide an existing Certificate Signing Request:

Developer portal certificate signing request c43a29c960

We will explain how to generate one but if you already have one previously created, just go ahead and select one and click in Continue:

Developer portal continue button 7a2ba64f8e

If you do not have one, you will have to generate it. For that you will need to open the Keychain Access app from your applications, in your MacOS powered computer and request a signing certificate from an certificate authority by selecting the following:

Developer portal keychain access request 82a1aa814b

You will be prompt with the following window:

Developer portal create signing certificate b0da07559d

Simply provide an email and check the Saved to Disk option and then click in Continue, it will prompt you to save a file in your computer:

Developer portal save signing certificate 1f42b11799

You have now generated a CSR file and you we are ready to resume our the APNS certificate creation in Apple's Developer Portal. In the screen you left off:

Developer portal certificate signing request selected 2687abcce2

Click in the Continue button:

Developer portal continue button 7a2ba64f8e

We've now generated an APNS certificate, hit the Download button to download the file to your computer:

Developer portal certificate download 1c109385e8

Double-click in that file to install it in your Keychain Access app. Then locate it in the Keychain Access app:

Developer portal keychain access entry b3315f3858

Then we will need to export this file in a .p12 format. To do that, right-click the file and select the Export option:

Developer portal export certificate keychain 06276d0027

This will allow you to name your export file and select the location in your computer where you going to export it. Then click in Save:

Developer portal export p12 save 1e7507b4ea

Because these files are extremely important and will give any push provider access to send notifications to your app, you will want to protect it with a password. Once you've provided a password twice, click in the OK button. This will save the file in your computer.

Developer portal export p12 password 2b0215fe64

You now have to upload the resulting .p12 file to Notificare. This will allow us to send notifications to your application. This step is covered in the guides located here.

Once you have uploaded the certificate you are ready to proceed to implement our library. Keep reading our Implementation guides located here.