To manage Enterprise team accounts, you need an extra layer of security settings to help you control and analyze how, where, and when your team members have accessed the account. Inside your Team's Settings is a section for Security in the left sidebar.
From here, you can configure two exclusive security-facing features that are available only for Enterprise team accounts:
Audit Logs allow you to track and analyze each member's activity. These logs show the sequence of activities performed by an individual, procedure, or event enabling you to monitor and verify who accessed what, for what reason and at which time.
Any team member with an Owner role can view the Activity log and optionally, export and download a CSV file of the data. This file contains information about the events that occurred during a selected timeframe.
You can generate audit reports from the last 90 days (three months). Exporting Audit Logs will have no impact on your billing.
Audit Logs can be accessed via the Team Settings, Security section on your Vercel dashboard.
You must select a valid timeframe before exporting the CSV file. The team owner who has requested an export will then receive an email with the report.
The email contains a link to download the Audit Log file. This link is valid for 24 hours and requires the owner role to access the file.
The CSV file can be opened in any spreadsheet compatible software. The following fields make up the table:
Time and date at which the event occurred
Name for the specific event. E.g,
User ID of the team member responsible for an event
Account responsible for the action. For example, username of the team member
Email address of the team member responsible for a specific event
IP address from where the action was performed
Details about the application, operating system, vendor, and/or browser version used by the team member
Custom metadata (JSON object) which indicates the previous state of the object onto which an action was performed. For example, when changing the name of a team, it will show the old name in the metadata
Custom metadata (JSON object) which shows the updated state of the object. For example, when changing the name of a team, it will show the new name in the metadata
Consider an event where a team owner updates the role of a member from Viewer to Owner. The log entries for action, previous and next states will resemble the following:
By looking at the
next metadata, you can analyze how the role field changes from
"role":"OWNER" for your team member.
Afterwards, all Team Members will be able to log in using your identity provider (which you can also enforce), and, just like with the Team Email Domain feature, any new users signing up with SAML will automatically be added to your Team.
First, navigate to your Team Security Settings from the Dashboard tabs. Right under the Audit Logs, you can configure SAML SSO for your Team:
Clicking "Configure" will open a walkthrough that helps you configure SAML SSO for your Team with your Identity Provider.
After completing the steps of the configuration walkthrough, SAML will be successfully configured for your Team.
Once you have configured SAML, your Team Members can use SAML SSO to log in or sign up to Vercel. Click "Continue with SAML SSO" on the authentication page, then enter your Team's slug.
Your Team slug is the identifier in the URLs for your Team. e.g. vercel.com/acme is
Click "Continue with SAML SSO" again and you will be redirected to your third-party authentication provider to finish authenticating. Once completed, you will be logged into Vercel.
SAML SSO sessions last for 24 hours before users must re-authenticate with the third-party SAML Provider (unless Directory Sync is configured).
For additional security, SAML SSO can be enforced for a Team so that all Team Members cannot access any Team information unless their current session was authenticated with SAML SSO.
You can only enforce SAML SSO for a Team if your current session was authenticated with SAML SSO. This ensures that your configuration is working properly before tightening access to your Team information, as you could otherwise lose access to the Team.
Directory Sync helps Teams manage their organization membership from a third-party identity provider like Google Directory or Okta. Like SAML, Directory Sync is only available for Enterprise Teams and can only be configured by Team Owners.
When Directory Sync is configured, changes to your Directory Provider will automatically be synced with your Vercel Team Members. For example, if a new user is added to your Okta directory, that user will automatically be invited to join your Vercel Team. If a user is removed, they will automatically be removed from the Vercel Team.
You can configure a mapping between your Directory Provider's groups and a Vercel Team role. For example, your "Engineers" group on Okta can be configured with the member role on Vercel, and your "Admin" group can use the owner role.
Go to the Team's Security settings from the top header. Here, you can configure Directory Sync for your Team:
Clicking "Configure" will open a walkthrough that helps you configure Directory Sync for your Team with your Directory Provider.
After completing the steps of the configuration walkthrough, configure how Directory Groups should map to Vercel Team roles:
Finally, an overview of all synced members is shown before you complete the syncing:
Once confirmed, Directory Sync will be successfully configured for your Vercel Team.
Vercel supports the following third-party SAML providers: