REST API Getting Started Guide

Products

• Data Loss Prevention
• Data Loss Prevention API Detection for Developer Apps Virtual Appliance
• Data Loss Prevention API Detection Virtual Appliance
• Data Loss Prevention Cloud Detection Service
• Data Loss Prevention Cloud Detection Service for ICAP
• Data Loss Prevention Cloud Detection Service for REST
• Data Loss Prevention Cloud Package
• Data Loss Prevention Cloud Prevent for Microsoft Office 365
• Data Loss Prevention Cloud Service for Discovery/Connector
• Data Loss Prevention Cloud Service for Email
• Data Loss Prevention Cloud Storage
• Data Loss Prevention Core Package
• Data Loss Prevention Data Access Governance
• Data Loss Prevention Discover Suite
• Data Loss Prevention Endpoint Discover
• Data Loss Prevention Endpoint Prevent
• Data Loss Prevention Endpoint Suite
• Data Loss Prevention Enforce
• Data Loss Prevention Enterprise Suite
• Data Loss Prevention for Mobile
• Data Loss Prevention for Office 365 Email and Gmail with Email Safeguard
• Data Loss Prevention Form Recognition
• Data Loss Prevention Network Discover
• Data Loss Prevention Network Email
• Data Loss Prevention Network Monitor
• Data Loss Prevention Network Monitor and Prevent for Email
• Data Loss Prevention Network Monitor and Prevent for Email and Web
• Data Loss Prevention Network Monitor and Prevent for Web
• Data Loss Prevention Network Prevent for Email
• Data Loss Prevention Network Prevent for Email Virtual Appliance
• Data Loss Prevention Network Prevent for Web Virtual Appliance
• Data Loss Prevention Network Protect
• Data Loss Prevention Network Web
• Data Loss Prevention Oracle Standard Edition 2
• Data Loss Prevention Plus Suite
• Data Loss Prevention Sensitive Image Recognition

Issue/Introduction

You wish to start using the REST API to access DLP.

For the full "Getting Started..." please visit the following link: Getting Started with DLP

Cause

SOAP API has been deprecated and is no longer available as of DLP 16.0. Instead you should now be using the REST API for DLP 16.0 and later.

Resolution

Note: Username and Passwords provided below are for example only, choose your own values to match your company requirements.

Resources:
- APIDOCS Examples
- Overview of the Symantec Data Loss Prevention Detection REST API 2.0
- Detection Requests for the DLP Detection REST API 2.0

 

Support Limitations and the API:
- Support cannot write or help you to write your applications. That is beyond the scope of support.
- However, if you need help confirming if something you are working on is actually working correctly, support can help you confirm if specific functionality in the API is working as intended.
- If you do actually need help in writing your applications, you can contact your Account Team to discuss a Professional Services engagement to assist with creating specific API functionality.

 

Example .bat file:
- To help get you started I have attached a very basic example batch file (Windows) to demonstrate how to get started with the API. "API_Get_CustomAttributes.bat"
- This is an example to "Get Custom Attributes" using the API in a simple batch file for Windows.
- You can run this script on any Windows machine that can reach your Enforce Server, for simplicities sake, I recommend running it directly on the Enforce Server to start with.
- You will then be prompted for several pieces of information, if you are not using a Domain, simply leave that value empty.
     
- Once you answer these questions, it will automatically convert your credentials into Base64 so it can be passed into the API.
- NOTE: As this is a test script, it will print out your credentials in plain text on the screen, and then show you the Base64 conversion. This is done so you can manually verify the conversion is correct.
     
- It will then print out the results of your request.