https://github.com/stormpath/stormpath-express-social-unification-example
An example Express.js website secured with Stormpath that unifies social login accounts.
https://github.com/stormpath/stormpath-express-social-unification-example
Last synced: 4 months ago
JSON representation
An example Express.js website secured with Stormpath that unifies social login accounts.
- Host: GitHub
- URL: https://github.com/stormpath/stormpath-express-social-unification-example
- Owner: stormpath
- Created: 2016-01-09T01:00:37.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-03-07T00:06:36.000Z (about 9 years ago)
- Last Synced: 2025-04-30T05:04:16.171Z (about 1 year ago)
- Language: JavaScript
- Size: 5.86 KB
- Stars: 4
- Watchers: 5
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
#Stormpath is Joining Okta
We are incredibly excited to announce that [Stormpath is joining forces with Okta](https://stormpath.com/blog/stormpaths-new-path?utm_source=github&utm_medium=readme&utm-campaign=okta-announcement). Please visit [the Migration FAQs](https://stormpath.com/oktaplusstormpath?utm_source=github&utm_medium=readme&utm-campaign=okta-announcement) for a detailed look at what this means for Stormpath users.
We're available to answer all questions at [support@stormpath.com](mailto:support@stormpath.com).
# What's this About?
So, you're using [Stormpath](https://stormpath.com/) to secure your Express.js
website, and are allowing users to log into your web application via Social
Login (*Facebook, Google, etc.*).
Things are going great, with one big drawback: when a user logs in via a social
provider, you want to ensure their account is UNIQUE! You don't want a separate
user account for both Randall the Facebook user and Randall the Google user,
right?
Well, you're in luck!
This example application demonstrates how you can 'unify' your social login
accounts in Stormpath via the usage of a simple Express.js middleware function.
This code is re-usable, and will safely unify your social accounts for you.
## How Does it Work?
The way this works is simple:
- If a logged-in user is detected to be a social user, then we'll look in
Stormpath for a non-social user account (*a cloud account*).
- If the above check fails, we'll create a new cloud account for the user, and
swap the current user session!
- If the above check passes, we'll swap the current user session for the cloud
user.
Those three steps ensure that no matter HOW your user logs in, the same account
is always used. This makes building large-scale applications significantly
simpler.
## Testing it Out
To test this out, you'll need to install this project locally:
```console
$ git clone https://github.com/stormpath/stormpath-express-social-unification-example.git
$ cd stormpath-express-social-unification-example
$ npm install
```
You'll then need to specify a few environment variables:
```console
$ export STORMPATH_CLIENT_APIKEY_ID=xxx
$ export STORMPATH_CLIENT_APIKEY_SECRET=xxx
$ export STORMPATH_APPLICATION_HREF=xxx
```
Those settings MUST be defined in order for this sample application to work.
Furthermore, your Stormpath Application MUST have at least one social directory
AND cloud directory mapped to it. Without these, this code is pointless!
Assuming the above prerequisites are met, you can run this application by
typing:
```console
$ node server.js
```
Into the console, then visiting http://localhost:3000 and logging in with a
social account.
You'll notice that your account is swapped AUTOMATICALLY for you, with no
intervention necessary.
## Questions?
Contact [support@stormpath.com](mailto:support@stormpath.com)