Mimecast

How to connect Mimecast to Cork

Creating A Service Account & Granting User Permissions


Note: If you already have a service account created with user permissions, you can skip this section and proceed to Obtaining API Key.



Service Account Creation

  1. Log into the Mimecast Administration Console with a user who has the Admin role

  2. Navigate to Administration > Directories > Internal Directories
  3. Click on the domain the service account will be added to.

  4. Click New Address.
  5. Choose an email address for the service account you wish to create

  6. Enter a Password and Confirm Password. Note: You will need to remember this password for use later in this article. It is recommended to store these credentials in your secure password manager.
  7. Click Save.

Granting User Permissions

Note: This article assigns the Basic Administrator role to your service account.  Depending on your company’s security practices, you may also want to look into creating a custom role for the service account. 

  1. Navigate to Administration > Account > Roles
  2. Select Basic Administrator
  3. Click Add User to Role
  4. Click the checkbox of the previously created Service Account user and then click Add Selected Users



Obtaining API Key


  1. Log into the Mimecast Administration Console with a user who has the Admin role
  2. Navigate to Administration > Services > API and Platform Integrations
  3. On the API and Platform Integrations page, select Your Application Integrations, and then click Add API Application




  4. Fill out the Application Details with an Application Name and Description of your choosing, and matching the remaining items to below and then clicking Next
    • Application Name: Cork Protection
    • Category: Other
    • Service Application: Enable Extended Session Checked
    • Description: Integration into Cork Protection platform



  5. On Step 2 of the Add API Application, fill out the Technical Point of Contact (Name) and Email of the member of your team who you wish to be the technical point of contact for any API related notifications and then click next.



  6. On Step 3 of the Add API Application, verify all the information is correct, select whether you want Notifications Enabled or Disabled, and then click Add.



  7. As mentioned in the notification on the Mimecast screen, you must wait 30 minutes before you are able to create keys for the application. Set yourself a timer, go grab a coffee (or your drink of choice), and come back once the timer is up.

  8. Once the 30 minutes is up, you are ready to proceed. If your browser window was closed, you can get back to where you left off by navigating to Administration > Services > API and Platform Integrations > Your Application Integrations and then clicking the previously created application (Cork Protection)

  9. In the right hand side bar that opens up, click Create Keys



  10. On Step 1 of the Create Keys for Cork Protection, enter the email address of a service account. 

  11. On Step 2 of the Create Keys for Cork Protection, select the Type, enter the Password associated with the service account you chose to use. Make sure the option to Revoke keys is unchecked and then click Next


  12. After authenticating, Create Keys for Cork Protection will move to step 4 and present your keys.



  13. Copy the value under Access Key

  14. Leave this browser page open and continue to the “Connecting Integration” section of this article



Connecting Integration

Note: If setting up Mimecast for both Business Email Compromise and Security Awareness Training, you can use the same set of keys, but will need to configure both separately inside Cork Protection.

  1. Log into Cork Protection in a new browser tab or window
  2. Navigate to the Integrations page
  3. Scroll down to the Business Email Compromise or Security Awareness Training Platform section 
  4. Locate Mimecast and click “Configure
  5. Paste the previously copied Access Key into the Access Key field.
  6. Navigate back to the Mimecast portal which was previously left open.
  7. Copy the value under Secret Key
  8. Navigate back to Cork Protection and paste the Secret Key into the Secret Key field.
  9. Navigate back to the Mimecast portal. You can now click Close on the Create Keys for Cork Protection page.
  10. Navigate to Administration > Services > API and Platform Integrations > Your Application Integrations and then clicking the previously created application (Cork Protection)
  11. Copy the value under Application ID
  12. Navigate back to Cork Protection and paste the Application ID into the Application ID field.
  13. Navigate back to the Mimecast portal.
  14. Copy the value under Application Key
  15. Navigate back to Cork Protection and paste the Application Key into the Application Key field.
  16. (Optional) If desired, enter a display name for the integration
  17. Click the “Connect” button