Connecting MineOS with OneTrust

Integrate MineOS with OneTrust, to receive tickets with evidence.

Before you begin, make sure you have:

• A MineOS account.
• A OneTrust account with the Data Subject Request module.

1. Setup OneTrust

Open your OneTrust dashboard and follow the steps below:

1. From the launch menu in the upper left corner, select Data Subject Requests.
2. Choose Setup -> Web Forms from the side menu.
   
3. Click Add New
4. Choose Global and click Next
5. Fill in the following details:
   1. Web form name: MineOS
   2. choose your managing organization and select the fulfillment workflow.
6. Click Create
7. Click Form Fields in the left and remove all fields from the form, except for: Country, I am a(an), request type, first name, last name, email, request details.
   1. From "I am a(an)" remove everything except for customer
   2. From "Request type" remove everything except "Data Deletion"
8. Click Save Template and Publish
9. The end result should look like this:
   
10. From the Integrate tab select API and copy the Template ID if your form (just the value highlighted below)
    
11. From the launch menu in the upper left corner, select integrations.
12. Choose Connections from the side menu.
    
13. Click "Add New" on the upper right corner.
14. Enter the name & description as shown here. Select "Generic" as the system and type in your email as the notification email address.
    
15. Click "Create" and the workflow builder appears.
16. Select Built-in tab and click Webhook
    
17. Take note of the HTTP POST URL on this screen. You will need it later.
18. In the Sample section, paste the example JSON from here.
19. Click "Add Action" at the bottom and choose OneTrust tab -> "Data Subject Requests"
20. From the list, choose "POST Create Request"
    
21. Under TemplateId paste the template ID of the MineOS form we created earlier.
22. Replace the Request Body with the following and click Finish.

    {
      "language": "en-us",
      "additionalData": {
        "country": "${(event.payload.evidence.countryCode)!}",
        "Email Evidence From": "${(event.payload.evidence.emailEvidence[n].FromDisplayName)!} ${(event.payload.evidence.emailEvidence[n].FromAddress)!}",
        "Email Evidence Subject": "${(event.payload.evidence.emailEvidence[n].SubjectLine)!}",
        "Mine TicketID": "${(event.payload.ticketInfo.id)!}",
        "Domain": "${(event.payload.ticketInfo.domain)!}"
      },
      "requestTypes": [
        "Data Deletion"
      ],
      "subjectTypes": [
        "Customer"
      ],
      "firstName": "${(event.payload.userInfo.name)!}",
      "lastName": "",
      "email": "${(event.payload.userInfo.email)!}"
    }

23. The end result should look like this:
    
24. On the upper right corner, click Save and then Activate.
25. To test the workflow:
    1. Click the ... icon on the upper right and choose Test Workflow
    2. Click Test and make sure you get a message saying "Status: 200 OK"
    3. Go to the Data Subject Requests module and make sure a new request has been created.

Setup on MineOS

Log in to your MineOS account.

1. From the menu on the lower-left corner select "For developers" and choose the "Webhook events" tab.
2. In the HTTP Post URL Paste the URL you took note of from the previous step.
3. In the header name type "authorization"
4. In the header value type "Bearer APIKEY" while replacing APIKEY with your OneTrust API Key. If you don't have a OneTrust API Key - see the instructions below for creating one.
5. Click enable and Save. The end result should look like this:
   
6. To test the webhook integration:
   1. Click "Test your integration"
   2. Make sure a new request has been created on OneTrust
   3. The request should look like this

Creating a OneTrust API Key

1. Click on Settings -> Access Management -> Client Credentials
2. Create a new API Key:
   1. Name: MineOS
   2. Lifetime: 1 Year
3. End results should look like this:
   
4. Click next
5. Select the following scopes:
   1. Data Subject Access Rights -> DSAR_WRITE
   2. Integrations -> INTEGRATIONS
      
6. Click Continue and copy the API Key

Troubleshooting The workflow

• In your OneTrust account, you can open the workflow's Logs page and see data about each event that was received.