facebook

README

Facebook Login

Login with Facebook allows users to login to any web app with their Facebook account.

Web

Package gologin provides Go handlers for the Facebook OAuth2 Authorization flow and for obtaining the Facebook User struct.

Getting Started

go get github.com/dghubble/gologin/facebook
cd $GOPATH/src/github.com/dghubble/gologin/examples/facebook
go get .

Example App

main.go shows an example web app which uses gologin to issue a client-side cookie session. For simplicity, no data is persisted.

Visit the Facebook Application Dashboard to get you app's id and secret. Add http://localhost:8080/facebook/callback as a valid OAuth2 Redirect URL under Settings, Advanced.

Compile and run main.go from examples/facebook. Pass the client id and secret as arguments to the executable

go run main.go -client-id=xx -client-secret=yy
2015/09/25 23:09:13 Starting Server listening on localhost:8080

or set the FACEBOOK_CLIENT_ID and FACEBOOK_CLIENT_SECRET environment variables.

Here's what the flow looks like.

Authorization Flow

1. The "Login with Facebook" link to the login handler directs the user to the Facebook OAuth2 Auth URL to obtain a permission grant.
2. The redirection URI (callback handler) receives the OAuth2 callback, verifies the state parameter, and obtains a Token.
3. The success http.Handler is called with a Context which contains the Facebook Token and verified Facebook User struct.
4. In this example, that User is read and used to issue a signed cookie session.