(Tenant) Enable automatic revocation of leaked Personal Access Tokens
AZDO.1033 is in Maester 3.0.0-preview and not in the stable 2.3.0 release yet. It will be in the next stable release. To use it now, install the preview:
Install-Module Maester -AllowPrerelease -ForceHow to get the preview, and go backUse the preview in GitHub Actions
Part of Maester · Azure DevOps · Security policies · All checks
Invoke-Maester -TestId AZDO.1033Overview
Section titled “Overview”Automatic revocation of leaked Personal Access Tokens should be enabled.
Prerequisites
Section titled “Prerequisites”- Your organization must be linked to a Microsoft Entra tenant.
- You must be an Azure DevOps Administrator to configure tenant policies.
Rationale
Section titled “Rationale”Automatically revoking PATs detected as leaked minimizes the window of opportunity for unauthorized access. Disabling this policy leaves exposed tokens active even if they appear in public repositories.
Remediation action
Section titled “Remediation action”Enable the tenant policy to revoke leaked tokens.
- Sign in to your organization (
https://dev.azure.com/{yourorganization}). - Select Organization settings (gear icon).
- Select Microsoft Entra, locate the “Automatically revoke leaked personal access tokens” policy.
- Move the toggle to On.
Results:
When enabled, Azure DevOps will automatically revoke any PATs detected as leaked or exposed. If the policy is later disabled, tokens checked into public GitHub repositories remain active.
Related links
Section titled “Related links”Details
Section titled “Details”Every attribute of this check
| Field | Value |
|---|---|
| Test ID | AZDO.1033 |
| Severity | High |
| Suite | Maester |
| Product | Azure DevOps |
| Feature | Security policies |
| Area | Authentication |
| Resource type | Tenant |
| User impact | Low |
| Implementation cost | Low |
| MITRE ATT&CK | T1552.001 Credentials In Files, T1593.003 Code Repositories, T1550.001 Application Access Token |
| Supports controls | nist-800-53-r5:IA-5 |
| PowerShell test | Test-AzdoEnableLeakedPersonalAccessTokenAutoRevocation |
| Services | AzureDevOps |
| Learn more | https://learn.microsoft.com/azure/devops/organizations/accounts/manage-pats-with-policies-for-administrators?view=azure-devops#automatic-revocation-of-leaked-tokens |
Source
Section titled “Source”About this check
- Severity
- High
- Effort to fix
- Low
- Impact on users
- Low
- Product
- Azure DevOps
- Feature
- Security policies
- Area
- Authentication
- Suite
- Maester