isabella232 / session-push-notification-server

Server which collects APNS tokens and sends oblivious notifications to iOS devices

Session Push Notification Server

This is a python script for Session remote notification service

API Documentation

Use Python 3.7

To run the server:

Use pip install -r requirements.txt to install all the requirements first.

To start the server, use python server.py

The server is built with Flask and tornado.
The server uses APN for iOS push notifications, PyAPNs2 to interact with APNs, and FCM for Android push notifications.

Right now the server only receives onion requests through the endpoint /loki/v2/lsrpc for

• register: register a device token associated with a session id
• unregister: unregister a device token from a session id's devices
• subscribe_closed_group: add a session id to a closed group as a member
• unsubscribe_closed_group remove a session id from a closed group members
• notify: send a message from remote notification

The new push notification server works this way:

• The client (Session Desktop or Mobile app) sends encrypted message data with the recipients' session id to server.
• The server checks the database to see if the recipients has registered their devices.
• The server generates and sends the push notification to the devices registered with their tokens.

The server will store some statistics data every 12 hours for analysing the traffic going through. The data includes:

• The number of messages sent to the server
• The number of messages sent to closed groups
• The number of push notifications sent to iOS devices
• The number of push notifications sent to Android devices

There is also an endpoint /get_statistics_data to get the data above.