Authenticate Via Code

 

Got passwords? Us too! And if tracking, remembering, and correctly typing all those passwords feels like a lot right now, we have the solution—authentication via code. Authenticating via code is a secure, alternative method to login "on demand" without the need to remember or reset those pesky passwords. #easybutton

Basics

  • Authenticating via code is an all-or-nothing proposition. It's either on for everyone or off for everyone.
  • Users cannot authenticate via code if they're using a shared email address or cell phone number.
  • If you've enabled multi-factor authentication, the User will receive a second code when it's multi-factor time.
  • If a code is expired or entered incorrectly, the User is given the option to "Try Again" and can request a new code.

User Walkthrough

If you've enabled authentication via a code, your Users will be presented with a familiar multi-factor authentication flow:

  • On the log-in screen, Users will have the option of "Send Code" rather than entering their username and password.
  • They'll then be asked whether they'd like to receive their code via text or email. Note: The text option will be hidden if SMS isn’t configured for your Domain.
  • Within fifteen seconds of clicking "Send Verification Code," the User will be sent a six-digit code via their selected method. Note: Messages are sent via the Platform and logged in the Message Log.
  • On the login screen, they'll see a text box to enter their code. This page also displays a 10-minute countdown clock for the User to enter their code. 
  • When selecting "Enter," the User can also select "Keep Me Logged In."

Configuration

Like all things log-in, authentication via code needs to be configured on your Domain record, where you'll need to add a ReCAPTCHA Site Key and reCAPTCHA Key Secret. Ready to get started?

Generate reCAPTCHA Site Key & reCAPTCHA Key Secret
  1. Navigate to https://www.google.com/recaptcha/admin/
  2. Log in using any Google credentials. Note: The authenticated Google account is automatically listed as an owner, so choose wisely.
  3. Provide the required information
    • Label: The label for your site.
    • Recaptcha Type: reCAPTCHA v3
    • Domains: At least one Domain. This must match the base domain. For example, in mp.yourchurch.com, the domain would be "yourchurch.com".
    • Owners: The authenticated Google account is automatically listed as an owner. Add other owners as desired.
  4. Accept reCAPTCHA Terms of Service.
  5. Save.

After saving, the reCAPTCHA Site Key and reCAPTCHA Key Secret will be generated so you can copy and paste them into your Domain record.

Configure Authenticate via Code in the Platform
  1. System Setup > Domains Account
  2. Edit.
  3. Auth Code Enabled = True
  4. Copy and paste the reCAPTCHA Site Key into the reCAPTCHA Site Key field.
  5. Copy and paste the reCAPTCHA Key Secret into the reCAPTCHA Key Secret field.
  6. If you want to send the code via text, confirm that the SMS fields are configured.
  7. Save.