auth

Paddy 2014-12-06 Parent:e45bfa2abc00 Child:3223a8e679db

84:4cb65cf90217 Go to Latest

auth/doc.go

Start supporting our pluggable grant_type. Define GrantType as a way to bundle information that can be used to validate requests based on their grant_type parameter. Move our validation of the authorization_code grant_type out of GetTokenHandler and into its own function. Define RegisterGrantType as a way to register new grant_type bundles and associate them with the string passed to grant_type. This enables other packages to define RegisterGrantType in their init() functions and plug in new grant types without forking this code. Implement RegisterGrantType for our authorization_code grant type.

History
paddy@57 1 /*
paddy@57 2 Package auth provides an authentication service for managing user accounts and an OAuth2 provider.
paddy@57 3
paddy@57 4 The service is an opinionated implementation of authentication using passphrases and the
paddy@57 5 code.secondbit.org/pass package to implement user credentials and accounts. Additionally, users
paddy@57 6 are permitted to login using their email address on record or their username interchangeably.
paddy@57 7 Care is also taken to be able to mitigate attacks that have already happened and plan ahead for
paddy@57 8 the worst case scenarios.
paddy@57 9
paddy@57 10 An OAuth2 provider is also built-in and provided, complete with client registration and management,
paddy@57 11 as well as a specification-based set of handlers for managing the issuing of grants and tokens. Token
paddy@57 12 validiity may be asserted through an API, or a proxy service is provided for stripping auth-specific
paddy@57 13 information from requests and replacing it with a trusted header containing information about the user
paddy@57 14 and client that authorized the request.
paddy@57 15 */
paddy@57 16 package auth