This functionality is available to customers who have purchased the Data Distiller add on. For more information, contact your Adobe representative.
The Data Distiller Authorization API provides organizations with tighter control over data access via the SQL interface in Adobe Experience Platform. You can use this API to define IP restrictions, limit data access to specified networks, and enhance security monitoring.
This guide outlines how to set up the authorization credentials and permissions required to make calls to the Data Distiller Authorization API.
The following sections provide information on preparing the required authorization values and making your first requests to the Data Distiller Authorization API.
To enable secure data access restrictions in Query Service, you need the Manage Allowed List permission. This permission allows organizations to define specific IP ranges (in IPv4 or IPv6 format) that are authorized to access data in Platform via the SQL interface. Access is managed at the sandbox level, where users can configure a list of approved IP addresses or CIDR blocks that restrict access only to permitted networks.
System Administrators can set up user permissions from the Adobe Admin Console. For more information, see the Admin Console user guide.
The following functionalities are available with the Manage Allowed List permission:
To make calls to the Data Distiller Authorization API, you must complete the Platform API authentication tutorial, which provides values for required headers in API calls. Include the following headers in each request:
Bearer {ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
{SANDBOX_NAME}
For more information on sandboxes, see the sandbox overview documentation.
All requests that contain a payload (POST, PUT, PATCH) also require this header:
application/json
With the required permissions and header values gathered, you’re ready to start configuring IP restrictions for Query Service. Continue to the endpoint documentation for detailed examples of CRUD operations, which include:
Each API call example demonstrates how to format requests and interpret responses, helping you enforce secure access to your data in Query Service.
For specific instructions on configuring and validating IP restrictions, refer to the IP Access endpoint documentation and the IP Validation endpoint documentation.
Refer to the Data Distiller Authorization OpenAPI reference documentation to view a standardized, machine-readable format for easier integration, testing, and exploration.