OAuth2 Web Usage

Setup

• Setup
• Setup (Sharded)

Enable the extension by calling UseOAuth2Web on your DiscordClient instance:

using DisCatSharp.Extensions.OAuth2Web;

// ...

client.UseOAuth2Web(new OAuth2WebConfiguration
{
    ClientId = 1234567890, // Your application's client ID
    ClientSecret = "your_client_secret", // Your application's client secret
    RedirectUri = "http(s)://(sub).domain.tld/oauth/" // Your application's redirect URI
    // ... other options
});

After u done this you can start the oauth server at any time by calling Start on your OAuth2WebExtension instance:

client.GetOAuth2WebExtension().Start();

This method is a void method and won't return anything.

To stop the oauth server call StopAsync on your OAuth2WebExtension instance:

await client.GetOAuth2WebExtension().StopAsync();

Requesting access tokens

This is an example of how to request an access token from a user and to access user connections.

[SlashCommand("test_oauth2", "Test OAuth2 Web")]
public static async Task TestOAuth2Async(InteractionContext ctx)
{
    await ctx.CreateResponseAsync(InteractionResponseType.ChannelMessageWithSource,
        new DiscordInteractionResponseBuilder().AsEphemeral().WithContent("Please wait.."));

    // Get the oauth2 web extension
    var oauth2 = ctx.Client.GetOAuth2Web();

    // Generate the oauth2 url with the additional connections scope
    var uri = oauth2.GenerateOAuth2Url(ctx.User.Id, new List<string>() { "identify", "connections" });

    await ctx.EditResponseAsync(new DiscordWebhookBuilder().WithContent($"Please authorize via oauth at: {uri.AbsoluteUri}"));

    // Give them a minute to authorize
    // This method waits for the automatic handling of access token receiving and exchange
    var requestWaiterTask = await oauth2.WaitForAccessTokenAsync(ctx.User, uri, TimeSpan.FromMinutes(1));

    // Use the access token if the request hasn't timed out, otherwise respond with a timeout message
    if (!requestWaiterTask.TimedOut)
    {
        // Get the user connections
        var connections = await oauth2.OAuth2Client.GetCurrentUserConnectionsAsync(requestWaiterTask.Result.DiscordAccessToken);

        // Respond with the connection count and the first connection's username
        await ctx.EditResponseAsync(new DiscordWebhookBuilder().WithContent(
            $"{connections.Count} total connections\n\nFirst connection username: {connections.First().Name}"));

        // Revoke the access token, we don't need it anymore for this example
        await oauth2.RevokeAccessTokenAsync(ctx.User);

        // Inform the user that we revoked the access token
        await ctx.FollowUpAsync(new DiscordFollowupMessageBuilder().WithContent("Revoked access token").AsEphemeral());
    }
    else
        await ctx.EditResponseAsync(new DiscordWebhookBuilder().WithContent("Timed out"));
}

Visual Example