register authenticator before session is created
fixed examples
updated docs, fixes #87
tests cleanup