Guia de solução de problemas do Gerenciador de Armazenamento do Azure

O Gerenciador de Armazenamento do Microsoft Azure é um aplicativo autônomo que facilita o trabalho com dados do Armazenamento do Azure no Windows, macOS e Linux. O aplicativo pode conectar contas de armazenamento hospedadas no Azure, em nuvens nacionais e no Azure Stack.

Este guia resume as soluções para problemas que normalmente são encontrados no Gerenciador de Armazenamento.

Problemas de permissões do Azure

O RBAC (controle de acesso baseado em função) do Azure permite o gerenciamento de acesso altamente granular de recursos do Azure combinando conjuntos de permissões em funções. Aqui estão algumas estratégias para fazer com que o Azure RBAC funcione de maneira ideal no Gerenciador de Armazenamento.

Como fazer para acessar meus recursos no Gerenciador de Armazenamento?

Se você estiver tendo problemas para acessar recursos de armazenamento por meio do RBAC do Azure, talvez não tenha as funções apropriadas atribuídas a você. As seções a seguir descrevem as permissões do Gerenciador de Armazenamento que atualmente exigem acesso aos recursos de armazenamento. Entre em contato com o administrador da conta do Azure se você não tiver certeza de que tem as funções ou permissões apropriadas.

Problema de permissões "Ler: Listar/Obter Contas de Armazenamento"

Você deve ter permissão para listar contas de armazenamento. Para obter essa permissão, você deve ser atribuído à função Leitor.

Listar chaves da conta de armazenamento

O Gerenciador de Armazenamento também pode usar chaves de conta para autenticar solicitações. Você pode obter acesso a chaves de conta por meio de funções mais poderosas, como a função Colaborador.

Funções de dados

Você deve ser atribuído a pelo menos uma função que conceda acesso para ler dados de recursos. Por exemplo, se você quiser listar ou baixar blobs, precisará, pelo menos, da função Leitor de Dados do Blob de Armazenamento.

Por que preciso de uma função de camada de gerenciamento para ver meus recursos no Gerenciador de Armazenamento?

O Armazenamento do Microsoft Azure tem duas camadas de acesso: gerenciamento e dados. As assinaturas e as contas de armazenamento são acessadas por meio da camada de gerenciamento. Contêineres, blobs e outros recursos de dados são acessados por meio da camada de dados. Por exemplo, se você quiser obter uma lista das suas contas de armazenamento do Azure, envie uma solicitação para o ponto de extremidade de gerenciamento. Se você quiser ver uma lista de contêineres de blob em uma conta, envie uma solicitação para o ponto de extremidade de serviço apropriado.

As funções do Azure podem conceder permissões para acesso à camada de dados ou de gerenciamento. A função Leitor, por exemplo, concede acesso somente leitura aos recursos da camada de gerenciamento.

Na realidade, a função Leitor não fornece nenhuma permissão de camada de dados e não é necessária para acessar a camada de dados.

O Gerenciador de Armazenamento facilita o acesso aos recursos coletando as informações necessárias para se conectar aos recursos do Azure. Por exemplo, para exibir os contêineres de blob, o Gerenciador de Armazenamento envia uma solicitação "listar contêineres" para o ponto de extremidade do serviço de blobs. Para obter esse ponto de extremidade, o Gerenciador de Armazenamento pesquisa a lista de assinaturas e contas de armazenamento às quais você tem acesso. Para localizar suas assinaturas e contas de armazenamento, o Gerenciador de Armazenamento também precisa acessar a camada de gerenciamento.

Se você não tiver uma função que conceda permissões à camada de gerenciamento, o Gerenciador de Armazenamento do Microsoft Azure não poderá obter as informações necessárias para se conectar à camada de dados.

E se eu não conseguir obter as permissões da camada de gerenciamento que preciso do meu administrador?

Se você quiser acessar contêineres de blobs, contêineres ou diretórios do Azure Data Lake Storage Gen2, ou filas, você poderá anexar a esses recursos usando suas credenciais do Azure.

1. Abra a caixa de diálogo Conectar .
2. Selecione o tipo de recurso ao qual você quer conectar-se.
3. Selecione Entrar usando a ID>do Microsoft Entra Avançar.
4. Selecione a conta de usuário e o locatário associados ao recurso ao qual você está anexando e selecione Avançar.
5. Digite a URL do recurso e digite um nome de exibição exclusivo para a conexão. Selecione Próxima>conexão.

Atualmente, não há uma solução relacionada ao RBAC do Azure para outros tipos de recursos. Como solução alternativa, você pode solicitar uma URL de assinatura de acesso compartilhado e anexá-la ao seu recurso:

1. Abra a caixa de diálogo Conectar .
2. Selecione o tipo de recurso ao qual você quer conectar-se.
3. Selecione SAS (assinatura de acesso compartilhado)>Avançar.
4. Digite a URL de assinatura de acesso compartilhado recebida e insira um nome de exibição exclusivo para a conexão. Selecione Próxima>conexão.

Para saber mais sobre como anexar a recursos, confira Anexar a um recurso individual.

Funções internas do Azure recomendadas

Várias funções internas do Azure podem fornecer as permissões necessárias para usar o Gerenciador de Armazenamento. Algumas dessas funções são:

• Proprietário: Gerencia tudo, incluindo o acesso a recursos.
• Colaborador:: Gerencia tudo, excluindo o acesso a recursos.
• Leitor: Lê e lista recursos.
• Colaborador da Conta de Armazenamento: Gerenciamento completo das contas de armazenamento.
• Proprietário de Dados do Blob de Armazenamento: Acesso completo a contêineres de blobs e de dados do Armazenamento do Microsoft Azure.
• Colaborador de Dados de Blob de Armazenamento: Lê, grava e exclui contêineres e blobs do Armazenamento do Microsoft Azure.
• Leitor de Dados do Blob de Armazenamento: Lê e lista contêineres e blobs do Armazenamento do Microsoft Azure.

Problemas de certificado TLS/SSL

Esta seção discute problemas de certificado TLS/SSL.

Entender os problemas de certificado TLS/SSL

Certifique-se de entender a seção de certificados TLS/SSL na documentação de rede do Gerenciador de Armazenamento antes de continuar.

Usar proxy do sistema

Se você só estiver usando recursos que dão suporte à configuração Usar proxy do sistema, tente usar essa configuração. Para ler mais sobre a configuração de proxy do sistema, confira Conexões de rede no Gerenciador de Armazenamento.

Importar certificados TLS/SSL

Se você tiver uma cópia dos certificados autoassinados, instrua o Gerenciador de Armazenamento a confiar neles:

1. Obter uma cópia X.509 codificada Base 64 (.cer) do certificado.
2. Acesse Editar>Certificados SSL>Importar Certificados. Use o seletor de arquivos para localizar, selecionar e abrir o arquivo .cer.

Esse problema também ocorrer se houver vários certificados (raiz e intermediário). Para corrigir esse erro, importe todos os certificados.

Localizar certificados TLS/SSL

Se você não tiver uma cópia dos certificados autoassinados, solicite ajuda do administrador de TI.

Para encontrar certificados, você pode seguir estas etapas:

1. Instale o OpenSSL:

   • Windows: qualquer uma das versões light deve ser suficiente.
   • Mac: o OpenSSLdeve estar incluído com o sistema operacional.
   • Linux: o OpenSSL deve estar incluído com o sistema operacional.

2. Execute o OpenSSL:

   • Windows: Abra o diretório de instalação, selecione /bin/ e clique duas vezes em openssl.exe.
   • Mac: execute openssl por um terminal.
   • Linux: execute openssl por um terminal.

3. Execute o comando openssl s_client -showcerts -connect <hostname>:443 para obter um dos nomes do host da Microsoft ou do Azure nos quais seus recursos de armazenamento estão protegidos. Para obter mais informações, consulte esta lista de nomes de host acessados com frequência pelo Gerenciador de Armazenamento.

4. Procurar certificados autoassinados. Se a entidade ("s:") e o emissor ("i:") forem os mesmos, o certificado provavelmente será autoassinado.

5. Quando você encontrar os certificados autoassinados, para cada um, copie e cole tudo de para -----BEGIN CERTIFICATE----- em um novo arquivo .cer-----END CERTIFICATE-----.

6. Abra o Gerenciador de Armazenamento e vá para Editar>Certificados SSL>Importar Certificados. Em seguida, use o seletor de arquivos para localizar, selecionar e abrir os arquivos .cer que você criou.

Desativar validação de certificado TLS/SSL

Se você não encontrar certificados autoassinados seguindo essas etapas, entre em contato conosco por meio da ferramenta de comentários. Abra também o Gerenciador de Armazenamento na linha de comando usando o sinalizador --ignore-certificate-errors. Quando aberto com esse sinalizador, o Gerenciador de Armazenamento ignora os erros de certificado.

Problemas de credenciais

Esta seção discute os problemas de entrada que você pode encontrar.

Noções básicas de entrada

Certifique-se de entender a documentação Entrar no Gerenciador de Armazenamento antes de continuar.

Necessidade de reinserir credenciais com frequência

Ter que reinserir credenciais é provavelmente o resultado de políticas de Acesso Condicional definidas pelo administrador do Microsoft Entra. Quando o Gerenciador de Armazenamento solicitar que você insira novamente as credenciais do painel da conta, você verá um link Detalhes do erro. Selecione-o para ver por que o Gerenciador de Armazenamento está solicitando a nova inserção das credenciais. Os erros de política de acesso condicional que exigem a reinserção de credenciais podem ser parecidos com estes:

O token de atualização expirou.

Você deve usar a autenticação multifator para acessar.

O administrador fez uma alteração de configuração.

Para reduzir a frequência de ter que reinserir credenciais devido a erros como os anteriores, fale com o administrador do Microsoft Entra.

Outros problemas de política de acesso condicional

Se você tiver outras políticas de acesso condicional que precisam ser atendidas para sua conta, tente usar o valor do Agente de Autenticação ou do Navegador da Web Padrão para a configuração Entrar com. Para obter informações sobre essa configuração, confira Alterar o local da entrada.

Problemas com o agente de autenticação no Windows

O sistema operacional Windows usa o WAM (Gerenciador de Contas da Web) como seu agente de autenticação. Se você estiver usando o método de entrada do Agente de Autenticação no Windows e tiver problemas, consulte este guia para obter as etapas para resolver erros comuns.

O navegador reclama sobre redirecionamento HTTP ou conexão insegura durante a entrada

Quando o Gerenciador de Armazenamento executa a entrada no navegador da Web, um redirecionamento para localhost é feito no final do processo de entrada. Os navegadores às vezes geram um aviso ou um erro de que o redirecionamento está sendo executado com HTTP em vez de HTTPS. Alguns navegadores também podem tentar forçar a execução do redirecionamento como HTTPS. Se qualquer um desses problemas acontecer, dependendo do seu navegador, você tem opções:

• Ignore o aviso.
• Adicione uma exceção para localhost.
• Desative o HTTPS forçado, globalmente ou apenas para localhost.

Se você não puder executar nenhuma dessas opções, também poderá alterar onde a entrada acontece para a entrada integrada a fim de evitar o uso total do navegador.

Não foi possível adquirir o token, o locatário foi filtrado

Às vezes, você pode ver uma mensagem de erro informando que um token não pode ser adquirido porque um locatário foi filtrado. Isso significa que você está tentando acessar um recurso que está em um locatário filtrado. Para incluir o locatário, acesse o Painel de Conta. Verifique se a caixa de seleção do locatário especificado no erro está marcada. Para saber mais sobre como filtrar os locatários no Gerenciador de Armazenamento, confira Gerenciar contas.

A biblioteca de autenticação não foi iniciada corretamente

Se, na inicialização, você vir uma mensagem de erro informando que a biblioteca de autenticação do Gerenciador de Armazenamento falhou ao iniciar corretamente, verifique se o ambiente de instalação atende a todos os pré-requisitos. Não atender aos pré-requisitos é a causa mais provável dessa mensagem de erro.

Se você acredita que seu ambiente de instalação atende a todos os pré-requisitos, abra um problema no GitHub. Ao abrir seu problema, certifique-se de incluir:

• Seu sistema operacional
• Sua versão do Gerenciador de Armazenamento
• Seus logs de autenticação de uma inicialização malsucedida do Gerenciador de Armazenamento. O log de autenticação detalhado é habilitado automaticamente depois que esse tipo de erro ocorre.

Janela em branco ao usar credenciais integradas

Se você optar por usar a Entrada Integrada e vir uma janela de entrada em branco, provavelmente precisará alternar para um método de entrada diferente. Caixas de diálogo de entrada em branco geralmente ocorrem quando um servidor do Serviços de Federação do Active Directory solicita que Gerenciador de Armazenamento execute um redirecionamento sem suporte do Electron.

Para alterar para um método de entrada diferente, altere a configuração Entrar com em Configurações>Aplicativo>Entrar. Para obter informações sobre os diferentes tipos de métodos de login, consulte Alterar o local da entrada.

Alteração de loop de reautenticação ou nome UPN

Se você estiver em um loop de reautenticação ou tiver alterado o UPN de uma de suas contas, siga estas etapas:

1. Abra o Gerenciador de Armazenamento.
2. Acesse Ajuda>Redefinir.
3. Verifique se pelo menos Autenticação está marcado. Desmarque outros itens que você não deseja redefinir.
4. Selecione Restaurar.
5. Reinicie o Gerenciador de Armazenamento e tente entrar novamente.

Se você continuar enfrentando problemas depois de fazer uma redefinição, tente executar estas etapas:

1. Abra o Gerenciador de Armazenamento.
2. Remova todas as contas e, em seguida, feche o Gerenciador de Armazenamento.
3. Exclua a pasta .IdentityService do seu computador. No Windows, a pasta está localizada em C:\Users\<username>\AppData\Local. Para Mac e Linux, você pode encontrar a pasta na raiz do seu diretório de usuário.
4. Se você estiver usando Mac ou Linux, também precisará excluir a entrada Microsoft.Developer.IdentityService do repositório de chaves do seu sistema operacional. No Mac, o repositório de chaves é o aplicativo Gnome Keychain. No Linux, o aplicativo geralmente é chamado de Keyring, mas o nome pode ser diferente dependendo da sua distribuição.
5. Reinicie o Gerenciador de Armazenamento e tente entrar novamente.

macOS: erros do Keychain ou nenhuma janela de entrada

Às vezes, o Keychain do macOS pode entrar em um estado que causa problemas para a biblioteca de autenticação do Gerenciador de Armazenamento. Para tirar as Chaves desse estado, siga estas etapas:

1. Feche o Gerenciador de Armazenamento.

2. Abra as Chaves selecionando Espaço de Comando + , digite "chaves" na caixa de pesquisa e selecione Enter.

3. Selecione o keychain logon.

4. Selecione o ícone de cadeado para bloquear o keychain. Após a conclusão do processo, o cadeado aparece bloqueado. Isso pode levar alguns segundos, dependendo de quais aplicativos estiverem abertos.

   

5. Abra o Gerenciador de Armazenamento.

6. Você receberá uma mensagem como "O hub de serviço deseja acessar as Chaves". Digite a senha da sua conta de administrador do Mac e selecione Sempre permitir. Ou selecione Permitir se Sempre Permitir não estiver disponível.

7. Tente entrar.

Linux: nenhuma janela de aplicativo ou erros do gerenciador de senhas na inicialização

Se você iniciar o Gerenciador de Armazenamento em um sistema Linux, poderá encontrar um dos seguintes problemas:

• Nenhuma janela do aplicativo é exibida.
• Ocorrem erros sobre o gerenciador de senhas do sistema.

O Gerenciador de Armazenamento usa o gerenciador de credenciais do sistema para proteger seus dados, incluindo credenciais de entrada e conexões SAS. Se nenhum aplicativo gerenciador de credenciais compatível for detectado, o Gerenciador de Armazenamento não poderá ser iniciado. Se o seu sistema não tiver uma ferramenta de gerenciamento de credenciais local instalada, você poderá instalar uma ferramenta compatível com libsecreto . Por exemplo, em sistemas Linux que usam o ambiente de desktop GNOME, você pode instalar o Seahorse.

O Gerenciador de Armazenamento geralmente cria um chaveiro padrão se ele não existir na inicialização. No entanto, em alguns casos, um chaveiro padrão pode não ser criado, resultando em erros de janela de aplicativo ou serviço de gerenciador de senhas. Para resolver os problemas, defina manualmente um chaveiro padrão.

Se você estiver usando o Seahorse e não houver chaveiros existentes ou quiser criar um novo, siga estas etapas para criar um chaveiro padrão:

1. Inicie o aplicativo "Senhas e chaves".
2. Selecione o botão "+" e, em seguida, selecione Chaveiro de senha.
3. Defina um nome e uma senha para o novo chaveiro.
4. Clique com o botão direito do mouse no novo chaveiro e selecione Definir como padrão.

Se você usar o snap do Gerenciador de Armazenamento, também deverá certificar-se de que o Gerenciador de Armazenamento esteja conectado ao gerenciador de senhas do seu sistema. Para conectar o gerenciador de senhas, execute o seguinte comando:

snap connect storage-explorer:password-manager-service :password-manager-service

O navegador padrão não abre

Se o navegador padrão não abrir quando você tentar entrar, experimente todas as técnicas a seguir:

• Reinicie o Gerenciador de Armazenamento.
• Abra o navegador manualmente antes de começar a entrar.
• Tente usar Entrada Integrada. Para obter instruções, confira Alterar onde ocorre a entrada.

Outros problemas de entrada

Se nenhuma das condições acima se aplicar ao seu problema de credenciais, ou se elas não resolverem o problema, abra um problema no GitHub.

Assinaturas ausentes e locatários desfeitos

Se não for possível recuperar as assinaturas após a entrada bem-sucedida, tente os seguintes métodos de solução de problemas:

• Verifique se sua conta tem acesso às assinaturas que você espera. Você pode verificar seu acesso entrando no portal para o ambiente do Azure que você está tentando usar.
• Certifique-se de entrar no ambiente correto do Azure (Azure, Azure China 21Vianet, Azure US Government ou Ambiente Personalizado).
• Verifique se você configurou o proxy do Gerenciador de Armazenamento corretamente se estiver atrás de um servidor proxy.
• Remova e adicione novamente a conta.
• Verifique quais mensagens de erro estão sendo relatadas para os locatários que estão falhando se houver um link "Mais informações" ou "Detalhes do erro". Se você não tiver certeza de como responder às mensagens de erro, abra um problema no GitHub.

Problema ao interagir com o repositório de credenciais do sistema operacional durante uma transferência do AzCopy

Se você vir essa mensagem no Windows, o Gerenciador de Credenciais do Windows provavelmente está cheio. Para liberar espaço no Gerenciador de Credenciais do Windows, siga estas etapas:

1. Feche o Gerenciador de Armazenamento.
2. No menu Iniciar, pesquise por Gerenciador de Credenciais e abra-o.
3. Vá para Credenciais do Windows.
4. Em Credenciais genéricas, procure entradas associadas a programas que você não usa mais e exclua-as. Você também pode procurar entradas como azcopy/aadtoken/<some number> e excluí-las.

Se a mensagem continuar a aparecer depois que você concluir as etapas acima ou ser essa mensagem aparecer em plataformas diferentes do Windows, é possível abrir um problema no GitHub.

Não é possível remover uma conta de armazenamento anexada ou recurso anexado

Se não for possível remover uma conta anexada ou um recurso de armazenamento por meio da interface do usuário, exclua manualmente todos os recursos anexados, excluindo as seguintes pastas:

Feche o Gerenciador de Armazenamento antes de excluir essas pastas.

Problemas de proxy

Gerenciador de Armazenamento dá suporte para conexão aos recursos do Armazenamento do Microsoft Azure por meio de um servidor proxy. Se você tiver problemas ao se conectar com o Azure por meio de proxy, confira estas sugestões.

O Gerenciador de Armazenamento dá suporte apenas à autenticação básica com servidores proxy. Não há suporte para outros métodos de autenticação, como o NTLM (New Technology LAN Manager).

Verificar as configurações de proxy do Gerenciador de Armazenamento

A definição da configuração Aplicativo>Proxy>Configuração de proxy determina de qual fonte o Gerenciador de Armazenamento obtém a configuração de proxy.

Se você selecionar Usar variáveis de ambiente, defina as variáveis de ambiente HTTPS_PROXY ou HTTP_PROXY. As variáveis de ambiente diferenciam maiúsculas de minúsculas, portanto, defina as variáveis corretas. Se essas variáveis forem indefinidas ou inválidas, o Gerenciador de Armazenamento não usará um proxy. Reinicie o Gerenciador de Armazenamento depois de modificar quaisquer variáveis de ambiente.

Se você selecionar Usar configurações de proxy do aplicativo, verifique se as configurações de proxy no aplicativo estão corretas.

Etapas para diagnosticar problemas

Se você ainda tiver problemas, tente os seguintes métodos para solucionar problemas:

1. Se você puder se conectar à Internet sem usar o proxy, verifique se o Gerenciador de Armazenamento funciona sem as configurações de proxy habilitadas. Se o Gerenciador de Armazenamento se conectar com êxito, talvez haja um problema com seu servidor proxy. Trabalhe com o administrador para identificar os problemas.
2. Verifique se outros aplicativos que usam o servidor proxy funcionam conforme o esperado.
3. Verifique se você pode conectar ao portal para o ambiente do Azure que você está tentando usar.
4. Verifique se que você pode receber respostas de seus pontos de extremidade de serviço. Insira uma das suas URLs de ponto de extremidade em seu navegador. Se você puder se conectar, deverá receber uma InvalidQueryParameterValue resposta XML ou semelhante.
5. Verifique se outra pessoa que usa o Gerenciador de Armazenamento com o mesmo servidor proxy pode se conectar. Se a conexão dela for possível, talvez seja necessário entrar em contato com o administrador do servidor proxy.

Ferramentas para diagnosticar problemas

Uma ferramenta de rede, como o Fiddler, pode ajudar a diagnosticar problemas.

1. Configure sua ferramenta de rede como um servidor proxy em execução no host local. Se você tiver que continuar a trabalhar por trás de um proxy real, será necessário configurar a ferramenta de rede para se conectar por meio do proxy.
2. Verifique o número da porta usado por sua ferramenta de rede.
3. Defina as configurações de proxy do Gerenciador de Armazenamento para usar o host local e o número da porta da ferramenta de rede, como localhost:8888.

Quando definida corretamente, sua ferramenta de rede registra as solicitações de rede feitas pelo Gerenciador de Armazenamento para pontos de extremidade de gerenciamento e serviço.

Se a ferramenta de rede não parece estar registrando o tráfego do Gerenciador de Armazenamento, experimente testar sua ferramenta com um aplicativo diferente. Por exemplo, insira a URL do endpoint para um de seus recursos de armazenamento, como https://contoso.blob.core.windows.net/ em um navegador da Web. Você deve receber uma resposta semelhante a este exemplo de código:

<?xml version="1.0" encoding="UTF-8"?>
<Error>
    <Code>InvalidQueryParameterValue</Code>
    <Message>Value for one of the query parameters specified in the request URI is invalid.
        RequestId:<RequestId> Time:2017-04-10T21:42:17.3863214Z</Message>
    <QueryParameterName>comp</QueryParameterName>
    <QueryParameterValue/>
    <Reason/>
</Error>

A resposta sugere que o recurso existe, embora você não possa acessá-lo.

Se a ferramenta de rede mostrar apenas o tráfego de outros aplicativos, talvez seja necessário ajustar as configurações de proxy no Gerenciador de Armazenamento. Caso contrário, será necessário que você ajuste as configurações da sua ferramenta.

Entre em contato com o administrador do servidor proxy

Se as configurações de proxy estiverem corretas, talvez seja necessário entrar em contato com seu administrador de servidor proxy para:

• Certificar-se de que seu proxy não bloqueia o tráfego nos pontos de extremidade de gerenciamento ou de recurso do Azure.
• Verifique o protocolo de autenticação usado por seu servidor proxy. O Gerenciador de Armazenamento dá suporte apenas à protocolos de autenticação básicos. O Gerenciador de Armazenamento não dá suporte a proxies NTLM.

Mensagem de erro "Não é Possível Recuperar Filhos"

Se você estiver conectado ao Azure por meio de um proxy, verifique se as configurações de proxy estão corretas.

Se o proprietário de uma assinatura ou conta concedeu a você acesso a um recurso, verifique se você tem permissões de "leitura" ou "lista" para esse recurso.

A cadeia de conexão não tem definições de configuração completas

Se você receber essa mensagem de erro, é possível que não tenha as permissões necessárias para obter as chaves para sua conta de armazenamento. Para confirmar, acesse o portal e localize sua conta do armazenamento. Clique com o botão direito no nó de sua conta de armazenamento e selecione Abrir no Portal. Em seguida, vá até o painel Chaves de Acesso. Se você não tiver permissão para visualizar as chaves, poderá ver a mensagem "Você não tem acesso". Para contornar esse problema, você pode obter um nome da conta e chave ou uma assinatura de acesso compartilhado da conta e usá-lo para anexar a conta de armazenamento.

Se você vir as chaves da conta, registre um problema no GitHub para que possamos ajudá-lo a resolver o problema.

A adição de conexões personalizadas resulta em um TypeError

Os dados de conexão armazenados no gerenciador de credenciais local podem estar corrompidos se você receber a seguinte mensagem de erro ao tentar adicionar uma conexão personalizada:

Ocorreu um erro ao adicionar uma nova conexão: TypeError: não é possível ler a propriedade 'version' de indefinido

Para contornar esse problema, tente excluir e adicionar de volta suas conexões locais corrompidas:

1. Inicie o Gerenciador de Armazenamento. No menu, vá para Ajuda>Alternar Ferramentas para Desenvolvedores.

2. Na janela aberta, na guia Aplicativo, acesse Armazenamento Local>file:// no lado esquerdo.

3. Dependendo do tipo de conexão no qual você está tendo um problema, procure a chave. Em seguida, copie o valor dela em um editor de texto. O valor é uma matriz com seus nomes de conexão personalizados, por exemplo:

   • Contas de armazenamento
     • StorageExplorer_CustomConnections_Accounts_v1
   • Contêineres de blob
     • StorageExplorer_CustomConnections_Blobs_v1
     • StorageExplorer_CustomConnections_Blobs_v2
   • Compartilhamentos de arquivos
     • StorageExplorer_CustomConnections_Files_v1
   • Filas
     • StorageExplorer_CustomConnections_Queues_v1
   • Tabelas
     • StorageExplorer_CustomConnections_Tables_v1

4. Depois de salvar os nomes das suas conexões atuais, defina o valor em Ferramentas para Desenvolvedores como [].

Para preservar as conexões que não estão corrompidas, executar as etapas a seguir para localizar as conexões corrompidas. Se você não se importar em perder todas as conexões existentes, ignore essas etapas e siga as instruções específicas da plataforma para limpar os dados de conexão.

1. Em um editor de texto, adicione novamente cada nome de conexão às Ferramentas do Desenvolvedor. Em seguida, verifique se a conexão ainda está funcionando.
2. Se uma conexão estiver funcionando corretamente, ela não está corrompida; você pode deixá-lo lá com segurança. Se uma conexão não estiver funcionando, remova seu valor das Ferramentas de Desenvolvedor e grave-o para que você possa adicioná-lo novamente mais tarde.
3. Repita para cada conexão.

Depois de remover os nomes de conexão, você deve limpar seus dados corrompidos. Em seguida, você pode adicionar as conexões novamente usando as etapas de conexão padrão no Gerenciador de Armazenamento.

Se você ainda encontrar esse erro depois de executar essas etapas ou se quiser compartilhar o que suspeita ter corrompido as conexões, abra um problema em nossa página do GitHub.

Problemas com uma URL de assinatura de acesso compartilhado

Se você se conectar a um serviço por meio de uma URL de assinatura de acesso compartilhado e tiver um erro, verifique:

• A URL fornece as permissões necessárias para ler ou listar recursos.
• O URL não expirou.
• A política de acesso não será revogada se a URL de assinatura de acesso compartilhado for baseada em uma política de acesso.

Se você anexou acidentalmente usando uma URL de assinatura de acesso compartilhado inválida e não puder desanexá-la, execute as etapas a seguir:

1. Quando estiver executando o Gerenciador de Armazenamento, selecione F12 para abrir a janela Ferramentas do Desenvolvedor.
2. Na guia Aplicativo, selecione Armazenamento Local>file:// no lado esquerdo.
3. Localize a chave associada ao tipo de serviço do URI de assinatura de acesso compartilhado. Por exemplo, se o URI da assinatura de acesso compartilhado incorreto for para um contêiner de blob, procure a chave nomeada StorageExplorer_AddStorageServiceSAS_v1_blob.
4. O valor da chave deve ser uma matriz JSON. Encontre o objeto associado ao URI inválido e exclua-o.
5. Selecione Ctrl +R para recarregar o Gerenciador de Armazenamento.

Dependências do Gerenciador de Armazenamento

snap connect storage-explorer:password-manager-service :password-manager-service

snap connect storage-explorer:password-manager-service :password-manager-service

snap connect storage-explorer:password-manager-service :password-manager-service

Aplicar patch no Gerenciador de Armazenamento para versões mais recentes do .NET Core

Para o Gerenciador de Armazenamento 1.7.0 ou versões anteriores, talvez seja necessário corrigir a versão do .NET Core usada pelo Gerenciador de Armazenamento:

1. Vá para a página NuGet e baixe a versão 1.5.43 do StreamJsonRpc do link Baixar pacote no lado direito.

2. Depois de baixar o pacote, altere extensão do arquivo de .nupkg para .zip.

3. Descompacte o pacote.

4. Abra a pasta streamjsonrpc.1.5.43/lib/netstandard1.1.

5. Copie StreamJsonRpc.dll para os seguintes locais na pasta do Gerenciador de Armazenamento:

   • StorageExplorer/resources/app/ServiceHub/Services/Microsoft.Developer.IdentityService
   • StorageExplorer/resources/app/ServiceHub/Hosts/ServiceHub.Host.Core.CLR.x64

O botão "Abrir no Explorer" no portal do Azure não funciona

Se o botão Abrir no Explorer no portal do Azure não funcionar, verifique se você está usando um navegador compatível. Os seguintes navegadores foram testados quanto à compatibilidade:

• Microsoft Edge
• Mozilla Firefox
• Google Chrome
• Microsoft Internet Explorer

Coletar logs

Ao relatar um problema para o GitHub, você pode receber uma solicitação para coletar determinados logs para ajudar a diagnosticar o problema.

Logs do Gerenciador de Armazenamento

O Gerenciador de Armazenamento registra em log várias coisas nos próprios logs do aplicativo. Você pode acessar esses logs facilmente selecionando Ajuda>Abrir Diretório de Logs. Por padrão, o Gerenciador de Armazenamento registra logs em um nível baixo de detalhes. O nível de log de rastreamento é recomendado durante a solução de problemas, pois é o nível mais detalhado.

Para alterar o nível de detalhamento, vá para Configurações (o símbolo de engrenagemna barra de ferramentas vertical) Nível>>e selecione o nível de log desejado. Reinicie o Gerenciador de Armazenamento e reproduza o problema que você está tendo.

Os logs são divididos em pastas para cada sessão do Gerenciador de Armazenamento que você executa. Para quaisquer arquivos de log que você precise compartilhar, coloque-os em um arquivo zip, com arquivos de sessões diferentes em pastas diferentes.

Logs de autenticação

Para problemas relacionados à entrada ou à biblioteca de autenticação do Gerenciador de Armazenamento, você provavelmente precisará coletar logs de autenticação. Os logs de autenticação são armazenados em:

Em geral, você pode seguir estas etapas para coletar os logs:

1. Vá para Configurações (o símbolo de engrenagemna barra de ferramentas vertical)>. Selecione Registro de Autenticação Detalhado. Se o Gerenciador de Armazenamento não for iniciado devido a um problema com sua biblioteca de autenticação, esta etapa será feita para você.
2. Feche o Gerenciador de Armazenamento.
3. Opcional/recomendado: limpe os logs existentes da logs pasta. Essa etapa reduz a quantidade de informações que você precisa nos enviar.
4. Abra o Gerenciador de Armazenamento e reproduza seu problema
5. Feche o Gerenciador de Armazenamento.
6. Compacte o conteúdo da pasta logs.

Logs do AzCopy

Se você estiver tendo problemas para transferir dados, talvez seja necessário obter os logs do AzCopy. Por padrão, o AzCopy registra em um baixo nível de detalhamento. O nível de log de rastreamento é recomendado durante a solução de problemas, pois é o nível mais detalhado.

Para alterar o nível de detalhamento, vá para Configurações (o símbolo de engrenagem na barra de ferramentas vertical) Transfere>o nível>>e defina o nível de log desejado. Reinicie o Gerenciador de Armazenamento e reproduza o problema que você está tendo.

Os logs do AzCopy podem ser encontrados facilmente por meio de dois métodos diferentes:

• Para as transferências com falha que ainda estejam no Log de Atividades, selecione Ir para o Arquivo de Log do AzCopy.

• Para transferências que falharam no passado, vá para a pasta de logs do AzCopy. Essa pasta pode ser encontrada em:

  Plataforma	Caminho da pasta
  Windows	C:\Users\<your username>\.azcopy
  macOS	~/.azcopy
  Linux	~/.azcopy

Logs de rede

Para alguns problemas, você precisa fornecer logs das chamadas de rede feitas pelo Gerenciador de Armazenamento. No Windows, você pode obter logs de rede usando o Fiddler.

Parte 1: Instalar e configurar o Fiddler

1. Instale o Fiddler.
2. Inicie o Fiddler.
3. Acesse Ferramentas>Opções.
4. Selecione a guia HTTPS.
5. Verifique se as opções Capturar CONEXÕES e Descriptografar tráfego HTTPS estão marcadas.
6. Selecione Ações.
7. Selecione Certificado Raiz de Confiança e, em seguida, selecione Sim na próxima caixa de diálogo.
8. Inicie o Gerenciador de Armazenamento.
9. Vá para Configurações (o símbolo de engrenagemna barra de ferramentas vertical)>.
10. Altere a lista suspensa de origem do proxy para Usar proxy do sistema (versão prévia).
11. Reinicie o Gerenciador de Armazenamento.
12. Você deve começar a ver as chamadas de rede de um processo storageexplorer: aparecendo no Fiddler.

Parte 2: Reproduzir o problema

1. Feche todos os aplicativos exceto o Fiddler.
2. Limpe o log do Fiddler usando o X no canto superior esquerdo, próximo ao menu Exibir .
3. Opcional/recomendado: deixe o Fiddler definido por alguns minutos. Se você vir aparecerem chamadas de rede que não estão relacionadas ao Gerenciador de Armazenamento, clique com o botão direito nelas e selecione Filtrar Agora>Ocultar <nome do processo>.
4. Inicie/reinicie o Gerenciador de Armazenamento.
5. Reproduza o problema.
6. Selecione Arquivo>Salvar>Todas as Sessões. Salve-o em um local fácil de lembrar.
7. Feche o Fiddler e o Gerenciador de Armazenamento.

Parte 3: Limpar o rastreamento do Fiddler

1. Clique duas vezes no rastreamento do Fiddler (arquivo .saz).
2. Selecione Ctrl + F.
3. Na caixa de diálogo exibida, verifique se as seguintes opções estão definidas: Pesquisar = solicitações e respostas e Examinar = cabeçalhos e corpos.
4. Pesquise todas as senhas que você usou enquanto coletou o rastreamento do Fiddler e todas as entradas realçadas. Clique com o botão direito e selecione Remover>Sessões selecionadas.
5. Você pode pular o envio do arquivo .saz se alguma das seguintes condições for verdadeira:
   • Você definitivamente inseriu senhas em seu navegador enquanto coletava o rastreamento, mas não encontra nenhuma entrada ao usar Ctrl + F.
   • Você não quer alterar suas senhas.
   • As senhas que você usou são para outras contas.
6. Salve o rastreamento novamente com um novo nome.
7. Opcional: exclua o rastreamento original.

O Gerenciador de Armazenamento não consegue encontrar contêineres do Docker do Azurite

Se o Gerenciador de Armazenamento não conseguir encontrar os contêineres do Docker do Azurite, siga estas etapas para solucionar o problema:

Verifique se o Docker está instalado

Certifique-se de que o Docker esteja instalado e em execução em sua máquina. Você pode verificar a instalação do Docker executando o seguinte comando no terminal ou no prompt de comando:

docker --version

Se o Docker não estiver em execução, reinicie os serviços do Docker e tente novamente.

Para usuários do Linux, talvez seja necessário ingressar no docker grupo. Para ingressar no grupo, execute os seguintes comandos:

sudo groupadd docker
sudo usermod -aG docker $USER

Depois de adicionado ao grupo, reinicie sua docker máquina. Para obter mais informações, consulte Etapas de pós-instalação do Linux para o Docker Engine.

Verificar o contexto do Docker

Verifique se você está usando o contexto correto do Docker que está gerenciando seus contêineres. Você pode verificar seu contexto atual executando:

docker context ls

Para alterar seu contexto ativo, use:

docker context use <context name>

Verifique o status do contêiner de azurita

Verifique se os contêineres do Azurite estão em execução. Você pode verificar o status dos contêineres do Docker executando:

docker container list --all

Certifique-se de que seus contêineres de Azurita estejam listados e seu status seja Ativo. Se um contêiner não estiver em execução, você poderá iniciá-lo com:

docker start <container name>

Verificar portas do Azurite

Certifique-se de que as configurações de porta dos contêineres Azurite estejam corretas. Você pode verificar as portas executando:

docker inspect <container name>

Procure a NetworkSettings.Ports seção na saída para verificar os mapeamentos de porta. Por exemplo, supondo que o ponto de extremidade de blob de um contêiner Azurite esteja configurado para escutar na porta 10000 e que a porta do contêiner esteja mapeada para a porta 10010 do computador host, você deverá ver uma entrada como esta:

"10000/tcp": [
  {
    "HostIp": "0.0.0.0",
    "HostPort": "10010"
  }
]

Verifique se você tem a versão mais recente do Gerenciador de Armazenamento instalada

Verifique se você está usando a versão mais recente do Gerenciador de Armazenamento. Você pode verificar se há atualizações acessando Ajuda

Para usuários de snap do Linux, verifique se o snap tem as conexões necessárias com o snap do Docker. Para fazer as conexões necessárias, execute os seguintes comandos:

snap connect storage-explorer:docker docker:docker-daemon
snap connect storage-explorer:docker-executables docker:docker-executables

Verifique se as contas personalizadas são válidas

Se você estiver usando contas personalizadas, verifique se os nomes e as chaves de conta são válidos e configurados corretamente no Gerenciador de Armazenamento. Você pode verificar as contas personalizadas em uso executando:

docker exec <container name> printenv AZURITE_ACCOUNTS

Verificar as configurações de rede

Certifique-se de que não haja problemas de rede que impeçam o Gerenciador de Armazenamento de se conectar ao contêiner Azurita. Verifique se o firewall ou o software antivírus não está bloqueando a conexão.

Reinicie o contêiner de azurita

Se o problema persistir, tente reiniciar o contêiner Azurita:

docker restart <container name>

Recriar o contêiner de Azurita

Se nenhuma das etapas acima resolver o problema, tente recriar o contêiner de Azurita. Por exemplo:

docker stop <container name>
docker rm <container name>
docker run \
  --name <container-name> \
  -e AZURITE_ACCOUNTS="<custom account name>:<custom key>" \
  -p <blob-host-port>:10000 \
  -p <queue-host-port>:10001 \
  -p <table-host-port>:10002 \
  mcr.microsoft.com/azure-storage/azurite

O Gerenciador de Armazenamento não é executado na sessão FSLogix

Se o FSLogix gerenciar seu perfil de usuário, o Gerenciador de Armazenamento poderá não ser executado devido a um EEXIST erro. O erro ocorre devido a um problema conhecido com determinadas versões do FSLogix. Se você encontrar o erro, verifique se está usando a versão mais recente do FSLogix. Se o problema ainda ocorrer, podemos contorná-lo seguindo estas etapas:

1. Abra o Console de Gerenciamento de Política de Grupo (gpmc.msc).

2. Crie ou edite um GPO (Objeto de Política de Grupo) direcionado aos hosts de sessão do AVD.

3. Navegue até: Configuração do Computador > Preferências > Configurações do Windows > Registro.

4. Adicione um novo Item do Registro com as seguintes configurações:

   Ação	Update
   Hive	HKEY_LOCAL_MACHINE
   Caminho de chave	SYSTEM\CurrentControlSet\Services\frxdrvvt
   Nome do valor	SupportedFeatures
   Tipo de valor	REG_DWORD
   Dados do valor	11 (0xB)

5. Aplique o GPO e reinicie os hosts de sessão.

Próximas etapas

Se nenhuma dessas soluções funcionar para você, use um dos seguintes métodos:

• Criar um tíquete de suporte.

• Abra um problema no GitHub selecionando o botão Denunciar problema no GitHub no canto inferior esquerdo.

  

Aviso de isenção de responsabilidade para informações de terceiros

Os produtos de terceiros mencionados neste artigo são produzidos por empresas independentes da Microsoft. A Microsoft não oferece nenhuma garantia, implícita ou não, do desempenho ou da confiabilidade desses produtos.