Adding details for Platforms

Based on requirement, choose Apple, Android, or Windows platforms and enter details. You can skip other platforms by clicking Next. You need to configure at least one platform to save and publish the application successfully:

• Apple
• Android
• Windows

Apple

An SSL certificate secures communication with Apple’s push notification servers. The private key resides securely on Volt MX servers, and Apple uses the public key for authentication.

1. To configure the Apple platform, enter details for the following fields:

   • Application Mode: (Production or Development): By default, the application mode is set to production. Based on your requirement, select production or development.

     The application mode indicates the current status of the project. Push certificates are changed depending on the choice of application mode, and each mode requires a separate certificate.

     Production mode: When selected, real time certificates and associated password details are used to send push notifications. Binary (.ipa) files that will need to be directly installed on the device will need production certificate.

     Development mode: When selected, you can send push message notifications using Apple’s demo server. This will also mean that the app has be to directly compelled on the device.

     You can run web applications in a specific mode depending on the current state of the project. For example, if you develop an application, you run the application in the development mode; if you test an application, you run the application in the test mode; if you launch an application, you run the application in the production mode.

   • Upload iPhone Push Certificate: Click the Browse button to upload the certificate for iPhone.

     Note:
     Click the Create the Apple Push Notification Certificate (APNS) link for more details on how to generate an Apple certificate.
     Click the Renew the Apple Push Notification Service (APNS) Certificate link for more details on how to renew an Apple Certificate
     While modifying an application, you can also test the certificate for validation by clicking the Test Connectivity* button.

   • Certificate Password: Enter the password for iPhone.

   • Upload iPad Push Certificate: By default, the No option is set to active. Select the Yes option, if you want to upload the certificate for iPad. The system displays the Choose File and iPad Certificate Password fields.

     

   • Click the Choose File button to upload the certificate for iPad. If you select the Yes option and click Next without providing a certificate for iPad, then the system displays a warning message to provide a p12 certificate for iPad.

   • iPad Certificate Password: Enter a password for the iPad certificate.
   • Click Save to save the specified details and proceed.
   • Click Cancel to close the Add New App page.

Android Platform

Firebase Cloud Messaging for Android (FCM) is a service that helps you to send data from servers to Android applications on Android devices. This can be a message telling the Android application that there is new data to be fetched from the server (for example, a movie uploaded by a friend), or it can be a message containing up to 4kb of payload data (so apps like instant messaging can consume the message directly). The GCM service handles all aspects of queuing of messages and delivery to the target Android application running on the target device.

To configure Android platform, follow these steps:

FCM HTTPV1 API

1. FCM Project URL and Service Account key: Provide FCM Project URL and Service Account Key

   Note: * Click the Create FCM Project URL and Service Account Key via firebase console link for more details on how to create FCM Project URL and Service Account Key. * While modifying an application, you can also test the FCM Project URL and Service Account Key validation by clicking the Test Connectivity button.
   2. Click Test Connectivity button to check FCM Project URL and Service Account Key valid or not. The system displays the confirmation message that FCM connection test is successful.

JPush

The Engagement server supports JPush for geographies where Android push is not allowed like in China. The AppKey and MasterSecret are obtained by registering an application with Jpush.

1. JPush > App Key: Enter the app key.

2. JPush > Master Secret: Enter the master secret.

   Note: Click the Create a JPush App Key and Master Secret link for more details on how to subscribe to the JPush key.

3. Click Next Step to save the specified details and proceed.

4. Click Back to navigate to the previous step if you want to make any changes.

Create FCM Project URL and Service Account Key via firebase console

To create a FCM Project URL and Service Account Key, follow these steps:

1. Open firebase console.

2. If you have not created an API project, then click Create Project.

   Note: The project name is used only in the console. The project ID is used to uniquely identify project name. The identifier cannot be changed.

3. Once a project is created, Click on project name and goto project setting and under general tab you will find your project name project ID and project number, for example 670330094152.

4. In Project Setting click on cloud messaging tab and Enable Firebase Cloud Messaging API (V1) by clicking three dots on right side.

5. Create FCM Project URL

   https://fcm.googleapis.com/v1/projects//messages:send

6. Create Service Account Key

   In Project Settings click on Service Accounts and select the java then Generate new private key

Create a JPush App Key and Master Secret

JPush is a push notification service that performs push notifications to Android, iOS and Windows Phone apps in geographies where Google services are not allowed. Currently the Engagement Server supports the push notifications via Jpush for Android devices only.

To create a JPush key, follow these steps:

1. In a browser, enter the URL of the JPush website https://jpush.cn.

2. Click Learn More to enter the portal.

   The JPush home page appears.

   Note: For readability, use the Google Translate option available in the menu bar.

3. Click the Register button next to the log - in button at the top right corner of the home page.

   The first Register page appears.

4. To register with JPush, complete the following fields:

   • User Name: Enter the user name to register with JPush. The user name should include between five to 20 characters.

     Note: Do not include special characters in a user name. You can use a combination of letters, numbers, and underscores.

   • Password: Enter a password to create your account.

   • Confirm Password: Re-enter the password to confirm it.
   • Click I agree, Register now.

   The second Register page appears.

5. Enter details for the following fields:

   • User Name: Enter the user name that you entered in the Register window.
   • Organization: Enter name of the organization, where you work.
   • Email: Enter your personal mail address.
   • Phone Number: Enter your contact number.
   • Push: Enter a push message.
   • Security Code: Enter the displayed security code to confirm your authenticity.
6. Click the Complete Registration button to continue.
7. The JPush page appears with a confirmation message that the authentication message is sent to the registered email address. Access your email account, and open the email sent through JPush to authenticate your user account.

8. Click the log-in button next to the Register button at the top right corner of the home page.

   The log-in window appears.

9. Enter details for the following fields:

   • User ID: Enter your user ID.
   • Password: Enter your password.
   • Confirmation Code: Enter the code to show your account is not spam.

10. Click log in to continue.

    The Application page appears.

11. Click Creating Applications to create your own application.

12. Enter details for the following fields:

    • Application Information:
      • Application Name: Enter a name for the application.
      • Application Icons: To provide an icon for the application, then click Choose File to browse the icon from its location. The selected icon name appears next to the Choose File button.

    • Android:

      • Application Name: Enter the application package name, such as com.example.BankingApp

      Note: The current procedure explains about how to register with Android platform and details about iOS and WinPhone are not stated here.

13. Click Create my application to continue.

    The Application Information page appears.

14. Record the Appkey and Master Secret for your reference.

15. To view Master Secret, click View and Copy.
16. Click Modify the Application to update the application details. Based on your requirement, complete the changes to update the application.

17. Click Save Changes to update the application details.

    Note: Click Remove Application to remove the application from JPush.

Windows Platform

Windows Platform window has two sections:

• MPNS
• WNS

1. To configure Windows platform, enter details for the following fields:

   • MPNS 

     1. Targeted Platforms: In the Windows Phone 7 and Windows Phone 8 section, select appropriate check boxes to enable as targeted platforms.

        If secure communications is needed, the Windows push certificate can be used. This is a purchased SSL certificate, which is converted into the correct format to upload on Volt MX Foundry Engagement Services. It is not required and can be used only when secure communication is needed.

   • WNS:

     Windows Secret is an associated secret key that contains strings used for authentication with Volt MX Foundry Engagement Services APIs. Windows Secret is used for authentication on the client side during registration.

     Windows SID is a security identifier that is a unique identifier of a user, user group, or other security principal, and cannot be changed. A security principal has a single SID for life, and all properties of the principal, including its name, are associated with the SID. The design allows a principal to be renamed (for example, from "John" to "Jane") without affecting the security attributes of objects that refer to the principal.

     1. Secret: Enter the secret key details.
     2. SID: Enter the SID details.
     3. Click Validate Credentials. If credentials are valid, then the system displays the confirmation message that Windows 8 credentials are valid.
     4. Click Save to save the specified details and proceed. The newly created app appears on Apps home page. The default status is unpublished.