auth0-extensions / auth0-account-link-extension

An extension aimed to help link accounts easily
MIT License
27 stars 77 forks source link

Auth0 Account Link Extension

This extension provides a rule and interface for giving users the option of linking a new account with an existing registered with the same email address from a different provider.

NOTE: Please make sure you are using your own social connections (Google, Facebook, etc...) API keys. Using Auth0's keys will result on an 'Unauthorized' error on account linking skip.

Example:

Running in Development

Update the configuration file under ./server/config.json:

{
  "EXTENSION_SECRET": "mysecret",
  "AUTH0_DOMAIN": "me.auth0.com",
  "AUTH0_CLIENT_ID": "myclientid",
  "AUTH0_CLIENT_SECRET": "myclientsecret",
  "WT_URL": "http://localhost:3000",
  "AUTH0_CALLBACK_URL": "http://localhost:3000/callback"
}

Then you can run the extension:

nvm use 8
yarn install
yarn run build
yarn run serve:dev

Running puppeteer tests

In order to run the tests you'll have to start the extension server locally, fill the config.test.json file (normally with the same data as the config.json file) and run the Sample Test application located in sample-app/ (create a dedicated client for this app).

Then, you can run the tests running:

yarn test

Release Process

Deployment is currently done using this tool: https://auth0-extensions.us8.webtask.io/extensions-deploy

First bump the version in package.json and in webtask.json

Then build the extension:

nvm use 8
yarn install
yarn run build

Bundle file (auth0-account-link.extension.VERSION.js is found in /dist Asset CSS files are found in /dist/assets

Follow the instructions in the deployment tool. This tool will also automatically generate a PR in the auth0-extensions repo. Only after the PR is merged will the extension be available in production. Before merging the PR you can use this tool to test the upgrade: https://github.com/auth0-extensions/auth0-extension-update-tester by overriding the extensions.json file that is fetched by the dashboard. You will need to clone this repo: https://github.com/auth0/auth0-extensions, update extensions.json locally and then run npx http-server --port 3000 --cors to serve up the file. Then configure the extension with http://localhost:3000/extensions.json as the path.