Partilhar via

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

  • Artigo

Observação

Esse artigo foi útil? Sua opinião é importante para nós. Use o botão Comentários nesta página para nos informar o quão bem este artigo funcionou para você ou como podemos melhorá-lo.

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 RBAC

O RBAC do Azure (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 estiver tendo problemas para acessar recursos de armazenamento por meio do Azure RBAC, talvez você não tenha sido atribuído às funções apropriadas. 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 “Leitura: Listar/Obter Conta(s) 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.

Observação

As chaves de acesso concedem permissões irrestritas a qualquer pessoa que as possua. Como resultado, não recomendamos que você entregue essas chaves a usuários da conta. Se você precisar revogar as chaves de acesso, poderá regenerá-las no portal do Azure.

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.

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:

Observação

As funções Proprietário, Colaborador e Colaborador da Conta de Armazenamento concedem acesso à chave de conta.

Problemas de certificado SSL

Esta seção discute problemas de certificado SSL.

Noções básicas sobre problemas de certificado SSL

Leia a seção Certificados 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 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 SSL

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

Execute estas etapas para encontrá-los:

  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 saber mais, confira esta lista de nomes de host que são 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 -----END CERTIFICATE----- em um novo arquivo .cer-----BEGIN 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.

Desabilitar a validação do certificado 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. Esse sinalizador não é recomendado.

Problemas de credenciais

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

Noções básicas de entrada

Leia 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.

Políticas de acesso condicional

Se houver políticas de acesso condicional que precisam ser atendidas para sua conta, verifique se está usando o valor 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.

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 receber uma mensagem de erro dizendo que não é possível adquirir um token 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 da 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.
  • Qual versão do Gerenciador de Armazenamento você está tentando usar.
  • Se você verificou os pré-requisitos.
  • Logs de autenticação de um 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.

Loop de reautenticação ou alteração de UPN

Se você estiver em um loop de reautenticação ou tiver alterado o UPN de uma das suas contas, tente 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 Comando + Barra de Espaço, digite chaves 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.

    Captura de tela que mostra o cadeado.

  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 será iniciado. Se o seu sistema não tiver uma ferramenta de gerenciamento de credenciais local instalada, instale uma ferramenta de terceiros 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, isso pode não ocorrer, resultando em erros de janela de aplicativo ou serviço do 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 fazer isso, 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.
  • Verifique se você entrou usando o ambiente certo do Azure, como Azure, Azure China 21Vianet, Azure Alemanha, Azure Governo dos EUA ou Ambiente Personalizado.
  • Se você estiver atrás de um servidor proxy, verifique se configurou corretamente o proxy do Gerenciador de Armazenamento.
  • Tente remover e adicionar de volta à conta.
  • Se houver um link "Mais informações" ou "Detalhes do erro", verifique quais mensagens de erro estão sendo relatadas para os locatários que estão com falha. 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:

  • Windows: %AppData%/StorageExplorer
  • macOS: /Users/<seu_nome>/Library/Application Support/StorageExplorer
  • Linux: ~/.config/StorageExplorer

Feche o Gerenciador de Armazenamento antes de excluir essas pastas.

Observação

Se você já importou todos os certificados SSL, faça backup do conteúdo do diretório certs. Posteriormente, você pode usar o backup para reimportar os certificados SSL.

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 NTLM.

Observação

O Gerenciador de Armazenamento não dá suporte aos arquivos de configuração automática de proxy para definir configurações de proxy.

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ê 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 tiver concedido a você acesso a um recurso, verifique se você tem permissões de leitura ou listadas 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, verá uma 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.

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

Se você receber essa mensagem de erro ao tentar adicionar uma conexão personalizada, os dados de conexão armazenados no gerenciador de credenciais local podem estar corrompidos. 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 será corrompida. Você poderá deixá-la ali 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 até examinar todas as suas conexões.

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.

  1. No menu Iniciar, pesquise por Gerenciador de Credenciais e abra-o.
  2. Vá para Credenciais do Windows.
  3. Em Credenciais Genéricas, procure entradas que tenham a chave <connection_type_key>/<corrupted_connection_name>. Um exemplo é StorageExplorer_CustomConnections_Accounts_v1/account1.
  4. Exclua e adicione essas conexões novamente.

Se você ainda encontrar esse erro depois de executar essas etapas, ou se quiser compartilhar o que suspeita que tenha 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 experimentar um erro:

  • Verifique se a URL fornece as permissões necessárias para ler ou lista recursos.
  • Verifique se a URL não expirou.
  • Se a URL da assinatura de acesso compartilhado tiver base em uma política de acesso, verifique se a política de acesso não foi revogada.

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

O Gerenciador de Armazenamento vem empacotado com todas as dependências necessárias para ser executado no Windows.

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. Para alterar o nível de detalhamento, acesse Configurações (o símbolo de engrenagem à esquerda) >Aplicativo>Registrar em log>Nível de log. Em seguida, você pode definir o nível de log conforme necessário. Para solução de problemas, o nível de log de rastreamento é recomendado, pois é o nível mais detalhado.

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:

  • Windows: C:\Usuários\<seu nome de usuário>\AppData\Local\Temp\servicehub\logs
  • macOS: ~/.ServiceHub/logs
  • Linux: ~/.ServiceHub/logs

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

  1. Acesse Configurações (o símbolo de engrenagem à esquerda) >Application>Entrada. 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 na pasta logs. 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. 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:

    • Windows: C:\Usuários\<seu nome de usuário>\.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.

Observação

Os rastreamentos do Fiddler podem conter senhas inseridas ou enviadas no navegador durante a coleta do rastreamento. Leia as instruções sobre como limpar um rastreamento do Fiddler. Não carregue rastreamentos do Fiddler no GitHub. Você será informado para onde pode enviar com segurança o rastreamento do 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 engrenagem à esquerda) >Proxy de Aplicativo>.
  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 algum lugar que você não esquecerá.
  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. Se você definitivamente inseriu senhas em seu navegador enquanto coletava o rastreamento, mas não encontrou nenhuma entrada ao usar Ctrl + F, não deseja alterar suas senhas ou se as senhas usadas forem usadas para outras contas, pule o envio do arquivo .saz.
  6. Salve o rastreamento novamente com um novo nome.
  7. Opcional: exclua o rastreamento original.

Próximas etapas

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

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.

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.