# Method: Authentication

## Description

APIKey based authentication. This method authenticates the use of the Insystech DLP cloud service.&#x20;

{% hint style="info" %}
Your APIKey is emailed to you after subscribing to the Insystech DLP service.  If you have not yet subscribed please do that first and [sign up here](https://dlp.rpa.insystechinc.com/api/) for a 30 day trial.&#x20;
{% endhint %}

#### HTTP request <a href="#http-request" id="http-request"></a>

`POST https://dlp.rpa.insystechinc.com/api/authentication`

#### Request body <a href="#request-body" id="request-body"></a>

The request body contains data with the following structure:

```javascript
{ 
  "APIKey": string,
  "secret": string
}
```

| Fields   | Description                                                                                                           |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| `APIKey` | <p><code>string</code></p><p>Configuration for specifying the APIKey belonging to the subscriber</p>                  |
| `secret` | <p><code>string</code></p><p>Configuration for specifying the secret belonging to the subscriber (i.e. password) </p> |

#### Response body <a href="#response-body" id="response-body"></a>

If successful, the response contains the JSON Web Token (JWT) token. This token must be included for all API service calls and contains information that can be verified and trusted because it is digitally signed.&#x20;

```javascript
{
    "message": string,
    "token": string
}
```

API calls expect the `token`  as part of the HTTP Request Headers,  if the token is expired or invalid, access is denied to the web service. &#x20;

| Fields    | Description                                                                                                                     |
| --------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `message` | <p><code>string</code></p><p>Contains additional information and error messaging</p>                                            |
| `token`   | <p><code>string</code></p><p>JWT token containing information about the user authorized to use the Insystech DLP service.  </p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://insystech-dlp.gitbook.io/doc/apis-and-reference/method-authentication.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
