HTTP function handlers to easily add OAuth2 client support to your Go application
type AppConf struct {
For string `json:"for"`
ID string `json:"id"`
Secret string `json:"secret"`
Extra1 string `json:"extra_1"`
Extra2 string `json:"extra_2"`
Extra3 string `json:"extra_3"`
}"for"is the short-code this config refers to."id"is your Client ID."secret"is for your Client Secret.- Extra 1, 2, and 3 are filler spots for misc. info your app may need, such as Discord's Bot Token for example.
In order to use an app that uses this library, you will need to create an app on your Identity Provider of choice. Below, you will see a table of the supported Identity Providers and a link to the respective dashboards where you can go to create your app and obtain your App ID and App Secret.
| Identity Provider | Short Code | Developer Dashboard |
|---|---|---|
| Amazon | amazon |
https://developer.amazon.com/settings/console/securityprofile/overview.html |
| Battle.net | battle.net |
https://develop.battle.net/access/clients |
| Discord | discord |
https://discordapp.com/developers/applications/ |
facebook |
https://developers.facebook.com/apps/ | |
| GitHub | github |
https://github.com/settings/developers |
| GitLab | gitlab.com |
https://gitlab.com/profile/applications |
google |
https://console.developers.google.com | |
| Microsoft | microsoft |
https://apps.dev.microsoft.com/ |
reddit |
https://www.reddit.com/prefs/apps |
$ go get -u github.com/nektro/go.oauth2
type Provider struct {
ID string `json:"id"`
AuthorizeURL string `json:"authorize_url"`
TokenURL string `json:"token_url"`
MeURL string `json:"me_url"`
Scope string `json:"scope"`
NameProp string `json:"name_prop"`
NamePrefix string `json:"name_prefix"`
}"id"is the short-code this is creating."authorize_url"is the OAuth2 authorization URL."token_url"is the OAuth2 token URL."me_url"is the service's URL to get the currently logged in user."scope"is the OAuth2 scope required to be able to get the currently logged in user."name_prop"is the JSON key of current user's real name in the response of fetching"me_url"."name_prefix"is any prefix to put in front of all names, this is typically@,u/, blank, etc.
{
"for": "gitea",
"authorize_url": "https://gitea.example.com/login/oauth/authorize",
"token_url": "https://gitea.example.com/login/oauth/access_token",
"me_url": "https://gitea.example.com/api/v1/user",
"scope": "",
"name_prop": "username",
"name_prefix": "@"
}{
"for": "gitlab",
"authorize_url": "https://gitlab.com/oauth/authorize",
"token_url": "https://gitlab.com/oauth/token",
"me_url": "https://gitlab.com/api/v4/user",
"scope": "read_user",
"name_prop": "username",
"name_prefix": "@"
}MIT