rbisconcini / cpa-service-provider

Reference implementation of an ETSI 103 407: Cross Platform Authentication Service Provider

Cross-Platform Authentication - Service Provider

This project contains a reference implementation of the Cross-Platform Authentication Service Provider.

This software implements version 1.0 of the Cross-Platform Authentication Protocol (ETSI TS 103 407).

More information on the EBU Cross-Platform Authentication project

Prerequisites

Ensure your system has Node.js (v0.10 or later) and NPM installed.

Getting started

$ git clone https://github.com/ebu/cpa-service-provider.git
$ cd cpa-service-provider
$ npm install

Run the tests

$ mkdir data
$ NODE_ENV=test bin/init-db

$ npm test

Configure

The server reads configuration settings from the file config.local.js. An example config for reference is in config.dist.js.

$ cp config.dist.js config.local.js

Edit config.local.js to set the necessary configuration options:

• Database connection settings
• Authorization Provider server URL and access token
• Service provider domain name

Initialise the database

$ NODE_ENV=development bin/init-db

Start the server

$ bin/server

Specify --help to see available command-line options:

$ bin/server --help

Development

This project includes a Makefile that is used to run various tasks during development. This includes JSHint, for code verification, Istanbul for test coverage, and JSDoc for documentation.

As general-purpose tools, these should be installed globally:

$ sudo npm install -g jshint istanbul jsdoc

To verify the code using JSHint and run the unit tests:

$ make

To verify the code using JSHint:

$ make lint

To run the unit tests:

$ make test

To generate a test coverage report (in the coverage directory);

$ make coverage

Related projects

• Tutorial
• Authentication Provider
• Android Client
• iOS Client
• JavaScript Client

Contributors

• Chris Needham (BBC)
• Michael Barroco (EBU)
• Andy Buckingham (Togglebit)

Copyright & license

Copyright (c) 2014-2016, EBU-UER Technology & Innovation

The code is under BSD (3-Clause) License. (see LICENSE.txt)