UniWebViewAuthenticationFlowDiscord

Summary

A predefined authentication flow for Discord.

This implementation follows the flow described here.

See the OAuth 2.0 Support for a more detailed guide of authentication in UniWebView.

To allow the Discord flow working, at least you need these steps:

1. Setting Client Id, Client Secret and Redirect Uri in the UniWebViewAuthenticationFlowDiscord inspector.
2. Setting scope and at least contains identify in the UniWebViewAuthenticationFlowDiscord inspector.
3. Setting the Auth Callbacks Urls containing Redirect Uri in UniWebView preference panel.

Properties Summary

string clientId { get; set; }	The client ID of your Discord application.
string clientSecret { get; set; }	The client secret of your Discord application.
string redirectUri { get; set; }	The redirect URI of this Discord application.
string scope { get; set; }	The scope string of all your required scopes.
UniWebViewAuthenticationFlowDiscordOptional optional { get; set; }	Optional to control this flow's behaviour.
UniWebViewAuthenticationPKCE optional.PKCESupport { get; set; }	Whether to enable PKCE when performing authentication.
bool optional.enableState { get; set; }	Whether to enable the state verification.
string optional.additionalAuthenticationUriQuery { get; set; }	The additional query arguments that are used to construct the query string of the authentication request.

Events Summary

UnityEvent<UniWebViewAuthenticationDiscordToken> OnAuthenticationFinished	Called when the authentication flow succeeds and a valid token is generated.
UnityEvent<long, string> OnAuthenticationErrored	Called when any error (including user cancellation) happens during the authentication flow.
UnityEvent<UniWebViewAuthenticationDiscordToken> OnRefreshTokenFinished	Called when the access token refresh request finishes and a valid refreshed token is generated.
UnityEvent<long, string> OnRefreshTokenErrored	Called when any error (including user cancellation) happens during the authentication flow.

Methods Summary

void StartAuthenticationFlow()	Starts the authentication flow with the standard OAuth 2.
void StartRefreshTokenFlow(string refreshToken)	Starts the refresh flow with the standard OAuth 2.

Properties

string clientId { get; set; }

The client ID of your Discord application.

string clientSecret { get; set; }

The client secret of your Discord application.

NOTICE

Setting this value may leak the client secret and cause security issue. Prefer to setting the PKCESupport to S256 in the option instead. With the correct PKCE setup, you do not need to set the client secret here.

string redirectUri { get; set; }

The redirect URI of this Discord application.

string scope { get; set; }

The scope string of all your required scopes.

UniWebViewAuthenticationFlowDiscordOptional optional { get; set; }

Optional to control this flow's behaviour.

UniWebViewAuthenticationPKCE optional.PKCESupport { get; set; }

Whether to enable PKCE when performing authentication. On mobile platforms, this has to be enabled as S256, otherwise, Discord will reject the authentication request.

bool optional.enableState { get; set; }

Whether to enable the state verification. If enabled, the state will be generated and verified in the authentication callback. Default is true.

string optional.additionalAuthenticationUriQuery { get; set; }

The additional query arguments that are used to construct the query string of the authentication request.

This is useful when you want to add some custom parameters to the authentication request. This string will be appended to the query string that constructed from GetAuthenticationUriArguments.

For example, if you set the value to prompt=consent&ui_locales=en, it will be contained in the final authentication query.

Events

UnityEvent<UniWebViewAuthenticationDiscordToken> OnAuthenticationFinished

Called when the authentication flow succeeds and a valid token is generated.

Example

discordFlow.OnAuthenticationFinished.AddListener(OnDiscordTokenReceived)

void OnDiscordTokenReceived(UniWebViewAuthenticationDiscordToken token) {
  Debug.Log("Discord Access Token: " + token.AccessToken);
}

UnityEvent<long, string> OnAuthenticationErrored

Called when any error (including user cancellation) happens during the authentication flow.

Example

discordFlow.OnAuthenticationErrored.AddListener(OnDiscordAuthError);

void OnDiscordAuthError(long error, string message) {
  Debug.Log("Error code: " + error + " Message: " + message);
}

UnityEvent<UniWebViewAuthenticationDiscordToken> OnRefreshTokenFinished

Called when the access token refresh request finishes and a valid refreshed token is generated.

Example

discordFlow.OnRefreshTokenFinished.AddListener(OnRefreshTokenReceived)

void OnRefreshTokenReceived(UniWebViewAuthenticationDiscordToken token) {
  Debug.Log("Access Token: " + token.AccessToken);
}

UnityEvent<long, string> OnRefreshTokenErrored

Called when any error (including user cancellation) happens during the authentication flow.

Example

discordFlow.OnRefreshTokenErrored.AddListener(OnRefreshTokenError);

void OnRefreshTokenError(long error, string message) {
  Debug.Log("Error code: " + error + " Message: " + message);
}

Methods

void StartAuthenticationFlow()

Starts the authentication flow with the standard OAuth 2.0. This implements the abstract method in UniWebViewAuthenticationCommonFlow.

void StartRefreshTokenFlow(string refreshToken)

Starts the refresh flow with the standard OAuth 2.0. This implements the abstract method in UniWebViewAuthenticationCommonFlow.