@first-lego-league/idp

IdP

Identity Provider based on the First Lego League Module Standard

Basic usage

Run using node server.js or npm run start

Principle of operation

The JWT IdP is based upon the redirect binding in SAML, but simpler:

1. The Service Provider(SP), weather using the SP library or not, redirects the user to the Identity Provider(IdP) login URL <idp_url>/login?callbackUrl=<sp_callbackUrl>.
2. The IdP authenticates the user and pulls its details out of the mongodb. NOTICE There is no verification on the callbackUrl parameter, or on the refferer of the redirection, and thereafore anyone can ask to use the IdP without authentication, but without the secret the IdP has, the SP cannot be sure the response was correct and protected.
3. The IdP redirects to the callbackUrl parameter, adding to it the parameter token with the value of the JWT of the user, signed with the secret. The secret must be shared across servers upon startup.

Development

1. Fork this repository
2. make some changes
3. create a Pull Request
4. Wait for a CR from the code owner
5. make sure everything is well
6. merge

A few things to notice while developing:

• Use yarn not npm
• Follow javascript standard as described here
• Keep the service lightweight
• Don't break API if not neccessary, and if you do, change the SP library accordingly.
• Be creative and have fun