Enable your team to sign in to Vev securely using their Okta credentials. This guide will walk you through creating a SAML integration in Okta and the information you need to provide to Vev to complete the setup.
Prerequisites
An active Vev Organization account.
Administrator** access in your Okta instance.
Your unique Connection Name (provided by your Vev Account Executive or Support).
Step 1: Create the Application in Okta
Log in to your Okta Admin Dashboard.
Navigate to Applications** > Applications in the left-hand sidebar.
Click Create App Integration.
Select SAML 2.0 as the Sign-in method and click Next.
In the General Settings tab, enter "Vev SSO" as the App name. You can also upload the Vev logo here.
Click Next.
Step 2: Configure SAML Settings
In the Configure SAML tab, you first need to uncheck the "Use this for Recipient URL and Destination URL" toggle. Then fill in the following fields using your specific connection name provided by Vev:
Single Sign-On URL (ACS URL): https://editor.vev.design/__/auth/handler
Recipient URL: https://editor.vev.design/sso
Destination URL: https://editor.vev.design/__/auth/handler
Audience URI (SP Entity ID): saml.x
your_account_key(the full key can be found in account security panle, see instructions below)Name ID Format: Select `EmailAddress.
Application username: Select `Email.
Then press next and then finish (no more changes required)
Step 3: Retrieve Information for Vev
After finishing the setup above you will land in the sing on tab of the okta application, here you will see a meta data URL you need to copy and bring withi you into vev
Step 4: Finalize Setup in Vev
Once you have the information from Okta, you must provide it to Vev to activate the connection.
Log in to your Vev Dashboard.
Navigate to Account settings by pressing the account icon in the top of the left sidebar then account settings.
Then press the security tab in the left side bar, this option is only available for organization accounts
Click the "Set up" on the Okta SSO item
Then paste the metadata URL you got in a previous step
In the setup step you will also find the Entity ID that is needed in Step 2
Step 5: Assign Users in Okta
Finally, ensure that your team members are assigned to the Vev application within Okta, or they will receive an error when attempting to sign in.
1. In Okta, go to the Assignments tab of the Vev app.
2. Click Assign > Assign to People (or Groups).
3. Select the users who need access to Vev.
