Refactor: pacemaker-based: best practices for authenticate_user()

Make static, use bool instead of gboolean and int, add a doxygen block,
and improve comments and formatting.