DSS Auth: docstrings and improved code organization

[chmreid]

Contributes improvements to the new auth stuff @amarjandu has added:

• improving organization of auth modules and classes
• adding docstrings and comments to explain what the heck is going on