Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/labs64/netlicensing-auth0
Labs64 NetLicensing / Auth0 Integration
https://github.com/labs64/netlicensing-auth0
aav auth0 authentication hacktoberfest oauth openid security validation
Last synced: 13 days ago
JSON representation
Labs64 NetLicensing / Auth0 Integration
- Host: GitHub
- URL: https://github.com/labs64/netlicensing-auth0
- Owner: Labs64
- License: apache-2.0
- Created: 2021-03-14T11:42:08.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2021-03-22T07:18:56.000Z (almost 4 years ago)
- Last Synced: 2024-11-05T18:33:39.664Z (2 months ago)
- Topics: aav, auth0, authentication, hacktoberfest, oauth, openid, security, validation
- Language: JavaScript
- Homepage: https://netlicensing.io/wiki/integrations
- Size: 21.5 KB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Labs64 NetLicensing / Auth0 Integration
[Labs64 NetLicensing](https://netlicensing.io) is a first-class solution in the Licensing as a Service (LaaS) sector. Based on open standards, it provides a cost effective, integrated and scalable platform for software vendors and developers who want to concentrate on their product’s core functionality instead of spending resources on developing an own license management software.
## Rule: Enrich user profile with NetLicensing validation
This rule validates user entitlements using NetLicensing license management services. User e-mail (if available) is being used as a customer identifier.
The validation result is immediately available in the `user_metadata` property and returns data in the ID token.
## Configuration
### Preconditions
- Valid and active NetLicensing vendor profile; register [here](https://ui.netlicensing.io/#/register)
- Working Auth0 configuration (incl. test application)### Configure NetLicensing product
### Configure product module
### Create Auth0 rule
Use [rule-netlicensing-validate.js](https://github.com/Labs64/NetLicensing-Auth0/blob/master/rule-netlicensing-validate.js) as rule content.
### Create NetLicensing API Key
Note: recommended API Key role `ROLE_APIKEY_LICENSEE`
### Required configuration
- `NETLICENSING_API_KEY` - NetLicensing API Key (step 4)
- `NETLICENSING_PRODUCT_NUMBER` - product number (step 1)
- `NETLICENSING_PRODUCT_MODULE_NUMBER` - product module number (step 2)### Rule flow
Created and deployed rule will be executed after user login.
### Sample user info
Enriched user profile can be retrieved using Auth0 API; see [/userinfo](https://auth0.com/docs/api/authentication#user-profile) endpoint.
Userinfo response format specified by [OpenID Connect specification](https://openid.net/specs/openid-connect-core-1_0.html#UserInfoResponse).```json
{
"email": "[email protected]",
"https://netlicensing.io/auth0": {
"id": null,
"infos": {
"info": []
},
"items": {
"hasnext": null,
"item": [
{
"list": [],
"property": [
{
"name": "productModuleNumber",
"value": "MAUTH0"
},
{
"name": "valid",
"value": "true"
},
{
"name": "expires",
"value": "2021-03-21T20:52:45.867Z"
},
{
"name": "productModuleName",
"value": "Subscription module"
},
{
"name": "licensingModel",
"value": "Subscription"
}
],
"type": "ProductModuleValidation"
}
],
"itemsnumber": null,
"pagenumber": null,
"totalitems": null,
"totalpages": null
},
"signature": null,
"ttl": "2021-03-14T21:02:45.867Z"
},
"name": "User",
"nickname": "username",
"picture": "https://avatars.githubusercontent.com/u/1361258?v=4",
"sub": "github|1361258",
"updated_at": "2021-03-14T20:52:45.984Z"
}
```## Bugs and Feedback
For bugs, questions and discussions please use the [GitHub Issues](https://github.com/Labs64/NetLicensing-Auth0/issues).
## Links
- *What is Authentication-Authorization-Validation Framework* - https://netlicensing.io/blog/2020/09/24/authenticate-authorize-validate-framework/