Insystech DLP
  • Insystech Data Loss Prevention (DLP)
  • Quickstarts
    • Using a JSON request
    • Using with UI Path
  • APIs and Reference
    • Method: Redact
    • Method: Authentication
    • Available Detectors
    • Audio Transcription
    • Release Notes
  • Integrations
    • Insystech DLP for UI Path
  • Legal
    • Licensing Terms and Conditions
    • Privacy Policy
Powered by GitBook
On this page
  • Before you begin
  • Inspect a Microsoft Word document for sensitive information
  1. Quickstarts

Using a JSON request

This page shows you how to perform basic tasks in the Insystech Data Loss Prevention API by making calls directly to the API.

PreviousInsystech Data Loss Prevention (DLP)NextUsing with UI Path

Last updated 5 years ago

Before you begin

To use the Insystech service you will need to subscribe to the Insystech DLP service. If you have not yet subscribed please do that first and .

Check your Inbox for your subscription receipt, it will contain two important pieces of information that you'll need: APIKey and secret

Also, you'll need to have a method to convert your file to a base64string because REST API expects the request to contain the file in this format

var base64Img = require('base64-img');
objBase64 = base64Img.base64Sync("your file path").split(',')[1];
using System;
using System.IO;

byte[] bytes; 
bytes = File.ReadAllBytes(filePath); 
var outputBase64 = Convert.ToBase64String(bytes);

Inspect a Microsoft Word document for sensitive information

This section shows you how to ask the service to scan a Microsoft Word Document using the redactREST method.

  1. Create a JSON request file with the following text, and save it as redact-request.json.

    { 
      "redact":  {
        "redactType":"FILE",
        "sourceData":"{Your Base64string}",
        "sourceFileName":"sample-doc.docx",
        "detectors": [ ]
        }
    }

    This JSON request contains the object. you received when subscribing to the Insystech DLP Service.

  2. Create a JSON request file with the following text, and save it as authentication-request.json.

    { 
      "APIKey": "{Your API Key}",
      "secret": "{Your API Secret}"
    }

    This JSON request contains the APIKey and secret that you received when subscribing to the Insystech DLP Service.

  3. Use curl to make an authentication request, passing it the filename of the JSON request you set up in step 2:

    curl -s \
    -H "Content-Type: application/json" \
    https://dlp.rpa.insystechinc.com/api/authentication \
    -d @authentication-request.json

    Note that to pass a filename to curl you use the -d option (for "data") and precede the filename with an @ sign. This file should be in the same directory in which you execute the curl command.

  4. Use curl to make a redaction request, passing it the access token you received as a response in step 3 and the filename of the JSON request you set up in step 1:

    curl -o redacted-result.pdf -s \
    -H "TOKEN: {ACCESS_TOKEN}" \
    -H "Content-Type: application/json" \
    https://dlp.rpa.insystechinc.com/api/redact \
    -d @redact-request.json

    Note that receive the response as a file usingcurl you use the -o option (for "output") and precede the filename. This file should be in the same directory in which you execute the curl command.

  5. Insystech DLP responds to your request with a 400 status message and the redacted file saved to your computer.

Congratulations! Your Robot has redacted its first file with Insystech DLP!

sign up here
redact