Agent Overview
image
image
The Internal Systems API specification defines how to build consistent, scalable, and secure REST APIs for any organization's internal system, like databases, data warehouses, unstructured data stores, or homegrown applications, in order to provide an interface with the DataGrail Platform to process privacy requests.
Overview
This section covers how to create new Agents and API key in DataGrail.
Authentication credentials must be securely stored in a supported credentials management provider and programmatically accessible to the Request Manager Agent.
After configuring the environment variable, you're ready to configure the container that will run within your network.
Direct Contact Integrations allow DataGrail to automatically facilitate Privacy Requests with systems that do not have a dedicated API. This integration type utilizes an email workflow with a secure form that allows a configured system owner (processor) to action requests for both access and deletion.
Environment variables defined within the container enable dynamic configuration of all Request Manager Agent properties and operations.
The Request Manager Agent uses environment variables to configure its runtime behavior and connections. You'll need to set variables for your DataGrail domain, Agent API Key, credentials manager provider, and optionally cloud storage for handling sensitive data. This page documents all required and optional environment variables, including cloud provider credentials for local development.
After creating the Agent and API key in DataGrail, you're ready to configure the environment variable used by the agent container.
For many modern businesses, internal data systems are large repositories of sensitive personally identifiable information (PII). To process growing volumes of Data Subject Requests (DSR), companies must interact with every data system containing PII the organization uses, regardless of the storage medium.
image
Webhook integrations allow DataGrail to dispatch privacy request processing to your systems. When a privacy request reaches the appropriate lifecycle stage, DataGrail sends an HTTP request to your webhook endpoint with the details needed to perform the work (e.g., retrieve or delete data). Once your system completes the work, it confirms completion via the provided callback URL.