1. Create the credential in Mimecast
- Every client (partner credential)
- One client
1
Open the Tenant API Gateway
Sign in to your own Mimecast account as a Super Administrator or Full Administrator and open Multi Account Control > Tenant API Gateway.
2
Create the credential
Click Create API credential, name it Neo Agent, and create it.
3
Copy the Client ID and Client Secret
Copy both values. Copy the Client Secret before you leave the page.
What the credential needs
A partner credential acts with your partner administrator rights in each client’s account. A credential for one client acts with its application role, which needs these permissions:
When the role lacks a permission, Mimecast refuses the call and the agent reports what Mimecast refused. If your role editor has no Threat Remediation option, leave both Threat Remediation rows out. Neo still finds and judges email, releases and rejects held email, and blocks senders and URLs. It cannot check a file hash across the account or remove an email from every mailbox. Each endpoint’s page in Mimecast’s API documentation names the permission it needs.
2. Add the credential in Neo
1
Open Integrations
In the Neo Dashboard, open Integrations → Mimecast, under Email Security.
2
Save the credential
Paste the Client ID and the Client Secret and click Save settings. Neo checks them against Mimecast before saving, so a wrong value is rejected straight away.
3. Turn Mimecast on per agent
1
Open the agent's tools
Open the agent in the Neo Dashboard, go to its Tools & Settings tab and click Email Security.
2
Pick a preset
Expand the Mimecast block and pick one of its Presets, or set each permission group by hand.
The groups are Messages & Tracking, Threat Intelligence, Held Messages, Sender & URL Lists, Policies, Remediation, Users & Groups, Account & Domains, DMARC Analyzer, and Awareness & Human Risk. See Mimecast API.
3
Tell the agent what to do
Add an instruction, for example: “When a ticket reports a suspected phishing email, find it in Mimecast, judge whether it is malicious from Mimecast’s results, and write the evidence and your verdict in an internal note.”
