How to implement mobile push notification with Oracle Notification Service (ONS), Oracle Functions, and Firebase Cloud Messaging (FCM)

1. Aug 2020
Donghu Kim
Push Notification with ONS and FCM

2. 2 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Architecture
Mobile DeviceApp Server
Firebase Cloud
Messaging
Oracle
Functions
Oracle
Notifications

3. 3 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Architecture
Mobile DeviceApp Server
Firebase Cloud
Messaging
Oracle
Functions
Oracle
Notifications

4. 4 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Creating and Adding an app to Firebase Cloud Messaging

5. 5 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Architecture
Mobile DeviceApp Server
Firebase Cloud
Messaging
Oracle
Functions
Oracle
Notifications

6. 6 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Building and Deploying a function to OCI
You can refer to the below links.
• https://github.com/MangDan/oracle-functions-graalvm-handson (Korean)
• https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Concepts/functionsoverview.htm(Official
Guide)
1. Installing and Setting up the OCI-CLI
• https://docs.cloud.oracle.com/en-us/iaas/Content/API/SDKDocs/cliinstall.htm
2. Install Fn Project
• https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Tasks/functionsinstallfncli.htm
3. Creating an Fn Project CLI Context
• https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Tasks/functionscreatefncontext.htm
4. Creating a function application
• https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Tasks/functionscreatingapps.htm
5. Creating, Deploying, and Invoking a Function
• https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Tasks/functionscreatingfirst.htm

7. 7 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Function Example (node.js)
Source: https://github.com/mangdan/oci-functions/tree/master/
const fdk=require('@fnproject/fdk');
const admin=require('firebase-admin');
const serviceAccount = require('./path/to/fcn-test-d468e-firebase-adminsdk-91ox1-e86d9984ce.json’); // replace your firebase admin
sdk json file
var app = admin.initializeApp({
credential: admin.credential.cert(serviceAccount),
databaseURL: 'https://fcn-test-d468e.firebaseio.com'
});
const fcm = admin.messaging();
fdk.handle(async function(input){
console.log(input.message.notification);
const payload = {
notification: input.message.notification,
data: input.message.data,
token: input.message.token
};
const response = await fcm.send(payload);
return "successfully sent message:" + response;
})

8. 8 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Architecture
Mobile DeviceApp Server
Firebase Cloud
Messaging
Oracle
Functions
Oracle
Notifications

9. 9 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Creating a Oracle Notification Topic and Subscription
Navigation: OCI Console – Application Integration > Notifications
1. Create Topic 2. Create Subscription
Protocol: fucntions
Function Application: push-notification-for-ons-app
Function: push-notification-for-ons-func

10. 10 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Publish a Message using console UI
Navigation: OCI Console – Application Integration > Notifications > Select topic > publish message
Publish Message Message Format
{
"message": {
"notification": {
"title": "TitleTest",
"body": "Sample message for Android endpoints"
},
"data": {
"picture": "https://i.imgur.com/bY2bBGN.jpg",
"link": "https://example.com"
},
"token":
"dENbszoqxqI:APA91bGfazCIFLCqMBI9Tsb5f9oGkvkeykz70NULzI-
OTaFBqhzwTPt2SPS2tDfm-
V2O9lJsfYk5gKYppqJksFl5CqOtubeIwpJ4_zSwPzm15erTkfM6iQsIycrYfgt
sWDNPzF3y-nbv"
}
}

11. 11 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Architecture
Mobile DeviceApp Server
Firebase Cloud
Messaging
Oracle
Functions
Oracle
Notifications

12. 12 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Sample Node.js Server Application to publish a message to topic
async function pushMessage(message) {
// logger.log('info', `runShippingExtractionJob for ${JSON.stringify(input)} for file ${objectName}`)
auth.RESTversion = '/20181201';
parameters.method = 'POST';
parameters.topicId = 'ocid1.onstopic.oc1.ap-seoul-1.aaaaaaaajapefqh6ujbz7v4d2hkpjal7lfwfad7mnpr6eznkvrumjrgtjswa'; // Please replace your topic ocid
parameters.path = 'messages';
parameters.body = message;
notifications.topic.publish(auth, parameters, callback);
return;
}// pushMessage
var message = {
"message": {
"notification": {
"title": "TitleTest",
"body": "Sample message for Android endpoints"
},
"data": {
"picture": "https://i.imgur.com/bY2bBGN.jpg",
"link": "https://example.com"
},
"token": "dENbszoqxqI:APA91bGfazCIFLCqMBI9Tsb5f9oGkvkeykz70NULzI-OTaFBqhzwTPt2SPS2tDfm-
V2O9lJsfYk5gKYppqJksFl5CqOtubeIwpJ4_zSwPzm15erTkfM6iQsIycrYfgtsWDNPzF3y-nbv”. // please replace your application token
}
};
// call
pushMessage({ title: "Push notification test", body: JSON.stringify(message)})
publishMessage.js
Source:
https://github.com/MangDan/oci-api/tree/master/javascript
https://github.com/MangDan/oci-api/blob/master/javascript/services/notifications/examples/publishMessage

13. 13 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Test Sample Node.js Server Application
1. Download Sample Source
• git clone https://github.com/MangDan/oci-api.git
2. Run node.js
• cd ./oci-api/api/javascript/services/notifications/examples
• node publishMessage.js
3. Monitoring a topic and functions
• OCI Console > Application Integration > Notification > Select a Topic from list > Metrics
• OCI Console > Developer Services > Functions > Select a function application > Metrics

14. 14 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Demo
1. Run a node.js
2. Notification Metrics 3. Functions Metrics

15. 15 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
Demo
4. Firebase Cloud Messaging Report 5. Notification Message on your device

16. 16 Confidential – © 2019 Oracle Internal/Restricted/Highly Restricted
References
https://github.com/MangDan/oci-api/tree/master/javascript/services/notifications/examples (Server
Application example to publish a message to a topic)
https://github.com/MangDan/oci-functions/tree/master/push-notification-for-ons (Functions example to send
a message to FCM)
https://github.com/MangDan/oracle-functions-graalvm-handson (Functions Hands-On Guide, Korean)
https://docs.cloud.oracle.com/en-us/iaas/Content/Functions/Concepts/functionsoverview.htm (Functions
Official Guide, English)
https://docs.cloud.oracle.com/en-us/iaas/api/#/en/notification/20181201/NotificationTopic/PublishMessage
(Notification PublishMessage REST API)