---
title: "1.9 Multi-Factor Authentication"
slug: "19-multi-factor-authentication"
updated: 2024-01-30T19:19:19Z
published: 2024-01-30T19:19:19Z
canonical: "wiki.cobblestonesoftware.com/19-multi-factor-authentication"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.cobblestonesoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 1.9 Multi-Factor Authentication

### **Multi-Factor Authentication**

**Master Reference Data Management: Contract Occurrence**

System administrators can optionally have users of the Vendor/Client Gateway register and login with multi-factor authentication (MFA).

**Multi-Factor Settings**

To have this option, the user must first have Vendor Client Gateway Multifactor Authentication set to True.

Click **Manage/Setup**

Click **Application Configuration**

Click **Initial Setup**

**![Showing in Side Menu how to navigate to Initial Setup](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/image-1666281824081.png)**

On the side menu section labeled Data Management, click **Vendor Gateway MFA Settings**

![Showing in the Side Menu how to navigate to the Vendor Gateway MFA Settings](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/image-1666281966215.png)

The top Setting (Enable Multifactor Authentication on the Gateway registration page) must be changed to **True**.

![Graphical user interface, text, application, email Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-2hp5qnab.png)

**Multi-Factor Authentication Style: E-Mail**

**Note:** If settings are not configured appropriately, a message will display, reading “The verification code could not be sent to your email address.”.

**Note:** Make sure you have *Code in email message* as a place holder for the verification code

![Graphical user interface, text, application, email Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-qvoakqdl.png)

**Multi-Factor Authentication Style: SMS Text Message**

To prepare for SMS authentication, an admin must first configure SMS integration.

1. Navigate to Manage/Setup - Application Configuration - SMS Messaging Manager

2. The **SMS Messaging Manager** page displays

![Graphical user interface, text, application, email Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-qz3ae72l.png)

**Note:** You must have purchased a license for SMS Messaging.

4. Set **toggle sending text notifications for multi-factor authentication** to Enabled

5. When done with all settings, click **save SMS Settings**.

Now that SMS has been established in the SMS configuration page, a System Administrator can set up Gateway Configuration Page for SMS use.

1. Navigate to **Manage/Setup** - **Application Configuration** - **Config Settings**

2. On the side menu, click **Vendor gateway MFA Settings**

3. Make sure the **Enable Multifactor Authentication on the Gateway registration page** is set to True

4. Change the **Multifactor Authentication Style** to SMS Code

![Graphical user interface, text, application, email Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-xvdrnitq.png)

**SMS Verification Code in Action**

The recipient receives an SMS text message to the mobile number indicated.

![A picture containing background pattern Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-m5g17ami.png)

The user can then enter the verification code for MFA on the Gateway.

![Graphical user interface Description automatically generated](https://cdn.document360.io/e3626857-1fb5-4e27-b278-2d3fc5508be4/Images/Documentation/1.9-multi-factor-authentication-image-q6mv0h5d.png)

Once the code is entered, click **Submit** to enter the **Vendor/Client Gateway**.