Valimail for Twilio SendGrid supports Single Sign-On (SSO) integration with Identity Providers (IDPs) that support the XML-based Security Assertion Markup Language (SAML) 2.0 protocol.
For IDPs that support SAML 2.0, but where the Valimail for Twilio SendGrid app does not appear in the app catalog or where there is no app catalog, SAML 2.0 SSO can be implemented using the following instructions.
Configuring Valimail for Twilio SendGrid with an IDP is a two-step process.
Step 1 involves working within the IDP interface to configure Valimail for Twilio SendGrid as an app.
Step 2 involves working within the Valimail for Twilio SendGrid interface.
Step 1: IDP Configuration
1. Go to your SAML 2.0 compliant SSO provider's login portal, login as an administrator, and create a generic SAML app.
2. Name the app Valimail for Twilio SendGrid and apply one or both of the logos below:
3. The configuration of a generic SAML app will typically require, at a minimum, the following data to be provided:
|SAML Assertion Consumer Service (ACS) URL||https://sendgrid.valimail.com/sso/consume|
|Audience URI (SP Entity ID)||https://app.valimail.com|
|Default RelayState||leave blank|
|Name ID Format||This should be in the form of an email address.|
Name ID: Some IDPs may need to know the format in which to send the Name ID to Valimail. The IDP should send the Name ID in the format of an email address.
Additional Attributes: Valimail for Twilio SendGrid expects some additional user information to be passed by the IDP:
|Attribute Name||Name Format||Value|
|FirstName||Unspecified||The user's first name as it appears in the IDP.|
|LastName||Unspecified||The user's last name as it appears in the IDP.|
⚠️ Note: The attribute names above are case-sensitive and should appear in the IDP configuration exactly as they do here.
Step 2: Valimail for Twilio SendGrid Configuration
1. Obtain the IDP Metadata file from your SSO provider. Some providers make this available through their user interface or online help, while others may require you to contact their Support Team. You will need this before continuing with setup.
⚠️SSO testing will fail unless you have also added to your Valimail for Twilio SendGrid account any users who should have access. Ensure users have already been added in Valimail for Twilio SendGrid under Account Settings.
2. In a new browser tab/window, go to https://sendgrid.valimail.com and login to Valimail for Twilio SendGrid as an account Owner with your username and password.
3. In the left side menu click on Account Settings.
4. Click on the Single Sign-on Setup button:
7. Go back to your SSO provider account and assign the Valimail for Twilio SendGrid app to the appropriate users.
Service Provider (SP) initiated Single Sign-On (SSO)
Identity Provider (IDP) initiated Single Sign-On (SSO)
⚠️Encountered a problem or need help? Just email firstname.lastname@example.org.