eddieowens / goauth

Local OAuth for user apps. Functionally equivilant to Google Cloud SDK's gcloud auth login command

GoAuth

Lightweight dependency for local OAuth.

What does it do?

Functionally equivalent to Google Cloud SDK's command gcloud auth login.

Opens up a user's default browser to authorize your app and returns the token. Meant to be used for storing OAuth tokens locally on a user's machine.

Installation

go get github.com/eddieowens/goauth

Basic Usage

Synchronously

package main

import (
    "fmt"
    "github.com/eddieowens/goauth"
)

func main() {
    oauth := goauth.OAuth{
        ClientSecret: "some_secret",
        ClientId:     "some_id",
        Scope:        "https://www.googleapis.com/auth/userinfo.email",
    }
    
    token := goauth.Google(oauth).Auth()
    if token.Error != nil {
        panic(token.Error)
    }
    fmt.Println("Access token is " + token.AccessToken)
}

The above will block until the user authorizes your app. When Auth() is called, a window in the user's default browser prompting them to select a Google account will open. Upon selecting an account, the OAuth 2 protocol is followed and a GoogleOAuthToken struct is returned with the credentials.

Asynchronously

package main

import (
    "fmt"
    "github.com/eddieowens/goauth"
)

func main() {
    oauth := goauth.OAuth{
        ClientSecret: "some_secret",
        ClientId:     "some_id",
        Scope:        "https://www.googleapis.com/auth/userinfo.email",
    }
	
    err := goauth.Google(oauth).
        AsyncAuth(func(token goauth.GoogleOAuthToken) {
            if token.Error != nil {
                panic(token.Error)
            }
            fmt.Println("Access token is " + token.AccessToken)
        })
    if err != nil {
        panic(err)
    }
}

Same as the synchronous example, only the entire user flow is non-blocking.

Supported OAuth providers

• Google

If you want a specific provider supported, just create an issue.