This article applies to:
Admins
Premium Procurement
Estimated time: Less than 15 mins
About this article
Enable your employees to sign in to Vendr using Single Sign-On (SSO). This article covers creating a SAML integration and connecting your SSO provider to Vendr.
How it works
When you use the Google SSO SAML integration employees will be prompted to log in to Vendr using single-sign-on through Google instead of magic links. SAML provides a quick and secure method of passing user authentications and authorizations between your identity provider and Vendr.
Important Note:
We do not support multi-domain access to the Vendr app. All users must have an email that matches the domain in your Vendr Instance. Contact support with questions.
Benefits
Increase security by centralizing user access to Vendr through your SSO provider
Provide a quick and seamless way for employees to log into Vendr – no magic links required.
Requirements
Vendr Admin
Google Admin
Note
Installing the Google SSO integration does not sync users to Vendr for assigning steps in workflows. To sync users to Vendr you'll also need to configure an Identity Provider or HRIS integration.
Overview
To allow employees to log in to Vendr using your SSO provider, you will:
Create SAML application
In the Admin console, go to Menu > Apps > Web and mobile apps
Click Add App > Add custom SAML app
On the App Details page, enter the name of the custom app
Click Continue.
On the Google Identity Provider details page, click "Download Metadata" to download the XML file. Save this, you'll need it later. (Ignore "Option 2".)
Click Continue.
In the Service Provider Details window, enter:
Entity ID: urn:amazon:cognito:sp:us-east-1_ZT4DHbbKd
Name ID Format: select "ENTITY" from the dropdown list
Name ID: select "Basic Information > Primary email"
Click Continue.
On the Attribute mapping page, under Google Directory attributes, make sure "Basic Information > Primary email" is selected.
Under App attributes, enter "email".
Click Finish.
In the Admin console, go to Menu > Apps > Web and mobile apps.
Select the SAML app you just created.
In the User Access section, turn access ON for everyone (it's OFF by default).
Enable SSO in Vendr
Navigate to Vendr and select admin and then SSO
Select GSuite SAML as the SSO Provider
Upload the downloaded metadata file from the previous step to Metadata XML field
Click Submit
🎉 Congrats! Your integration is now connected.
TIP
Vendr doesn't automatically support IdP-initiated logins. Users will be prompted to log in through Google when users log in directly from Vendr.
To enable users to login to Vendr directly from the Google dashboard add the following URL as an application bookmark:
https://app.vendr.com/#/login?via=saml&domain=YOUR_DOMAIN