discord

README

Discord OAuth 2.0

This is a provider for the package golang.org/x/oauth2 implementing authentication endpoints for Discord

Install

$ go get github.com/clynt707/discord-oauth2

Usage

package main

import (
  "github.com/clynt707/discord-oauth2"
  "golang.org/x/oauth2"
)

func main() {
  conf := &oauth2.Config{
    Endpoint: discord.Endpoint,
    Scopes: []string{discord.ScopeIdentify},
    RedirectURL: "http://localhost:3000/auth/callback",
    ClientID: "id",
    ClientSecret: "secret",
  }
  // Use oauth2 package as normal, i.e
  // redirect users to conf.AuthCodeURL("state") for initial auth
  // then inside the callback:
  //  - verify the state param as needed.
  //  - exchange code with conf.Exchange(oauth2.NoContext, code)
  //  - Store in session if necessary, etc.
  // to get like user's info use conf.Client(ctx, token) to get a proper http client
  // for such requests.
}

A full authentication flow example server can be found in example directory

You can join my Discord Server for support and updates.

License

MIT

Documentation

Index

• Constants
• Variables

Constants

const (
	ScopeActivitiesRead                       = "activities.read"  // Whitelist only
	ScopeActivitiesWrite                      = "activities.write" // Whitelist only
	ScopeApplicationsBuildsRead               = "applications.builds.read"
	ScopeApplicationsBuildsUpload             = "applications.builds.upload" // Whitelist only
	ScopeApplicationsCommands                 = "applications.commands"
	ScopeApplicationsCommandsPermissionUpdate = "applications.commands.permissions.update" // Whitelist only
	ScopeApplicationsCommandsUpdate           = "applications.commands.update"
	ScopeApplicationsEntitlements             = "applications.entitlements"
	ScopeApplicationsStoreUpdate              = "applications.store.update"
	ScopeBot                                  = "bot"
	ScopeConnections                          = "connections"
	ScopeDMChannelsRead                       = "dm_channels.read" // Whitelist only
	ScopeEmail                                = "email"
	ScopeGroupDMJoin                          = "gdm.join"
	ScopeGuilds                               = "guilds"
	ScopeGuildsJoin                           = "guilds.join"
	ScopeGuildsMembersRead                    = "guilds.members.read"
	ScopeIdentify                             = "identify"
	ScopeMessagesRead                         = "messages.read"
	ScopeRelationshipsRead                    = "relationships.read"     // Whitelist only
	ScopeRPC                                  = "rpc"                    // Whitelist only
	ScopeRPCActivitiesWrite                   = "rpc.activities.write"   // Whitelist only
	ScopeRPCNotificationsRead                 = "rpc.notifications.read" // Whitelist only
	ScopeRPCRead                              = "rpc.voice.read"         // Whitelist only
	ScopeRPCWrite                             = "rpc.voice.write"        // Whitelist only
	ScopeVoice                                = "voice"                  // Whitelist only
	ScopeWebhookIncoming                      = "webhook.Incoming"
)

All scope constants that can be used.

Variables

var Endpoint = oauth2.Endpoint{
	AuthURL:   "https://discord.com/api/oauth2/authorize",
	TokenURL:  "https://discord.com/api/oauth2/token",
	AuthStyle: oauth2.AuthStyleInParams,
}

Endpoint is Discord's OAuth 2.0 endpoint.