diff --git a/README.md b/README.md index d7948eb..10e35ae 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ When using Push Notifications, make sure to check the following: - [ ] Got yourself an Microsoft Azure account and setup a Notification Hub. - [ ] Deploy and subscribe the *Push Gateway*. Use the Notification Hubs authorization keys. -- [ ] **iOS** only - Enable the capability *Push Notification* with your Provisioning Profile. +- [ ] **iOS** only - Enable the capability *Push Notification* with your app `Identifier`. > Please keep in mind that neither Apple or Google guarantee the delivery of a Push Notification. @@ -65,7 +65,17 @@ The latest release can be found [here](https://github.com/SoftwareAG/cumulocity- #### Code Sign -In your Apple developer account, enable the Push Notification service for the App ID assigned to your project. For more information about configuring your developer account, go to your Apple Developer Account page. +##### Create identifier, certificate and provisioning profiles + +In order to re-sign the application, you'll need to prepare your developer account and create an application `Identifier`, a `Certificate` and a `Provisioning Profile`. For more information about configuring your developer account, go to your Apple Developer Account page. + +1) Login to developer.apple.com using your Apple Developer account. +2) Open the section about `Certificates, Identifiers & Profiles` and create `App ID` within the `Identifier` section. Choose a `bundle id` and enable `Push Notifications`. +3) On your Mac, open the keychain access and create a signing authority using a `certificate signing request` (.csr). +4) Create a `Certificate`. Select either `In-House and Ad Hoc` or `iOS App Development` depending on if you like to publish on the Apple AppStore or on your corparate store. Upload your `.csr` file and download the certificate. Double click on your `.cert` file to upload the certificate to your keychain. +5) *(optional)* You can export the certificate as a `p12` file. *A .p12 file is a special-formatted, encrypted file that contains the distribution certificate. It’s embedded in your app when you build it*. +6) Create a `Provisioning Profile`. Under Distribution, select an App Store distribution profile for your platform. Afterwards, select your App ID and your distribution certificate. +7) Establish a token-based connection to APNS in order to authorize sending push notifications. See [this](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_token-based_connection_to_apns) article on developer.apple.com for more information. Create a new `Key` adressing `Apple Push Notifications service (APNs)`. You'll have to download the created `.p8` containing the authentication token. This token needs to be configured on your Microsoft Azure Notification Hub. ##### Using Fastlane