# 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: 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.threatrix.io/integrations/build-integrations/azure-devops.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.