Recomendação do Microsoft Entra: renovar as credenciais de aplicativo que estão expirando (versão prévia)

1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de segurança.

2. Navegue até Identidade>Visão Geral.

3. Selecione a guia Recomendações e selecione a recomendação Renovar credenciais de aplicativo prestes a exirar.

4. Anote os detalhes a seguir da tabela de recursos afetados.

   • A coluna Recurso exibe o nome do aplicativo

   • A coluna ID exibe a ID do aplicativo

     

5. Selecione Mais detalhes na coluna Ações.

6. No painel que é aberto, selecione Atualizar credencial para navegar diretamente até a área Certificados e segredos do registro do aplicativo para renovar a credencial expirada.

   1. Como alternativa, navegue até Identidade>Aplicativos>Registros de aplicativo e localize o aplicativo para o qual a credencial precisa ser girada.

   

   1. Navegue até a seção Certificados e Segredos do registro de aplicativo.

7. Escolha o tipo de credencial que sofrerá a rotação, navegue até a guia Certificados ou Segredo do Cliente e siga os prompts.

   

8. Depois que o certificado ou o segredo for adicionado com êxito, atualize o código de serviço para garantir que ele funcione com a nova credencial e não prejudique os clientes.

9. Use os logs de entrada do Microsoft Entra para validar se a ID da chave da credencial corresponde à que foi adicionada recentemente.

10. Depois de validar a nova credencial, retorne para Registros de aplicativos>Certificados e Segredos do aplicativo e remova a credencial antiga.

As solicitações a seguir podem ser usadas para recuperar a recomendação e os recursos afetados usando a API do Microsoft Graph. Para usar a API do Microsoft Graph, você precisa das permissões DirectoryRecommendations.Read.All e DirectoryRecommendations.ReadWrite.All. Para obter mais informações, consulte Como usar as recomendações de identidade.

1. Inicie a sessão no Explorador de gráficos.
2. Selecione GET como o método HTTP na lista suspensa.

Para recuperar todas as recomendações para seu locatário:

GET https://graph.microsoft.com/beta/directory/recommendations

Na resposta, localize a ID da recomendação que corresponde ao seguinte padrão: {tenantId}_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry.

Para identificar os recursos afetados:

GET https://graph.microsoft.com/beta/directory/recommendations/{tenantId}_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry

Para filtrar os recursos com base em seu status (por exemplo, recursos ativos):

GET https://graph.microsoft.com/beta/directory/recommendations/536279f6-15cc-45f2-be2d-61e352b51eef_Microsoft.Identity.IAM.Insights. ApplicationCredentialExpiry’/impactedResources?$filter=status eq Microsoft.Graph.recommendationStatus'active'

Anote o AppId, CredentialId e Origin da credencial que você deseja remover. Para remover a credencial, use as seguintes diretrizes do Microsoft Graph:

• addPassword
• addKey
• removePassword
• removeKey

Resposta de exemplo

 {
  "id": "536279f6-15cc-45f2-be2d-61e352b51eef_Microsoft.Identity.IAM.Insights.ApplicationCredentialExpiry",
  "recommendationType": "applicationCredentialExpiry",
  "createdDateTime": "2022-06-08T00:08:01Z",
  "impactStartDateTime": "2022-06-08T00:08:01Z",
  "postponeUntilDateTime": null,
  "lastModifiedDateTime": "2024-07-29T12:03:16Z",
  "lastModifiedBy": "System",
  "displayName": "Renew expiring application credentials",
  "featureAreas": [
    "applications"
  ],
  "insights": "Your tenant has applications with credentials that will expire soon.",
  "benefits": "Renewing the app credential(s) before its expiration ensures the application continues to function and reduces the possibility of downtime due to an expired credential.",
  "category": "identityBestPractice",
  "status": "active",
  "priority": "high",
  "requiredLicenses": "microsoftEntraWorkloadId",
  "impactType": "apps",
  "actionSteps": [
    {
      "stepNumber": 1,
      "text": "1. Navigate to the App registration section and locate the application for which the credential needs to be rotated."
    },
    {
      "stepNumber": 2,
      "text": "2. Navigate to the “Certificates & Secrets” blade of the app registration."
    },
    {
      "stepNumber": 3,
      "text": "3. Pick the credential type that you want to rotate and navigate to either “Certificates” or “Client Secret” tab and follow the prompts.",
      "actionUrl": null
    },
    {
      "stepNumber": 4,
      "text": "4. Once the certificate or secret is successfully added, update the service code to ensure it works with the new credential and has no negative customer impact. You should use Microsoft Entra ID’s sign-in logs to validate that the thumbprint of the certificate matches the one that was just uploaded.",
      "actionUrl": null
    },
    {
      "stepNumber": 5,
      "text": "5. After validating the new credential, navigate back to the Certificates and Secrets blade for the app and remove the old credential.",
      "actionUrl": null
    }
  ]
}