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

# Azure DevOps Organizations

The Azure DevOps Organizations page lists every Azure DevOps organization connected to StepSecurity and provides per-organization setup instructions and dashboard access.

{% hint style="info" %}
StepSecurity's Azure DevOps integration currently supports Azure-hosted runners. For the full scope of supported capabilities, see the [Azure DevOps documentation](https://docs.stepsecurity.io/azure-devops/).
{% endhint %}

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

### What you can do here

* **View connected organizations.** The table lists every Azure DevOps organization registered with StepSecurity, identified by organization name.
* **Add a new organization.** Click **Add Organization** in the top right to begin connecting a new Azure DevOps organization.
* **Review setup instructions.** Click **Setup Instructions** on any row to see the configuration steps for connecting StepSecurity to that organization's Azure Pipelines.
* **Open an organization's dashboard.** Click **Dashboard** on any row to open that organization's StepSecurity dashboard, where you can review insights and detections from its pipeline runs.

### Adding an Azure DevOps Organization

* Navigate to Resources under Admin Console

![](https://colony-recorder.s3.amazonaws.com/files/2026-05-08/51e76bac-fe49-4a72-ad63-159870b821d6/ascreenshot_3af4e475473d4eccb09bbf2e9329666b_text_export.jpeg)

* Under Azure DevOps Organizations, click **Add Organization** in the top right.

![](https://colony-recorder.s3.amazonaws.com/files/2026-05-08/e30ec7af-29b5-48b1-83fe-4c111736f38f/user_cropped_screenshot_0d4b9b0744b14bc2b612ab09d5d44efb_text_export.jpeg)

* Provide the required Azure DevOps organization details and complete the connection flow.

![](https://colony-recorder.s3.amazonaws.com/files/2026-05-08/3325fc87-0b4d-4157-9a26-ea929d8dc131/user_cropped_screenshot_a7e5095f5a6b4614afea6947e7971a25_text_export.jpeg)

* After the organization is added, click **Setup Instructions** on its row and follow the steps to configure StepSecurity for Azure-hosted runners in that organization.

![](https://colony-recorder.s3.amazonaws.com/files/2026-05-08/843ea0e5-ee98-4ae8-8798-94bbbf088d33/user_cropped_screenshot_d2d14371374e48d29fb6421c6f9901ce_text_export.jpeg)

* The first step in the setup process involves logging into your Azure tenant and installing the StepSecurity app

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

* After completing the setup, the organization will be fully connected and visible in the dashboard.

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


---

# 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.stepsecurity.io/administration/admin-console/resources/azure-devops-organizations.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.