Skip to content

Latest commit

 

History

History
29 lines (20 loc) · 3.01 KB

azuread-app-credential-remediation-guide.md

File metadata and controls

29 lines (20 loc) · 3.01 KB

Credential health assessment and update procedures for Azure AD applications and service principals

Disclaimer

Guidance in this document applies only in relation to the mitigation steps necessary for the issue disclosed in the CVE and detailed in Microsoft Security Response Center blog. Do not use this guidance as general credential rotation procedure.

Assessment

There are a few ways by which you can find if the credential(s) on your application or service principal need to be rotated.

Assessment method Credential assessment guide
KeyCredential assessment using MS Graph API (recommended) Application credential assessment using MS Graph API
KeyCredential assessment PowerShell module for MS Graph API Application credential assessment PowerShell module
Azure Sentinel (license required) Application credential assessment using Azure Sentinel notebook

Remediation

Application or service principal credentials can be rotated using one of the following options. You may use any one of the 3 options but ensure that you follow the steps as described for each option to avoid any downtime. The steps detailed below will help you add a new credential to the application object and remove instances of previous credentials identified by the key cred scanner tool. If the credential that needs to be rotated is expired, you can skip the steps to add a certificate and jump to the certificate removal section.

Rotation method Credential rotation guide
Azure AD Toolkit for applications and service principals (recommended) Application credential rotation using Azure AD Toolkit
MS Graph application and service principal APIs Application credential rotation using MS Graph API
Azure portal (for application object only) Application only credential rotation using Azure portal