> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# Mimecast

Mimecast is a cloud subscription service that combines solutions for email security, archiving, and continuity. See <https://www.mimecast.com/>. You can protect access to Mimecast by integrating Mimecast with Identity as a Service. Once integrated, users can use single sign-on to log in to their Mimecast account through Identity as a Service.

note

This integration was tested using Identity as a Service version 5.33 and Mimecast v1.7.0-20230611_2243. Other versions of Mimecast may require integration and configuration steps that differ from those documented in this procedure. In the event of other issues, contact <support@entrust.com> for assistance.

To integrate Mimecast with Identity as a Service, you must do the following:

Before you begin, open two browser windows, one for IDaaS and the other for Mimecast.

## Step 1: Copy the SAML Configuration from Identity as a Service

1. Log into your Identity as a Service administrator account.

2. Click Menu icon **>** **Security > Applications**. The **Applications** **Lists** page appears.

3. Under **SAML Cloud Integrations**, click **SAML Configuration**. The **SAML Configuration** dialog box appears.

   This dialog box contains information you need to configure your SAML application for Identity as a Service authentication.

4. Do one of the following:

   - Leave this dialog box open to reference later in this procedure.
   - Copy the Entity ID, Single Sign-on URL, and Single Logout URL to a text file and save it to reference later in this procedure.

note

Depending on the integration you are performing, you may not need all three of these SAML configuration values.

## Step 2: Copy the signing certificate from Identity as a Service

1. Log in to your Identity as a Service administrator account.
2. Click Menu icon **>** **Security > Applications**. The **Applications List** page appears.
3. Under **SAML Cloud Integrations**, click **SAML Signing Certificates**. The **SAML Signing Certificates** page appears.
4. Click the copy icon next to the certificate to copy it to the clipboard.
5. You can additionally download the certificate and save it for future use.
6. Open a text editor, such as Notepad, and paste the contents of the certificate into the text file.
7. Save the file.

## Step 3: Configure Mimecast for Identity as a Service authentication

1. Log in to Mimecast as an administrator.
2. Go to **My Apps**.
3. Click **Administration Console**. The **Administration Console** **Home** page appears.
4. Click **Services**. The **Services > Applications** page appears.
5. Click **Authentication Profiles** and then click **New Authentication Profile**.
6. In the **Description** field, enter a name for the application, for example, SAML_SSO.
7. From the **Allow Cloud Authentication** drop-down list, select **Allow Always**.
8. Select **Enforce SAML Authentication for End User Applications** if you want Administrators to always log in to the Administration Console using an Identity Provider and then complete the following:
   1. In the **Issuer URL**, enter the **Entity ID URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   2. Set the **Identity Mapping** to **EMAIL**.
   3. In the **Login URL**, enter the **Single Sign-ON URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   4. In the **Logout URL**, enter the **Single Logout URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   5. In the **Identity Provider Certificate (Metadata)** field, paste the certificate you copied in _Step 2: Copy the SAML signing certificate from Identity as a Service_.
   6. Select the **Allow Single Sign On** checkbox to enable Single Sign On for Administrator Users.
   7. Leave the remaining settings at the default values.
9. Select **Enforce SAML Authentication for Mimecast Web Apps** if you want users to always log in to the Mimecast Web Apps using an Identity Provider, and then complete the following:
   1. In the **Issuer URL**, enter the **Entity ID URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   2. Set the **Identity Mapping** to **EMAIL**.
   3. In the **Login URL**, enter the **Single Sign-ON URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   4. In the **Logout URL**, enter the **Single Logout URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
   5. In the **Identity Provider Certificate (Metadata)** field, paste the certificate you copied in _Step 2: Copy the SAML signing certificate from Identity as a Service_.
   6. Select the **Allow Single Sign On** checkbox to enable Single Sign-on for Administrator users.
   7. Leave the remaining settings at the default values.
10. Select **Enforce SAML Authentication for End User Applications** if you want users to always log in to the End User Applications using an Identity Provider, and then complete the following:
    1. In the **Issuer URL**, enter the **Entity ID URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
    2. Set the **Identity Mapping** to **EMAIL**.
    3. In the **Login URL**, enter the **Single Sign-ON URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
    4. In the **Logout URL**, enter the **Single Logout URL** that you copied in _Step 1: Copy the SAML configurations from Identity as a Service_.
    5. In the **Identity Provider Certificate (Metadata)** field, paste the certificate you copied in _Step 2: Copy the SAML signing certificate from Identity as a Service_.
    6. Select the **Allow Single Sign On** checkbox to enable Single Sign-on for end users.
    7. Leave the remaining settings at the default values.
11. Click on **Save and Exit**.
12. Click **Go Back** to return to the **Applications** page.
13. Click **New Application Settings**. The **Common Applications Settings** page appears.
14. Under **Description**, enter a name for the profile, for example, SAML_SSO.
15. Next to **Group**, click **Lookup** and select the desired group from the list, for example, Permitted Senders. User under this group need to be present in IDaaS.
16. Next to **Authentication Profile**, click **Lookup** and select the Authentication Profile that you created in step 6 (for example, SAML_SSO).
17. Leave the remaining settings at the default values.
18. Click on **Save and Exit**.

Click **Go Back** to return to the **Applications** page.

Click **New Application Settings**. The **Common Applications Settings** page appears.

Under **Description**, enter a name for the profile, for example, SAML_SSO.

Next to **Group**, click **Lookup** and select the desired group from the list, for example, Permitted Senders. User under this group need to be present in IDaaS.

Next to **Authentication Profile**, click **Lookup** and select the Authentication Profile that you created in step 6 (for example, SAML_SSO).

Leave the remaining settings at the default values.

Click on **Save and Exit**.

## Step 4: Add Mimecast to Identity as a Service

1. Log into your Identity as a Service administrator account.

2. Click Menu icon **>** **Security > Applications**. The **Applications** **Lists** page appears.

3. Click **Add**. The **Select an Application Template** page appears.

4. Do one of the following:

   - Select **SAML Cloud Integrations** from the search drop-down list and scroll to find the application you want to add to IDaaS.
   - In the **Search bar**, enter a search option to filter for the application you want to add to IDaaS.

5. Click **Mimecast**. The **Add Mimecast** page appears.

6. Enter an **Application Name**.

7. Enter an **Application Description**.

8. Optional. Add a custom application logo.

   1. Click Plus icon next to **Application Logo**. The **Upload Logo** dialog box appears.
   2. Click Upload icon to select an image file to upload.
   3. Browse to select your file and click **Open**. The **Upload Logo** dialog box reappears showing your selected image.
   4. If required, resize your image.
   5. Click **OK**.

9. Select the **Authentication Flow** that appears to users during login.

10. Click **Next**. The **General** page appears.

11. For the next steps, refer to <https://community.mimecast.com/s/article/email-security-cloud-gateway-global-saml-urls-and-audience-values> for the values required for the fields.

12. In the **Default** **Assertion Consumer Service URL**, enter the URL for your region. You can find this information in the provided link under **Destination > End User Applications**.

    **Example:** If your region is the United States, you would enter `https://us-api.mimecast.com/login/saml`

13. In the **Service Provider Entity ID** field, enter the URL value for your region. You can find this information in the provided link under **End User Applications**.

    **Example:** If your region is the United States, you would enter `us-api.mimecast.com.<ACCOUNTCODE>` where `<ACCOUNTCODE>` is the code assigned to your Mimecast account. You can find your account code in Mimecast by going to **Administration > Account > Account Settings**.

14. Enter the **SAML Session Timeout** to the time when the SAML Assertion times out. The maximum is 720 minutes.

15. Enter the **Max Authentication Age (seconds)** to set the maximum amount of time that can elapse before a user is required to reauthenticate during a new login attempt. This applies for both SP-initiated and IDP-initiated login. Set this field to -1 to disable this feature.

16. From the **SAML NameID Attribute** drop-down list, select **Email**.

17. From the **SAML NameID Encoding Format** drop-down list, select **Email**.

18. Select the **SAML Signing Certificate** that you copied in _Step 2: Copy the SAML signing certificate from Identity as a Service_.

19. Deselect **Enable Go Back Button** if you do not want users to be able to go back to the Mimecast login page to log in.

20. Select **Show Default Assertion Consumer URL Service in the My Profile**. When selected, the Default Assertion Consumer URL appears in a user's My Profile page in addition to relay states and Alternative Assertion Consumer URLs.

21. Add **Alternate Assertion consumer Service URL(s)** each for Administration Console and Mimecast Personal Portal.

    **Example for the Administration Console:** `https://us-api.mimecast.com/login/sso/adcon`

    **Example for Mimecast Personal Portal:** `https://us-api.mimecast.com/login/sso/mpp`

22. Add **SAML Attributes** as follows:

    1. Add the First Name attribute:
       1. Under **SAML Attributes**, click **Add**. The **SAML Attributes** dialog box appears.
       2. In the **Name** field enter Email.
       3. Click **Add** next to **Value(s)**.
       4. In the **Values** field, type `<` and select **Email**.
       5. Click **Add**.
    2. Add the Last name attribute:
       1. Under **SAML Attributes**, click **Add**. The **SAML Attributes** dialog box appears.
       2. In the **Name** field enter NameID.
       3. Click **Add** next to **Value(s)**.
       4. In the **Values** field, type `<` and select **Email**.
       5. Click **Add**.

23. Leave the remaining settings at the default values.

24. Click **Submit**.

## Step 5: Add a resource rule

See [Create resource rules](/docs/authentication-and-security/create-and-manage-resource-rules.md).

## Step 6: Test the integration

**Test Service Provider login**

1. Open a Web browser and enter the URL for your Mimecast. Click on Login. You are directed to Mimecast Login page.
2. Enter the Mimecast account **email.**
3. **Click** **Next.**
4. Respond to the second-factor authentication challenge. If you respond successfully, you are logged in to the Mimecast.

**Test Identity as a Service redirect log in**

1. Log in to your Identity as a Service account.
2. Go to your **My Profile** page if you are not already there.
3. Under **Applications**, click the Mimecast account you want to access if you have more than one.
4. Respond to the second factor authentication challenge. If you respond successfully, you are logged in to Mimecast.