verify username (fqdn) and password (update secret) against the database, improve docstrings