Share via

Aplicativo de extensões no Azure AD B2C

  • Artigo

Quando um diretório do Azure AD B2C é criado, um aplicativo chamado b2c-extensions-app é gerado automaticamente dentro do novo diretório. Esse aplicativo fica visível nos Registros de aplicativo. Ele é usado pelo serviço Azure AD B2C para armazenar informações sobre usuários e atributos personalizados. Se o aplicativo for excluído, o Azure AD B2C não funcionará corretamente e seu ambiente de produção será afetado.

Importante

Não exclua o b2c-extensions-app, a menos que esteja planejando excluir seu locatário imediatamente. Se o aplicativo permanecer excluído por mais de 30 dias, as informações do usuário serão permanentemente perdidas.

Como verificar se o aplicativo de extensões está presente

Para verificar se o b2c-extensions-app está presente:

  1. No locatário Azure AD B2C, clique em Todos os serviços no menu de navegação esquerdo.
  2. Procure e abra Registros de aplicativo.
  3. Procure um aplicativo que comece com b2c-extensions-app

Recuperar o aplicativo de extensões

Se você excluiu acidentalmente o b2c-extensions-app, é possível recuperá-lo em até 30 dias.

Observação

Um aplicativo só poderá ser restaurado se ele tiver sido excluído nos últimos 30 dias. Se tiverem se passado mais de 30 dias, os dados serão permanentemente perdidos. Para obter mais ajuda, abra um tíquete de suporte.

Recuperar o aplicativo de extensões usando o Microsoft Graph

Para restaurar o aplicativo usando o Microsoft Graph, você precisa restaurar o objeto de aplicativo e a entidade de serviço. Para obter mais informações, confira a API Restaurar item excluído.

Para restaurar o objeto de aplicativo:

  1. Navegue até https://developer.microsoft.com/en-us/graph/graph-explorer.
  2. Faça logon no site como um administrador global do diretório Azure AD B2C para o qual você quer restaurar o aplicativo excluído. Esse administrador global deve ter um endereço de email semelhante ao seguinte: username@{yourTenant}.onmicrosoft.com.
  3. Emita um HTTP GET em relação à URL https://graph.microsoft.com/v1.0/directory/deleteditems/microsoft.graph.application. Essa operação listará todos os aplicativos que foram excluídos nos últimos 30 dias. Você também pode usar a URL https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.application?$filter=displayName eq 'b2c-extensions-app. Do not modify. Used by AADB2C for storing user data.' para filtrar pela propriedade displayName do aplicativo.
  4. Encontre na lista o aplicativo cujo nome comece com b2c-extensions-app e copie seu valor de propriedade id.
  5. Emita um HTTP POST em relação à URL https://graph.microsoft.com/v1.0/directory/deleteditems/{id}/restore. Substitua a parte {id} da URL por id da etapa anterior.

Para restaurar o objeto de entidade de serviço:

  1. Emita um HTTP GET em relação à URL https://graph.microsoft.com/v1.0/directory/deleteditems/microsoft.graph.servicePrincipal. Essa operação listará todas as entidades de serviço que foram excluídas nos últimos 30 dias. Você também pode usar a URL https://graph.microsoft.com/v1.0/directory/deletedItems/microsoft.graph.servicePrincipal?$filter=displayName eq 'b2c-extensions-app. Do not modify. Used by AADB2C for storing user data.' para filtrar pela propriedade displayName do aplicativo.
  2. Encontre na lista a entidade de serviço cujo nome comece com b2c-extensions-app e copie seu valor de propriedade id.
  3. Emita um HTTP POST em relação à URL https://graph.microsoft.com/v1.0/directory/deleteditems/{id}/restore. Substitua a parte {id} da URL por id da etapa anterior.

Agora, deve ser possível ver o aplicativo restaurado no portal do Azure.