auth

Paddy 2015-01-24 Parent:e45bfa2abc00 Child:3223a8e679db

129:4f5d13d2f7c7 Go to Latest

auth/doc.go

Test our getClientAuth helper, switch to table-based tests. Our getClientAuth helper was being tested implicitly when we tested our verifyClient helper, but let's test them separately. While we're at it, let's use table based tests instead of copy and paste. I noticed a lot of copy/paste errors while I was updating this, and the less test code we have and the easier we make it to test new edge cases, the better of we are.

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