> For the complete documentation index, see [llms.txt](https://docs.threatrix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.threatrix.io/integrations/build-integrations/azure-devops.md).

# Azure DevOps

### Set up User Variables

**Within Threatrix Threat Center**

* Grab your OrgId and EntityId credentials from your profile

<figure><img src="/files/iN84dqSCKtrjzwss3wr5" alt=""><figcaption></figcaption></figure>

* Create and grab your API Key from your profile or admin dashboard at Admin -> Integration -> Service keys. When creating the Service Key, be sure to choose "Super Admin" for the role. Choosing permissions is unecessary.&#x20;

<div data-full-width="false"><figure><img src="/files/8Jjxc9R3X76BnilPHC4X" alt=""><figcaption></figcaption></figure></div>

**Within Azure DevOps**

* Navigate to Pipelines -> Library
* Click \`+Variable Group\` to add a new Variable Group
* Create a new Variable
* Set "Threatrix" for Variable group name
* Add the following Variable Names with values
  * THREATRIX\_API\_KEY: Your API Key from your profile or admin dashboard
  * THREATRIX\_OID: Your organization ID from your profile
  * THREATRIX\_EID: Your entity ID from your profile
* \[OPTIONAL] Select Lock icon for each to convert to Secret variable
* From top menu, click "Save".\ <br>

![](/files/dajyi7RaEkJ89R3z4e81)

### Variables Permissions

During your next build, you may see the following message requesting permissions to access your newly created Variable Group. Select "Permit" in order to allow the pipeline access to Threatrix variables necessary to perform the scan.&#x20;

![](/files/sNN01bEB8Vp7vmt7pG6O)

### Installing Threat Agent

Threatrix Threat Agent requires that Java 11+ be pre-installed on the host machine.&#x20;

**Download and run the latest ThreatAgent in your pipeline**

Add the following step to your azure-pipelines.yml file

```
- script: |
    curl -LJO https://github.com/threatrix/threat-matrix/releases/download/agent-release-latest/threat-agent-latest.jar
    java -jar threat-agent-latest.jar ./
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.threatrix.io/integrations/build-integrations/azure-devops.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.