express-stormpath icon indicating copy to clipboard operation
express-stormpath copied to clipboard

Document social login, access token vs. authorization code

Open robertjd opened this issue 9 years ago • 8 comments

We need to update our documentation of social login, with the following changes:

  • We now support access token and authorization code callbacks from the social provider, so we should update the documentation to describe how each can by done, and a little information on why you might choose one over the other.
  • We need to describe the new scope options that are available, e.g. stormpath.web.social.google.scope

robertjd avatar Mar 09 '16 22:03 robertjd

I'll just tag along on this issue for social login documentation:

https://docs.stormpath.com/nodejs/express/latest/social_login.html#google-login states that you need to turn on the G+ API; as per testing @robertjd, @bretterer and I did about a month ago, it's no longer needed and we can remove that step from setup.

edjiang avatar Mar 10 '16 18:03 edjiang

Note: make sure to document the need to use "postmessage" as the callback url on the directory provider configuration when using the access token flow for google.

robertjd avatar Jul 12 '16 00:07 robertjd

Is there a reason you want to use postmessage, instead of the actual callback URI? It's been causing problems in Android.

edjiang avatar Jul 12 '16 16:07 edjiang

@edjiang the "postmessage" value is used when the client is a JS app in a browser, so it's a particular use case (not a global one). Does that address the concern?

robertjd avatar Aug 08 '16 18:08 robertjd

Does the Express SDK use the auth code or javascript (implicit) OAuth flows?

Basically our implementation of Stormpath right now means that the implicit grant type and Android SDK are incompatible. Period.

edjiang avatar Aug 08 '16 18:08 edjiang

The Express SDK supports both, and uses auth code in it's default login page for all providers except facebook.

robertjd avatar Aug 08 '16 18:08 robertjd

Let me forward you an email I wrote to the customer success team about this issue.

edjiang avatar Aug 08 '16 19:08 edjiang

Oh ok, I need to read the earlier thing better. I guess this is just documenting the implicit flow, but the default is still authorization code. I guess that's fine.

edjiang avatar Aug 08 '16 19:08 edjiang