Microsoft Entra ID

Recover application secrets using Microsoft Entra Backup and Recovery (Preview)

In brief

ai-usage: ai-assisted

What Entra admins need to know

Review the documentation change to determine whether it affects tenant configuration, security posture, or rollout plans.

This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.

Documentation change

Open on Microsoft Learn ↗

The comparison below is an extract of the Microsoft Learn article showing only the changed content. Open the full article for complete context.

Recover application secrets using Microsoft Entra Backup and Recovery (Preview)

This article describes how to restore application secrets after accidental or malicious changes, using Microsoft Entra Backup and Recovery.

Backups are created automatically once per day and retained for up to five days. Restore points for applications and service principals are limited to backups within this retention window.

Prerequisites

To recover application objects and service principals, the tenant must have Microsoft Entra ID P1 or P2 licenses, and you need the Microsoft Entra Backup Administrator role.

Prepare for recovery

As part of your disaster recovery plan for applications, review your current processes for managing application secrets and secret rotation. Using best practices for managing application secrets eases recovery from accidental or malicious edits. This article assumes you're using Azure Key Vault or another secure solution for managing your application secrets. For more information, see Best practices for protecting secrets.

After you determine the cause of the changes, validate whether the secrets for applications were impacted. Find changes to application secrets in the audit log. Look for events that indicate the application secret was changed or updated.

Use a difference report to compare the selected backup with the current tenant state for the affected application and service principals before recovery. Difference reports help you identify changed attributes and links before you choose what to restore.

The nature of the change and whether secrets were impacted determine the best path for recovery for your applications. Anytime an application, service principal, or user is recovered from soft-delete, the secret is recovered to the state it was in when the delete action occurred.

This includes scenarios where the application was edited or soft-deleted, but the secrets on the application weren't edited.

Using Backup and Recovery, recover only the affected application and service principals to a point in time before the changes occurred. At this point the application should be able to function using the existing secret. If you deleted the application, the recovery restores secrets to their state at the time of deletion.

If your team uses Azure Key Vault, validate your secrets are functioning correctly using these steps:

Recover accidental changes when secrets were altered or deleted

Using Backup and Recovery, recover only the affected applications and service principals to a point in time before the changes occurred.

If your team uses Azure Key Vault, you need to roll the secret for your application. Follow the steps in Recover applications due to a malicious change to roll the secret.

Application and service principal properties not supported by Backup and Recovery

Using Backup and Recovery, recoverRecovery supports the applicationsapplication properties and service principalsservice principal properties listed in Supported objects and recoverable properties. Any application setting that isn't listed as supported might need to a point in time before the malicious activity occurred. This capability supports recovery of a limited set of properties: displayName, description, notes, applicationTag, appIdentifierUri, publicClient, publisherDomain, isDeviceOnlyAuthSupported,be saved and serviceManagementReference. Additional properties will be supported in the upcoming preview.manually reapplied.

Review key application settings such as redirect URIs, supported account types, assigned permissions or roles, and exposed API properties to ensure your application functions as expected after recovery: