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

Document Legacy Grant Types & Method deprecations #126

Merged
merged 3 commits into from
Jun 26, 2017

Conversation

cocojoe
Copy link
Member

@cocojoe cocojoe commented Jun 20, 2017

Warnings added

@cocojoe
Copy link
Member Author

cocojoe commented Jun 21, 2017

Should passwordless be removed from README for now?

@@ -223,6 +224,7 @@ public protocol Authentication: Trackable, Loggable {

- returns: an authentication request that will yield Auth0 user credentials after creating the user.
*/
@available(*, deprecated, message: "see createUser(email: String, username: String?, password: String, connection: String, userMetadata: [String: Any]?)")
Copy link
Member

Choose a reason for hiding this comment

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

This is not enough since we should tell them to chain the calls right? Why dont we add more info in the comment?

@@ -251,6 +253,7 @@ public protocol Authentication: Trackable, Loggable {
- parameter parameters: additional authentication parameters added for Web link. Ignored in other types

- returns: a request
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

Copy link
Member

Choose a reason for hiding this comment

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

Add info of what grant type needs to be enabled and a link to the docs about grant type

@@ -278,6 +281,7 @@ public protocol Authentication: Trackable, Loggable {
- parameter connection: name of the passwordless connection. By default is 'sms'

- returns: a request
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

@@ -311,7 +315,7 @@ public protocol Authentication: Trackable, Loggable {
- parameter token: token obtained by authenticating the user

- returns: a request that will yield user information
- important: If you are using an OIDC Conformant client please see `userClaimInfo`
- warning: for OIDC-conformant clients please use `userInfo(withAccessToken accessToken: String)`
Copy link
Member

Choose a reason for hiding this comment

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

Fully deprecate the method

@@ -358,6 +362,7 @@ public protocol Authentication: Trackable, Loggable {
- parameter parameters: additional parameters sent during authentication

- returns: a request that will yield Auth0 user's credentials
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

Copy link
Member

Choose a reason for hiding this comment

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

Add info of what grant type needs to be enabled and a link to the docs about grant type

@@ -682,6 +687,7 @@ public extension Authentication {
- parameter parameters: additional authentication parameters added for Web link. Ignored in other types

- returns: a request
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

Copy link
Member

Choose a reason for hiding this comment

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

Add info of what grant type needs to be enabled and a link to the docs about grant type

@@ -710,6 +716,7 @@ public extension Authentication {
- parameter connection: name of the passwordless connection. By default is 'sms'

- returns: a request
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

@@ -740,6 +747,7 @@ public extension Authentication {
- parameter parameters: additional parameters sent during authentication

- returns: a request that will yield Auth0 user's credentials
- warning: disabled for OIDC-conformant clients, an alternative will be added in a future release
Copy link
Member

Choose a reason for hiding this comment

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

Remove this warning

Copy link
Member

Choose a reason for hiding this comment

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

Add info of what grant type needs to be enabled and a link to the docs about grant type

@@ -83,6 +83,7 @@ public protocol Authentication: Trackable, Loggable {
- returns: authentication request that will yield Auth0 User Credentials
- seeAlso: Credentials
*/
@available(*, deprecated, message: "see login(usernameOrEmail username: String, password: String, realm: String, audience: String?, scope: String?)")
// swiftlint:disable:next function_parameter_count
func login(usernameOrEmail username: String, password: String, multifactorCode: String?, connection: String, scope: String, parameters: [String: Any]) -> Request<Credentials, AuthenticationError>
Copy link
Member

Choose a reason for hiding this comment

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

Add info of what grant type needs to be enabled and a link to the docs about grant type

@hzalaz hzalaz changed the title Legacy flow deprecations Document Legacy Grant Types & Method deprecations Jun 25, 2017
hzalaz
hzalaz previously approved these changes Jun 25, 2017
@hzalaz hzalaz added this to the v1-Next milestone Jun 25, 2017
[skip ci]
@hzalaz
Copy link
Member

hzalaz commented Jun 25, 2017

All good @cocojoe

@cocojoe cocojoe merged commit d49b63d into master Jun 26, 2017
@cocojoe cocojoe deleted the deprecated-old-flow branch June 26, 2017 07:56
@cocojoe cocojoe modified the milestones: 1.7.0, v1-Next Jun 26, 2017
@cocojoe cocojoe mentioned this pull request Jun 26, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants