Docs need more work

[golharam]

Not to be critical, but I've been trying to get this module to work with my app and my orgs SSO. The docs in here are very minimal and a bit confusing. It would be nice to see an example laid out more thoroughly.

[golharam]

I'm not convinced this extension name is completely accurate. The single-sign on method I'm using requires me to redirect the user to an external site which they authentication against, and that site sends them back with http headers indicating they are authenticated. This package doesn't seem to accomplish that. The docs needs to be improved to indicate exactly what the expected use case of this package is.