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 docs for generic oauth 2.0 connector #91

Merged
merged 3 commits into from
Apr 21, 2022

Conversation

xtremerui
Copy link

this is the doc for generic oauth 2.0 connector that PR in dexidp/dex#1630

date: 2021-03-15
draft: false
toc: true
weight: 2050
Copy link
Contributor

Choose a reason for hiding this comment

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

This is the same weight as oidc -- which means it will be next to it in the menus. Is this a good position for this page?

Copy link
Contributor

Choose a reason for hiding this comment

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

Screen Shot 2021-03-15 at 11 43 55 AM

Copy link
Author

Choose a reason for hiding this comment

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

thx for pointing that out! Didn't think about this value as i took it from OIDC doc directly.

How is the weight being decided (relevance/importance/users number/time being added)? Though, this connector is indeed close to OIDC connector since OIDC is just a layer on top of oauth 2.0 protocol.

Copy link
Contributor

@nate-double-u nate-double-u Mar 15, 2021

Choose a reason for hiding this comment

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

Maybe we slot it in above OIDC then, thoughts @sagikazarmark?

Suggested change
weight: 2050
weight: 2045

Copy link
Member

@nabokihms nabokihms Mar 16, 2021

Choose a reason for hiding this comment

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

Sorry for interfering. I thought connectors should be in the order they appear in the table on the index page. If you want it to be above OIDC, you need to change its order in the table as well.

Copy link
Member

Choose a reason for hiding this comment

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

Personally, I'd like to see this list sorted by importance (arbitrary) and alphabetical. Eg.:

  • OIDC
  • OAuth 2.0
  • SAML
  • LDAP
  • Provider specific connectors in alphabetical order

So I guess for now it's fine under OIDC.

Copy link
Author

Choose a reason for hiding this comment

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

Set it to 2055 so it goes under OIDC. Also positioned it under OIDC in the connectors table.

@nate-double-u
Copy link
Contributor

@xtremerui thanks for this! I've made a couple notes on the copy, and have invited @sagikazarmark to do the technical review.

@xtremerui
Copy link
Author

@nate-double-u thank you! Appreciate your help.

content/docs/connectors/oauth.md Outdated Show resolved Hide resolved
linkTitle: "Generic OAuth 2.0"
description: ""
date: 2021-03-15
draft: false
Copy link
Member

Choose a reason for hiding this comment

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

I think we should make it a draft and merge it to master. Once the feature is released, we can flip the switch.

Copy link
Member

Choose a reason for hiding this comment

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

This would also be a great opportunity to figure #92 out. @nate-double-u do you think you can help us out with that?

Copy link
Contributor

@nate-double-u nate-double-u Mar 16, 2021

Choose a reason for hiding this comment

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

I'd be happy to take a look.

[edit] #93

Copy link
Contributor

Choose a reason for hiding this comment

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

I think we should make it a draft and merge it to master. Once the feature is released, we can flip the switch.

Have to be careful with that -- this PR touches a couple files

@xtremerui
Copy link
Author

@sagikazarmark just wondering do you still need this one since the PR for generic oauth 2 connector is already merged and released?

Copy link
Member

@sagikazarmark sagikazarmark left a comment

Choose a reason for hiding this comment

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

LGTM

@sagikazarmark sagikazarmark merged commit 190a720 into dexidp:main Apr 21, 2022
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.

4 participants