Microsoft Azure DevOps - Update Task updates a task status for:
- Assets returned by the selected query or assets selected on the relevant asset page.
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
- Not all asset types are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
Required Fields
These fields must be configured to run the Enforcement Set.
- Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
-
Use stored credentials from the Azure DevOps adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.
- When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.
Note:To use this option, you must successfully configure a Azure DevOps adapter connection. -
Project - Enter the project name.
-
Work item ID - Enter the ID of the work item to update.
-
Work item new status - Enter the updated status of the work item.
-
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Connecting Additional Axonius Nodes.
Additional Fields
These fields are optional.
Connection and Credentials
When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.
General parameters:
- Domain or IP - The hostname or IP address of the Azure DevOps server. The default is https://vssps.dev.azure.com/.
- Port - If not supplied, Axonius will use TCP port 443.
- API Version - Select the API version. The default is 6.1-preview.1.
- Organization - The name of the Azure DevOps organization. For more derails, see Azure DevOps - About organization management in Azure DevOps.
Fields required when authenticating with a personal access token:
- Token Name and Personal Access Token - The generated personal access token (PAT) used to authenticate into Azure DevOps that has the required permissions to read, write and manage work items.
Fields required when authenticating with a service principal:
- Azure Client ID, Azure Client Secret, Azure Tenant ID, Cloud Environment - See details on the Microsoft Entra ID documentation.
Additional parameters:
- Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
- HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
- HTTPS Proxy User Name (optional) - The user name to use when connecting to the Azure DevOps server via the value supplied in HTTPS Proxy.
- HTTPS Proxy Password (optional) - The password to use when connecting to the server using the HTTPS Proxy.
APIs
Axonius uses the Azure DevOps - Work Items - Update API.
Required Permissions
- The values supplied in Token Name and Personal Access Token refer to a generated personal access token (PAT) used to authenticate into Azure DevOps that has permission to read, write and manage work items. For details, see Azure DevOps - Create a personal access token (PAT).
- The values supplied in Azure Client ID, Azure Client Secret, Azure Tenant ID and Cloud Environment must have permission to read, write and manage work items. For details, see Add a service principal to an Azure DevOps organization.
For more details about other Enforcement Actions available, see Action Library.