Important note: We are archiving this prject. Contact Vonage support if you have questions.
The OpenTok Interactive Broadcast Solution Backend is based on Apache Hadoop and uses Firebase as the underlying storage.
This document describes how to create an OpenTok Interactive Broadcast Solution Backend Server.
Use the backend server to manages interactive broadcast events. Use it in conjunction with the Interactive Broadcast Solution client apps for the web, iOS, and Android.
Clone the repository and cd to the project directory.
git clone https://github.com/opentok/interactive-broadcast-api
cd interactive-broadcast-apiInstall yarn:
npm install -g yarnInstall dependencies:
yarnSet environment (vars):
cp .env.example .envEdit the .env file:
NODE_ENV=development
PORT=3001
JWT_SECRET=0a6b944d-d2fb-46fc-a85e-0295c986cd9f
INTERACTIVE_STREAM_LIMIT=2
BUCKET_URL=INSERT_HEREReplace these values with the following:
-
NODE_ENV-- Your Node environment setting, eitherdevelopmentorproduction. -
PORT-- The port for the backend service should use. -
JWT_SECRET-- The backend uses this string to generate JWT tokens used to validate all client requests. -
INTERACTIVE_STREAM_LIMIT-- The maximum number of active fans to allow in an event. After this limit is reached, a fan connecting to the event will see the HLS broadcast of the event, and the fan will not be able to join the event interactively by publishing their audio-video stream. (Note that Safari users will always receive the HLS broadcast, since OpenTok is not currently supported in Safari.) -
BUCKET_URL-- The URL of your Amazon S3 bucket, such ashttps//s3.amazonaws.com/yourBucketName.
Add you Firebase credentials to the /config/config.js file.
const config = {
env: envVars.NODE_ENV,
port: envVars.PORT,
jwtSecret: envVars.JWT_SECRET,
fireBaseAuthDomain: 'your-app-id.firebaseapp.com',
firebaseDatabaseURL: 'https://your-app-id.firebaseio.com',
firebaseProjectId: 'your-app-id',
firebaseStorageBucket: 'your-app-id.appspot.comx',
interactiveStreamLimit: envVars.INTERACTIVE_STREAM_LIMIT || Infinity,
};Set the following values:
-
fireBaseAuthDomain-- Your Firebase authentication domain. This will look like'your-app-id.firebaseapp.com'. -
firebaseDatabaseURL-- Your Firebase database URL. This will look like'https://your-app-id.firebaseio.com'. -
firebaseProjectId-- Your Firebase project ID. This will look like'your-app-id'. -
firebaseStorageBucket-- Your Firebase storage bucket. This will look like'your-app-id.appspot.com'.
Start the server:
yarn start# compile to ES5
1. yarn build
# upload dist/ to your server
2. scp -rp dist/ user@dest:/path
# install production dependencies only
3. yarn --production
# Use any process manager to start your services
4. pm2 start dist/index.jsThis section details the inner workings of OpenTok Interactive Broadcasting Solution Backend.
The Interactive Broadcasting Solution Backend consists of various services:
Manage operation over administrator users. It implements the following methods:
getAdmins => Gets the list of admins
getAdmin => Gets a particular Admin from firebase
createAdmin => Creates an admin
createUser => Creates an user in firebase-admin
updateUser => Updates an user in firebase-admin
updateAdmin => Updates an admin
deleteAdmin => Deletes an admin in firebase-admin
deleteUser => Deletes an user in firebase-adminHandles authentication using the following methods:
login => Returns jwt token if valid username and password is provided for an admin or producer.
loginFan => Returns jwt token if valid username and password is provided for a fan user.
loginHost => Returns jwt token if valid username and password is provided for a host user.
loginCelebrity => Returns jwt token if valid username and password is provided for a celebrity user
updateUser => Updates an user in firebase-admin
updateAdmin => Updates an admin
deleteAdmin => Deletes an admin in firebase-admin
deleteUser => Deletes an user in firebase-adminManages the broadcast session, implements these methods:
getBroadcastData => Returns data required for the client to connect to the broadcast (CDN) feed.
endBroadcast => End the broadcast.
eventGoLive => Puts the event live.Exports the following Props.
Data of the admin users
const adminProps = [
'id',
'displayName',
'otApiKey',
'otSecret',
'superAdmin',
'httpSupport',
'email',
'hls',
'createdAt',
'updatedAt'
];Contains common data of all the users disregarding the role:
const userProps = ['displayName',
'email',
'password'
];These Props represent private data for the events.
const eventProps = [
'id',
'name',
'startImage',
'endImage',
'fanUrl',
'celebrityUrl',
'hostUrl',
'archiveEvent',
'status',
'dateTimeStart',
'dateTimeEnd',
'sessionId',
'stageSessionId',
'archiveUrl',
'archiveId',
'redirectUrl',
'uncomposed',
'showStartedAt',
'showEndedAt',
'adminId',
'rtmpUrl',
'createdAt',
'updatedAt'
];Contains data publicly visible from the events
const eventPublicProps = [
'id',
'adminId',
'name',
'startImage',
'endImage',
'fanUrl',
'celebrityUrl',
'hostUrl',
'status',
'dateTimeStart',
'dateTimeEnd'
];The current timestamp.
The creation timestamp of an event.
The last timestamp at which an event was updated.
Array containing the possible status values for an event.
const eventStatuses = {
NOT_STARTED: 'notStarted',
PRESHOW: 'preshow',
LIVE: 'live',
CLOSED: 'closed'
};Handles interaction with the events database using the following methods.
getEvents => Get the list of events by admin
create => Save an event
update => Updates an event
deleteEvent => Deletes an event
getEvent => Get a particular Event
deleteEventsByAdminId => Delete events by AdminId
getEventByKey => Get a particular Event by primary key <slug, adminId>
changeStatus => Change status of an event.
startArchive => Starts archive
stopArchive => Stops archive
createTokenProducer => Create the tokens for the producer, and returns also the event data
createTokenHostCeleb => Create the token for the host or celebrity, and returns also the event data
getEventBySessionId => Get a particular Event by sessionId
createTokensFan => Create the tokens for the fan, and returns also the event data
getMostRecentEvent => Get the last event that is `live` or `preshow`
createTokenByUserType => Get credentials for the last event that is `live` or `preshow`
getEventsByAdmin => Get the list of events by admin for mobile apps without tokenInitializes the app with a service account, granting admin privileges.
firebase.initializeApp({
databaseURL: config.firebaseDatabaseURL,
credential: firebase.credential.cert(serviceAccountCredentials)
});It implements the verifyIdToken method that verifies an IdToken with firebase
const verifyIdToken = async (idToken) => {
try {
const decodedToken = await firebase.auth().verifyIdToken(idToken);
return decodedToken.user_id;
} catch (error) {
return null;
}
};and also exposes a file method which utilizes the google cloud storage API to interact with files in firebase storage.
This service is in charge of managing OpenTok tokens and archiving using the following methods:
createSession => Returns a new OpenTok session, along with the corresponding OpenTok API key.
createToken => Creates an OpenTok token
startArchive => Starts the archiving and returns the archiveId
stopArchive => Starts the archiving and returns the archiveId
otRoles => Array containing the user roles
getAdmins => Gets the list of admins
getAdmin => Gets a particular Admin from firebase
createAdmin => Creates an admin
createUser => Creates an user in firebase-admin
updateUser => Updates an user in firebase-admin
updateAdmin => Updates an admin
deleteAdmin => Deletes an admin in firebase-admin
deleteUser => Deletes an user in firebase-adminThe Interactive Broadcasting Solution Backend uses the validation.js middleware to convert the OpenTok data to a json format imeplementing the following API methods:
validateApiKey => Checks if the `APIKey` and `APISecret` are valid.
validateEvent => Validates if the event already exsists by comparing the event id with the existing events
checkAdmin => Check the role of the user is Admin, if not returns an authentication error.
checkFan => Similar to `checkAdmin`, checks if the role of an user is Fan
checkCelebHost => Similar to `checkAdmin`, checks if the role of an user is Celebrity or HostInterested in contributing? We ❤️ pull requests! See the Contribution guidelines.
We love to hear from you so if you have questions, comments or find a bug in the project, let us know! You can either:
- Open an issue on this repository
- See https://support.tokbox.com/ for support options
- Tweet at us! We're @VonageDev on Twitter
- Or join the Vonage Developer Community Slack
- Check out the Developer Documentation at https://tokbox.com/developer/
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent