provide better error messaging - fixes #286

Are there other errors we should catch / any better ideas for wording the error message?
I was thinking: maybe we could add an Authentication.md containing a troubleshooting guide, and add a link to that from the error?