GOAuth

GOAuth [Go package]

GOauth is a OAuth Consumer package for the Go Programming language.

#> goinstall github.com/hokapoka/goauth

The package is available on github and can be install with goinstall, as shown above.  Once installed you are able to make requests to OAuth services.

The version is 1.0 protocol as per the RFC 5849 document :  [http://tools.ietf.org/html/rfc5849].

type OAuthConsumer struct

The OAuthConsumer has a number of exported fields these are:

Service

Is just a string for to indicate the service that is being used, currently has no technical usage.

RequestTokenURL

The URL of the service to get a new Request Token from.

AccessTokenURL

The URL of the service to get the AccessToken for the Confirmed RequestToken

AuthorizationURL

The URL of the service that the account must used to Authorize the Request For Access

ConsumerKey

The Consumer Key for the OAuth Client from the Service

ConsumerSecret

The Consumer Secret for the OAuth Client from the Service

CallBackURL

The URL that the OAuth service should use

These are the Exported Methods:

func (oc *OAuthConsumer) GetRequestAuthorizationURL() (string, os.Error)

GetRequestAuthorizationURL Returns the URL for the visitor to Authorize the Access, or an error.

func (oc *OAuthConsumer) GetAccessToken(token string, verifier string, ) *AccessToken

GetAccessToken gets the access token for the response from the Authorization URL. Where token & verifier are the strings returned from the service to the CallBackURL.

func (oc *OAuthConsumer) Get( url string, at *AccessToken) (r *http.Response, err os.Error)

Get returns the response via a GET for the url with the AccessToken passed, or an error.

func (oc *OAuthConsumer) Post( url string, fparams Params, at *AccessToken) (r *http.Response, err os.Error)

Post returns the response via a POST for the url with the AccessToken passed & the Form params passsed in fparams, or an error

type AccessToken struct

The AccessToken, returned from GetAccessToken, Is to be used for all subsequent requests for the authorized user.

There, currently, is no built-in persistence for these tokens. This means you will have to store the AccessToken in some way such as using mongoDB or a file, and associate it with a given user on your system. There is an unused exported field UserRef string that can be used for this purpose, if necessary.

Example

There are a handful of example within the source of the package but there’s a more details walk through of Creating an basic Out Of Band OAuth Twitter client.