Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add section on OAuth 2.0 and bearer tokens. #231

Merged
merged 3 commits into from
Sep 26, 2021
Merged

Conversation

msporny
Copy link
Contributor

@msporny msporny commented Sep 12, 2021

This PR specifies that OAuth 2.0 and OAuth 2.0 bearer tokens can be used as an authorization protocol and access token format.


Preview | Diff

index.html Outdated Show resolved Hide resolved
@TallTed
Copy link
Collaborator

TallTed commented Sep 14, 2021

I wonder if it's worth leaving the door open to later versions of OAuth which may exist before these docs are updated?

Copy link
Contributor

@jricher jricher left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Existing language does not make sense for requirements, suggested changes.

  1. It makes no sense to explicitly disallow OAuth 1.0 if someone's crazy enough to use it.
  2. The name of the protocol is not "Open Authorization".
  3. There should be no restrictions placed by this API on grant types. (Nor should examples be used)
  4. Getting tokens and using tokens are two different requirement spaces, and this language mashes them together in ways that make dangerous assumptions.

index.html Outdated Show resolved Hide resolved
index.html Outdated
@@ -315,7 +315,7 @@ <h4>Open Authorization (OAuth)</h4>
<p>
If Open Authorization is utilized for authorization, version 2.0 of the
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If Open Authorization is utilized for authorization, version 2.0 of the
If Open Authorization (OAuth) is used for authorization, version 2.0 of the

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Using @jricher's suggestion over yours @TallTed.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK. I don't have a RESOLVE button, or I'd click it...

Base automatically changed from msporny-authz-intro to main September 25, 2021 23:25
msporny and others added 3 commits September 25, 2021 18:03
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Justin Richer <github@justin.richer.org>
@msporny
Copy link
Contributor Author

msporny commented Sep 26, 2021

I have concerns that the current language around OAuth 2.0 will result in zero tests being written in the test suite regarding OAuth 2.0 authorization. I have raised #234 to track that concern.

Change requests processed, merging.

@msporny msporny merged commit 0f39732 into main Sep 26, 2021
@msporny msporny deleted the msporny-authz-oauth2 branch September 26, 2021 00:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

6 participants