Login Methods

Login Methods controls how people sign in to Docvora. Accounts can sign in with an email address and password, or with a Discord, GitHub, Google or Microsoft account through single sign-on.

Email and password sign-in is available on all Docvora plans. Single sign-on providers are available on Enterprise plans. Changing login methods requires the Edit Settings staff permission.


Viewing login methods

Navigate to Staff Panel > Settings > Docvora Settings, then scroll to Login Methods.

Each method shows whether it's Enabled or Disabled. Select a method to change its settings.

Every enabled method appears as an option on the sign-in page.


Setting up a single sign-on provider

Each provider needs an application created with the provider first, which gives a client ID and client secret to enter in Docvora. Google, GitHub and Microsoft can also be limited to members of an organisation or tenant.

The setup guides cover each provider step by step:

After saving a provider, it can take up to a minute to appear on the sign-in page.


Turning off email and password sign-in

Sites that only use single sign-on can turn off email and password sign-in, so every account signs in through an approved provider.

  1. Set up and enable at least one single sign-on provider.

  2. Check that the Master Administrator and other staff accounts have that provider connected. Providers are connected from each account's settings under Connected Accounts.

  3. Sign out and test signing in with the provider.

  4. Navigate to Staff Panel > Settings > Docvora Settings > Login Methods > Local Accounts.

  5. Untick Enabled and select Save.

Docvora doesn't stop email and password sign-in being turned off while staff still depend on it. If the Master Administrator has no connected provider, the site can be locked out. Always test a provider before turning off Local Accounts.

If staff are locked out, contact Docvora Support.


Connecting accounts

Users can connect Discord, GitHub, Google or Microsoft to an existing account from their account settings under Connected Accounts. A connected provider can then be used to sign in to the same account.

Connections can be removed from the same place. Staff can see each account's connections in User Management.


Login methods and two-factor authentication

Accounts created through a single sign-on provider rely on that provider's security, and aren't required to set up Docvora 2FA. See Requiring Two-Factor Authentication.

On Enterprise plans, changes to login methods are recorded in the Audit Log. Client secrets are never shown or recorded.