1. Help center
  2. Developers Documentation

How can I connect Mine PrivacyOps with OneTrust?

Integrate Mine PrivacyOps with OneTrust, to receive tickets with evidence

Before you begin, make sure you have:

  • Mine PrivacyOps account with a Pro or Enterprise plan.
  • OneTrust account with Data Subject Request module.

 

Want an expert to assist you? Get a free personal onboarding!

Setup on 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: Mine PrivacyOps
    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 Mine PrivacyOps 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 Mine PrivacyOps

Log in to your Mine PrivacyOps 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: Mine PrivacyOps
    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.