# Drata

## Overview

Use the Drata integration to identify problems with your users and assets before they occur. Integrating with Drata enables you to build boards that correlate fields within Drata and with other connected tools. You can also run actions on fetched data without ever leaving Stitchflow.

#### Generate API key

1. To create and edit API keys, head to the Drata dashboard. Click on your account name in the bottom left corner, and then click **API Keys**
2. You can see any current API keys in this view. You can also edit properties of your existing API keys, such as scopes and expiration. Click on the API key entry to bring up the edit window
3. You won't be able to view the entire API key after it has been created. If you do not know the value of your API key, you can generate a new one by clicking on **Create API Key**

## Configure

Enable the Drata integration from `Connections` in the left sidenav. Click `Connect` and enter your API key. Before connecting, Datadog will sync for a few minutes while fetching data. Once connected, you can click the `...` menu on the Datadog integration tile to manage or disconnect the integration. 

### Manage permissions

Drata actions allow you to run operations on fetched data without ever leaving Stitchflow. All actions are enabled by default and will be accessible on every board, but can be disabled by clicking the `...` menu and selecting `Remove connection`.

{% hint style="info" %}
Please note that disconnecting Drata will also permanently delete any boards in which it is used.
{% endhint %}

## Data model

We automatically fetch and relate the following objects from Drata resources.

<details>

<summary>Supported objects</summary>

* Users
* Vendors
* Assets

</details>

We support the following actions in Drata.

<details>

<summary>Supported actions</summary>

* Add vendor
* Create asset

</details>

## Boards

When building a board, you can select any supported Drata resource as your object to indicate the data you want to surface on your board. We automatically determine the primary field for each object. The primary field is meant to be a unique representation of each record in a board.&#x20;

{% hint style="info" %}
An object in Stitchflow is a data type that is used to treat several different pieces of data as one unit.
{% endhint %}

### Adding fields

Click `Add field` to select fields from both within Drata and across your other connected tools. We only show fields that can be joined with your chosen object.&#x20;

### Triggering actions

Click `Integration actions` in the top right of any board to view all available actions across your connected integrations. When selecting an action, you'll be prompted to fill out all required inputs necessary to run the action. Changes and updates made via actions will persist to all boards.

{% hint style="info" %}
Stitchflow fetches Drata data every 24 hours.
{% endhint %}


---

# 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://docs.stitchflow.io/documentation/integrations/drata.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.