Azure DevOps

Azure DevOps is a Microsoft product that provides version control, reporting, requirements management, project management, automated builds, testing and release management capabilities.

Types of Assets Fetched

This adapter fetches the following types of assets:

• Users
• Application Resources

Related Enforcement Actions:
Microsoft Azure DevOps - Create Task

Parameters

1. Domain or IP (optional) - The hostname or IP address of the Azure DevOps server. The default is https://vssps.dev.azure.com/.
2. Port (optional) - If not supplied, Axonius will use TCP port 443.
3. API Version (optional) - Select the API version. The default is 6.1-preview.1.
4. Organization (required) - The organization name defined in the customer’s DevOps account.
5. Token Name (required) - The name of the token you want to use.
6. Personal Access Token (required) - The personal access token to access the Azure Devops. Refer to Use personal access tokens.
7. 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.
8. HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the value supplied in Organization.
9. HTTPS Proxy User Name (optional) - The user name to use when connecting to the value supplied in Organization via the value supplied in HTTPS Proxy.
10. HTTPS Proxy Password (optional, default: empty) - The password to use when connecting to the value supplied in Organization via the value supplied in HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

1. Fetch Groups of Each User - Select this option to fetch memberships of users in groups.
2. Fetch Git Repositories - Select this option to fetch the Git Repositories from the projects in Azure DevOps.
3. Fetch Git Commits from the last X days (optional) - Use the arrows on the right to set the day count.
4. Fetch Users' Projects - Select this option to fetch all projects of all users. The results can be viewed under Assets > Users > Projects field (add it to the table if it is not there). You can also go to a user's profile and view the Projects field of that specific user.

APIs

Axonius uses the Azure DevOps Services REST API 6.1.

Required Permissions

The value supplied in Personal Access Token must be associated with credentials that have read permissions (for Code) and for the Graph scope in order to fetch assets.

Version Matrix

This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.