Interface IAuthenticationApiClient
- Namespace
- Auth0.AuthenticationApi
- Assembly
- Auth0.AuthenticationApi.dll
Client for communicating with the Auth0 Authentication API.
public interface IAuthenticationApiClient : IDisposable
- Inherited Members
- Extension Methods
Remarks
Full documentation for the Authentication API is available at https://auth0.com/docs/auth-api
Properties
BaseUri
Base URI that will be used for all the requests.
Uri BaseUri { get; }
Property Value
Methods
ChangePasswordAsync(ChangePasswordRequest, CancellationToken)
Requests a password change email for a given email address and connection.
Task<string> ChangePasswordAsync(ChangePasswordRequest request, CancellationToken cancellationToken = default)
Parameters
request
ChangePasswordRequestChangePasswordRequest specifying the user, connection and optional client details.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<string>
Task representing the async operation containing either the JSON error response or the plain text success message response.
GetImpersonationUrlAsync(ImpersonationRequest, CancellationToken)
Obtains a one-time link that can be used to log in as a specific user.
Task<Uri> GetImpersonationUrlAsync(ImpersonationRequest request, CancellationToken cancellationToken = default)
Parameters
request
ImpersonationRequestThe ImpersonationRequest containing the details of the user to impersonate.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
Remarks
This feature has been deprecated and will be removed from Auth0 and this library in a future release.
GetTokenAsync(AuthorizationCodePkceTokenRequest, CancellationToken)
Exchanges an Authorization Code using PKCE for an Access Token.
Task<AccessTokenResponse> GetTokenAsync(AuthorizationCodePkceTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
AuthorizationCodePkceTokenRequestAuthorizationCodePkceTokenRequest containing Authorization Code and PKCE details.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(AuthorizationCodeTokenRequest, CancellationToken)
Exchanges an Authorization Code for an Access Token.
Task<AccessTokenResponse> GetTokenAsync(AuthorizationCodeTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
AuthorizationCodeTokenRequestAuthorizationCodeTokenRequest containing Authorization Code details.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(ClientCredentialsTokenRequest, CancellationToken)
Requests an Access Token using the Client Credentials Grant flow.
Task<AccessTokenResponse> GetTokenAsync(ClientCredentialsTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
ClientCredentialsTokenRequestClientCredentialsTokenRequest containing client and audience details of the request.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(DeviceCodeTokenRequest, CancellationToken)
Requests an Access Token using the Device Authorization flow
Task<AccessTokenResponse> GetTokenAsync(DeviceCodeTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
DeviceCodeTokenRequestDeviceCodeTokenRequest containing request details to exchange a device code.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
Remarks
This must be polled while the user is completing their part of the flow at an interval no more frequent than that returned by StartDeviceFlowAsync(DeviceCodeRequest, CancellationToken).
GetTokenAsync(PasswordlessEmailTokenRequest, CancellationToken)
Requests an Access Token using the Passwordless flow through email.
Task<AccessTokenResponse> GetTokenAsync(PasswordlessEmailTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
PasswordlessEmailTokenRequestPasswordlessEmailTokenRequest containing request details to exchange a one time password received through email.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(PasswordlessSmsTokenRequest, CancellationToken)
Requests an Access Token using the Passwordless flow through SMS.
Task<AccessTokenResponse> GetTokenAsync(PasswordlessSmsTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
PasswordlessSmsTokenRequestPasswordlessSmsTokenRequest containing request details to exchange a one time password received through SMS.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(RefreshTokenRequest, CancellationToken)
Refreshes all tokens by way of the the Refresh Token obtained during authorization.
Task<AccessTokenResponse> GetTokenAsync(RefreshTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
RefreshTokenRequestRefreshTokenRequest containing Refresh Token and associated parameters.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
GetTokenAsync(ResourceOwnerTokenRequest, CancellationToken)
Performs authentication by providing user-supplied information in a ResourceOwnerTokenRequest.
Task<AccessTokenResponse> GetTokenAsync(ResourceOwnerTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
ResourceOwnerTokenRequestResourceOwnerTokenRequest containing information regarding the username, password etc.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<AccessTokenResponse>
Task representing the async operation containing a AccessTokenResponse with the requested tokens.
Remarks
The grant_type parameter required by the /oauth/token endpoint will automatically be inferred from the request
parameter. If no Realm was specified,
then the grant_type will be set to "password". If a Realm was specified, then the grant_type will be set to "http://auth0.com/oauth/grant-type/password-realm"
GetUserInfoAsync(string, CancellationToken)
Returns user information based on the access token that was obtained during login.
Task<UserInfo> GetUserInfoAsync(string accessToken, CancellationToken cancellationToken = default)
Parameters
accessToken
stringAccess token used to obtain the user information.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
Remarks
Information included in the response depends on the scopes initially granted.
PushedAuthorizationRequestAsync(PushedAuthorizationRequest, CancellationToken)
Starts a new Pushed Authorization Request flow.
Task<PushedAuthorizationRequestResponse> PushedAuthorizationRequestAsync(PushedAuthorizationRequest request, CancellationToken cancellationToken = default)
Parameters
request
PushedAuthorizationRequestPushedAuthorizationRequest containing information to start the Pushed Authorization Request.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<PushedAuthorizationRequestResponse>
Task representing the async operation containing a PushedAuthorizationRequestResponse with the details of the response.
RevokeRefreshTokenAsync(RevokeRefreshTokenRequest, CancellationToken)
Revokes refresh token provided in request.
Task RevokeRefreshTokenAsync(RevokeRefreshTokenRequest request, CancellationToken cancellationToken = default)
Parameters
request
RevokeRefreshTokenRequestRevokeRefreshTokenRequest containing Refresh Token and associated parameters.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
SignupUserAsync(SignupUserRequest, CancellationToken)
Creates a new user given the user details specified.
Task<SignupUserResponse> SignupUserAsync(SignupUserRequest request, CancellationToken cancellationToken = default)
Parameters
request
SignupUserRequestSignupUserRequest containing information of the user to sign up.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<SignupUserResponse>
Task representing the async operation containing a SignupUserResponse with the information of the signed up user.
StartDeviceFlowAsync(DeviceCodeRequest, CancellationToken)
Starts a new Device Authorization flow
Task<DeviceCodeResponse> StartDeviceFlowAsync(DeviceCodeRequest request, CancellationToken cancellationToken = default)
Parameters
request
DeviceCodeRequestDeviceCodeRequest containing client, scope and audience
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<DeviceCodeResponse>
Task representing the async operation containing a DeviceCodeResponse with the details of the request.
StartPasswordlessEmailFlowAsync(PasswordlessEmailRequest, CancellationToken)
Starts a new Passwordless email flow.
Task<PasswordlessEmailResponse> StartPasswordlessEmailFlowAsync(PasswordlessEmailRequest request, CancellationToken cancellationToken = default)
Parameters
request
PasswordlessEmailRequestPasswordlessEmailRequest containing details about the Passwordless email flow to start.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<PasswordlessEmailResponse>
Task representing the async operation containing a PasswordlessEmailResponse with the information of the signed up user.
StartPasswordlessSmsFlowAsync(PasswordlessSmsRequest, CancellationToken)
Starts a new Passwordless SMS flow.
Task<PasswordlessSmsResponse> StartPasswordlessSmsFlowAsync(PasswordlessSmsRequest request, CancellationToken cancellationToken = default)
Parameters
request
PasswordlessSmsRequestPasswordlessSmsRequest containing details about the Passwordless SMS flow to start.
cancellationToken
CancellationTokenThe cancellation token to cancel operation.
Returns
- Task<PasswordlessSmsResponse>
Task representing the async operation containing a PasswordlessSmsResponse with the details of the request.