Compartir vía

Guía de solución de problemas del Explorador de Azure Storage

  • Artículo

Nota:

¿Le resultó útil este artículo? Su opinión es importante para nosotros. Use el botón Comentarios de esta página para indicarnos lo bien que ha funcionado este artículo o cómo podemos mejorarlo.

Explorador de Microsoft Azure Storage es una aplicación independiente que facilita el trabajo con los datos de Azure Storage en Windows, macOS y Linux. La aplicación puede conectarse a las cuentas de Storage hospedadas en Azure, nubes nacionales y Azure Stack.

En esta guía se resumen las soluciones de los problemas comunes que se encuentran con frecuencia en Explorador de Storage.

Problemas de permisos de RBAC de Azure

El control de acceso basado en rol de Azure (RBAC de Azure) permite la administración de acceso muy granular de los recursos de Azure mediante la combinación de conjuntos de permisos en roles. Aquí encontrará algunas estrategias para que RBAC de Azure funcione de forma óptima en el Explorador de Storage.

¿Cómo se accede a los recursos en Explorador de Storage?

Si tiene problemas para acceder a los recursos de almacenamiento mediante RBAC de Azure, es posible que se deba a que no se le han asignado los roles adecuados. En las siguientes secciones se describen los permisos que el Explorador de Storage requiere actualmente para acceder a los recursos de almacenamiento. Si no está seguro de tener los roles o permisos adecuados, póngase en contacto con el administrador de la cuenta de Azure.

"Problema de permisos de lectura para enumerar u obtener cuentas de almacenamiento"

Debe tener permiso para enumerar las cuentas de almacenamiento. Para obtener este permiso, se le debe haber asignado el rol Lector.

Enumerar claves de cuentas de almacenamiento

El Explorador de Storage también puede usar las claves de cuenta para autenticar las solicitudes. Puede acceder a las claves de las cuentas con roles más eficaces, como el rol Colaborador.

Nota:

Las claves de acceso otorgan permisos ilimitados a cualquier persona que disponga de ellas. Como resultado, no se recomienda entregar estas claves a los usuarios de la cuenta. Si necesita revocar las claves de acceso, puede regenerarlas desde Azure Portal.

Roles de datos

Se le debe haber asignado al menos un rol que conceda acceso para leer datos de los recursos. Por ejemplo, si desea enumerar o descargar blobs, necesita, al menos, el rol Lector de datos de Storage Blob.

¿Por qué se necesita un rol de la capa de administración para ver los recursos en el Explorador de Storage?

Azure Storage tiene dos capas de acceso: administración y datos. Se accede a las suscripciones y cuentas de almacenamiento mediante la capa de administración. Se accede a los contenedores, blobs y otros recursos de datos mediante la capa de datos. Por ejemplo, si desea obtener una lista de las cuentas de almacenamiento de Azure, debe enviar una solicitud al punto de conexión de administración. Si desea obtener una lista de los contenedores de blobs de una cuenta, envíe una solicitud al punto de conexión de servicio adecuado.

Los roles de Azure pueden concederle los permisos necesario s para obtener acceso a la capa de datos o de administración. Por ejemplo, el rol Lector otorga acceso de solo lectura a los recursos de la capa de administración.

Estrictamente hablando, el rol Lector no proporciona permisos para la capa de datos y no es necesario para acceder a esa capa.

El Explorador de Storage facilita el acceso a los recursos mediante la recopilación de la información necesaria para conectarse a los recursos de Azure. Por ejemplo, para mostrar los contenedores de blobs, el Explorador de Storage envía una solicitud de "lista de contenedores" al punto de conexión del servicio de blobs. Para obtener ese punto de conexión, el Explorador de Storage busca la lista de suscripciones y cuentas de almacenamiento a las que tiene acceso. Para encontrar sus suscripciones y cuentas de almacenamiento, el Explorador de Storage también necesita acceso a la capa de administración.

Si no tiene ningún rol que conceda permisos para la capa de administración, el Explorador de Storage no puede obtener la información que necesita para conectarse a la capa de datos.

¿Qué sucede si no puedo obtener los permisos de la capa de administración que necesito de mi administrador?

Si quiere acceder a los contenedores de blobs, a los contenedores o directorios de Azure Data Lake Storage Gen2, o a las colas, puede asociarlos a esos recursos con las credenciales de Azure.

  1. Abra el cuadro de diálogo Conectar .
  2. Seleccione el tipo de recurso al que desea conectarse.
  3. Seleccione Iniciar sesión con microsoft Entra ID>Siguiente.
  4. Seleccione la cuenta de usuario y el inquilino asociados al recurso al que está adjuntando y, a continuación, seleccione Siguiente.
  5. Escriba la dirección URL del recurso y escriba un nombre para mostrar único para la conexión. Seleccione Siguiente>Conectar.

Actualmente, no hay una solución relacionada con RBAC de Azure para otros tipos de recursos. Como solución alternativa, puede solicitar una dirección URL de firma de acceso compartido y, a continuación, adjuntarla al recurso:

  1. Abra el cuadro de diálogo Conectar .
  2. Seleccione el tipo de recurso al que desea conectarse.
  3. Seleccione Firma de acceso compartido (SAS)> Siguiente.
  4. Escriba la dirección URL de firma de acceso compartido que recibió y escriba un nombre para mostrar único para la conexión. Seleccione Siguiente>Conectar.

Para más información sobre cómo asociar recursos, consulte Asociación a un recurso individual.

Varios roles integrados de Azure pueden proporcionar los permisos necesarios para usar Explorador de Storage. Algunos de estos roles son:

Nota:

Los roles de propietario, colaborador y colaborador de la cuenta de almacenamiento conceden acceso a la clave de cuenta.

Problemas de certificados SSL

En esta sección, se tratan los problemas de certificados SSL.

Descripción de los problemas de certificados SSL

Asegúrese de haber leído la sección Certificados SSL de la documentación de redes del Explorador de Storage antes de continuar.

Usar proxy del sistema

Si solo usa características que admiten la configuración Usar proxy del sistema, pruebe a usar esa configuración. Para más información sobre la configuración Usar proxy del sistema, consulte Conexiones de red en el Explorador de Storage.

Importación de certificados SSL

Si tiene una copia de los certificados autofirmados, puede indicar al Explorador de Storage que confíe en ellos:

  1. Obtenga una copia X.509 codificado base 64 (.cer) del certificado.
  2. Vaya a Edit>SSL Certificates>Import Certificates (Editar > Certificados SSL > Importar certificados). A continuación, use el selector de archivos para buscar, seleccionar y abrir el archivo .cer.

Este problema también puede aparecer si hay varios certificados (raíz e intermedio). Para corregir este error, debe importar todos los certificados.

Búsqueda de certificados SSL

Si no tiene una copia de los certificados autofirmados, póngase en contacto con el administrador de TI para obtener ayuda.

Siga estos pasos para encontrarlos:

  1. Instale OpenSSL:

    • Windows: cualquiera de las versiones ligeras debería ser suficiente.
    • Mac: OpenSSL debería estar incluido con el sistema operativo.
    • Linux: OpenSSL debería estar incluido con el sistema operativo.

  2. Ejecute OpenSSL:

    • Windows: abra el directorio de instalación, seleccione /bin/y haga doble clic en openssl.exe.
    • Mac: ejecute openssl desde un terminal.
    • Linux: ejecute openssl desde un terminal.

  3. Ejecute el comando openssl s_client -showcerts -connect <hostname>:443 para cualquiera de los nombres de host de Microsoft o Azure detrás de los que estén los recursos de almacenamiento. Para más información, consulte esta lista de nombres de host a los que el Explorador de Storage accede con frecuencia.

  4. Busque certificados autofirmados. Si el firmante ("s:") y el emisor ("i:") son iguales, lo más probable es que el certificado sea autofirmado.

  5. Cuando encuentre los certificados autofirmados, para cada uno, copie y pegue todo de -----BEGIN CERTIFICATE----- a -----END CERTIFICATE----- un nuevo archivo .cer.

  6. Abra el Explorador de Storage y vaya a Editar>Certificados SSL>Importar certificados. A continuación, use el selector de archivos para encontrar, seleccionar y abrir los archivos .cer que ha creado.

Deshabilitación de la validación de certificados SSL

Si no encuentra ningún certificado autofirmado con estos pasos, póngase en contacto con nosotros mediante la herramienta de comentarios. También puede abrir el Explorador de Storage desde la línea de comandos con la marca --ignore-certificate-errors. Cuando se abre con esta marca, el Explorador de Storage pasa por alto los errores de certificado. Esta marca no se recomienda.

Problemas de inicio de sesión

En esta sección, se tratan los problemas de inicio de sesión que puede encontrar.

Descripción del inicio de sesión

Asegúrese de haber leído la documentación Inicio de sesión en el Explorador de Storage antes de continuar.

Tener que volver a escribir las credenciales con frecuencia

Tener que volver a escribir las credenciales es el resultado de las directivas de acceso condicional establecidas por el administrador de Microsoft Entra. Cuando Explorador de Storage le pide que vuelva a escribir las credenciales en el panel de cuentas, debería ver un vínculo Detalles del error. Selecciónelo para ver por qué le pide el Explorador de Storage que vuelva a escribir las credenciales. Los errores de directiva de acceso condicional que requieren volver a escribir las credenciales pueden tener un aspecto similar al siguiente:

  • El token de actualización ha expirado.
  • Debe usar la autenticación multifactor para obtener acceso.
  • El administrador ha realizado un cambio de configuración.

Para reducir la frecuencia de tener que volver a escribir las credenciales debido a errores como los anteriores, hable con el administrador de Microsoft Entra.

Directivas de acceso condicional

Si tiene directivas de acceso condicional que se deban cumplir en la cuenta, asegúrese de que usa el valor Default Web Browser (Explorador web predeterminado) en la opción Sign in with (Iniciar sesión con). Para obtener información sobre esa opción de configuración, consulte Cambio del lugar donde se produce el inicio de sesión.

El explorador se queja de la redirección HTTP o una conexión insegura durante el inicio de sesión

Cuando Explorador de Storage realiza el inicio de sesión en el explorador web, se realiza una redirección a localhost al final del proceso de inicio de sesión. A veces, los exploradores generan una advertencia o un error de que el redireccionamiento se realiza con HTTP en lugar de HTTPS. Algunos exploradores también pueden intentar forzar que el redireccionamiento se realice con HTTPS. Si se produce alguno de estos problemas, en función del explorador, tiene opciones:

  • Ignore la advertencia.
  • Agregue una excepción para localhost.
  • Deshabilite force HTTPS, ya sea global o solo para localhost.

Si no puede realizar ninguna de estas opciones, también puede cambiar el lugar dónde se produce el inicio de sesión integrado para evitar usar el explorador por completo.

No se puede adquirir el token, el inquilino está filtrado

A veces puede ver un mensaje de error que indica que no se puede adquirir un token porque el inquilino está filtrado, lo que significa que intenta acceder a un recurso que está en un inquilino que ha filtrado. Para incluir el filtro del inquilino, vaya al panel Account (Cuenta). Asegúrese de que esté seleccionada la casilla del inquilino especificado en el error. Consulte Administración de cuentas para más información sobre el filtrado de inquilinos en el Explorador de Storage.

No se pudo iniciar correctamente la biblioteca de autenticación

Si, al iniciarse, verá un mensaje de error que indica que la biblioteca de autenticación de Explorador de Storage no se pudo iniciar correctamente, asegúrese de que el entorno de instalación cumple todos los requisitos previos. No cumplir los requisitos previos es la causa más probable de este mensaje de error.

Si cree que el entorno de instalación cumple todos los requisitos previos, abra un problema en GitHub. Al abrir el problema, asegúrese de incluir lo siguiente:

  • El sistema operativo.
  • Qué versión del Explorador de Storage intenta usar.
  • Si ha comprobado los requisitos previos.
  • Los registros de autenticación desde un inicio erróneo del Explorador de Storage. El registro de autenticación detallado se habilita automáticamente después de que se produzca este tipo de error.

Ventana en blanco cuando se usa el inicio de sesión integrado

Si decide usar el inicio de sesión integrado y verá una ventana de inicio de sesión en blanco, es probable que tenga que cambiar a otro método de inicio de sesión. Los cuadros de diálogo de inicio de sesión en blanco a menudo aparecen cuando el servidor de los Servicios de federación de Active Directory (AD FS) solicita al Explorador de Storage que realice una redirección, lo que no es compatible con Electron.

Para cambiar a otro método de inicio de sesión, cambie la opción Sign in with (Iniciar sesión con) en Settings>Application>Sign-in (Configuración > Aplicación > Inicio de sesión). Para obtener información sobre los diferentes tipos de métodos de inicio de sesión, consulteCambiar dónde se produce el inicio de sesión.

Bucle de reautenticación o cambio UPN

Si se encuentra en un bucle de reautenticación o ha cambiado el UPN de una de las cuentas, siga estos pasos:

  1. Abra el Explorador de Storage.
  2. Vaya a Help>Reset (Ayuda > Restablecer).
  3. Asegúrese de que esté seleccionada al menos la opción Authentication (Autenticación). Anule la selección de los otros elementos que no quiera restablecer.
  4. Seleccione Restablecer.
  5. Reinicie el Explorador de Storage e intente iniciar sesión de nuevo.

Si sigue teniendo problemas después de realizar un restablecimiento, pruebe estos pasos:

  1. Abra el Explorador de Storage.
  2. Quite todas las cuentas y cierre el Explorador de Storage.
  3. Elimine la carpeta .IdentityService de la máquina. En Windows, la carpeta se encuentra en C:\Usuarios\<nombre_de_usuario>\AppData\Local. En Mac y Linux, puede encontrar la carpeta en la raíz de su directorio de usuario.
  4. En Mac o Linux, también deberá eliminar la entrada Microsoft.Developer.IdentityService del almacén de claves del sistema operativo. En Mac, el almacén de claves es la aplicación Gnome Keychain. En Linux, la aplicación habitualmente se denomina Keyring pero el nombre puede ser diferente en función de su distribución.
  5. Reinicie el Explorador de Storage e intente iniciar sesión de nuevo.

macOS: errores de Keychain o no hay ventana de inicio de sesión

En ocasiones, Keychain de macOS puede entrar en un estado que ocasiona problemas en la biblioteca de autenticación del Explorador de Storage. Para sacar la cadena de claves de este estado, siga estos pasos:

  1. Cierre el Explorador de Storage.

  2. Abra Llavero seleccionando Barra espaciadora de comandos + , escriba llavero y seleccione Entrar.

  3. Seleccione el llavero de inicio de sesión.

  4. Seleccione el candado para bloquear el llavero. Una vez finalizado el proceso, el candado aparece bloqueado. Puede tardar unos segundos, en función de las aplicaciones que tenga abiertas.

    Captura de pantalla que muestra el candado.

  5. Abra el Explorador de Storage.

  6. Se le pedirá un mensaje como "Service Hub quiere acceder a la cadena de claves". Escriba la contraseña de la cuenta de administrador de Mac y seleccione Permitir siempre. O bien, seleccione la opción Allow (Permitir) si Always Allow (Permitir siempre) no está disponible.

  7. Intente iniciar sesión.

Linux: errores de falta de ventana de la aplicación y de administrador de contraseñas al iniciarse

Si inicia Explorador de Storage en un sistema Linux, puede encontrar uno de los siguientes problemas:

  • No aparece ninguna ventana de aplicación.
  • Se producen errores sobre el administrador de contraseñas del sistema.

Explorador de Storage usa el administrador de credenciales del sistema para proteger los datos, incluidas las credenciales de inicio de sesión y las conexiones SAS. Si no se detecta ninguna aplicación compatible del administrador de credenciales, Explorador de Storage no se iniciará. Si el sistema no tiene instalada una herramienta de administración de credenciales local, instale una herramienta de terceros compatible con libsecret. Por ejemplo, en sistemas Linux que usan el entorno de escritorio GNOME, puede instalar Seahorse.

Explorador de Storage normalmente crea un keyring predeterminado si no existe en el inicio. Sin embargo, en algunos casos, esto podría no producirse, lo que provocaba errores de servicio de administrador de contraseñas o ventanas de aplicación. Para resolver los problemas, establezca manualmente un keyring predeterminado.

Si usa Seahorse y no hay llaves existentes o quiere crear una nueva, siga estos pasos para crear un keyring predeterminado:

  1. Inicie la aplicación "Contraseñas y claves".
  2. Seleccione el botón "+" y, a continuación, seleccione Keyring de contraseñas.
  3. Establezca un nombre y una contraseña para el nuevo llavero.
  4. Haga clic con el botón derecho en el nuevo llavero y seleccione Establecer como predeterminado.

Si usa el ajuste de Explorador de Storage, también debe asegurarse de que Explorador de Storage esté conectado al administrador de contraseñas del sistema. Para ello, ejecute el siguiente comando:

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

El explorador predeterminado no se abre

Si no se abre el explorador predeterminado al intentar iniciar la sesión, pruebe todas las técnicas siguientes:

Otros problemas de inicio de sesión

Si ninguna de las instrucciones anteriores es aplicable al problema de inicio de sesión o si no resuelven el problema de inicio de sesión, abra una incidencia en GitHub.

Suscripciones que faltan e inquilinos rotos

Si no puede recuperar las suscripciones después de iniciar sesión correctamente, pruebe los siguientes métodos de solución de problemas:

  • Compruebe que la cuenta tiene acceso a las que espera. Para comprobar que puede acceder, inicie sesión en el portal para el entorno de Azure que intenta usar.
  • Asegúrese de que ha iniciado sesión en el entorno correcto de Azure, por ejemplo, Azure, Azure China 21Vianet, Azure Alemania, Azure US Government o un entorno personalizado.
  • Si se encuentra detrás de un servidor proxy, asegúrese de haber configurado correctamente el proxy del Explorador de Storage.
  • Pruebe a quitar la cuenta y volver a agregarla.
  • Si hay un vínculo "Más información" o "Detalles del error", compruebe qué mensajes de error se notifican a los inquilinos en los que se producen errores. Si no está seguro de cómo responder a los mensajes de error, abra una incidencia en GitHub.

Problema al interactuar con el almacén de credenciales del sistema operativo durante una transferencia de AzCopy

Si ve este mensaje en Windows, es más probable que el Administrador de credenciales de Windows esté lleno. Para hacer espacio en el Administrador de credenciales de Windows, siga estos pasos:

  1. Cierre el Explorador de Storage.
  2. En el menú Inicio, busque Administrador de credenciales y ábralo.
  3. Vaya a Credenciales de Windows.
  4. En Credenciales genéricas, busque entradas asociadas a programas que ya no use y elimínelos. También puede buscar entradas como azcopy/aadtoken/<some number> y eliminarlas.

Si el mensaje sigue apareciendo después de completar los pasos anteriores o si encuentra este mensaje en plataformas distintas de Windows, puede abrir una incidencia en GitHub.

No se puede quitar una cuenta de almacenamiento adjunta ni un recurso

Si no puede hacerlo mediante la interfaz de usuario, para eliminar manualmente todos los recursos adjuntos debe eliminar las siguientes carpetas:

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

Cierre el Explorador de Storage antes de eliminar estas carpetas.

Nota:

Si alguna vez ha importado certificados SSL, haga una copia de seguridad del contenido del directorio certs. Después, puede utilizar la copia de seguridad para volver a importar los certificados SSL.

Problemas de proxy

Explorador de Storage admite la conexión a recursos de Azure Storage a través de un servidor proxy. Si experimenta algún problema al conectarse a Azure mediante un servidor proxy, estas son algunas sugerencias.

Explorador de Storage solo admite la autenticación básica con servidores proxy. No se admiten otros métodos de autenticación, como NTLM.

Nota:

El Explorador de Storage no es compatible con los archivos de configuración automática del proxy para configurar el proxy.

Comprobación de la configuración del proxy del Explorador de Storage

La opción Application>Proxy>Proxy configuration (Aplicación > Proxy > Configuración de proxy) determina de qué origen obtiene el Explorador de Storage la configuración del proxy.

Si selecciona la opción Use environment variables (Usar variables de entorno), asegúrese de establecer las variables de entorno HTTPS_PROXY o HTTP_PROXY. Las variables de entorno distinguen entre mayúsculas y minúsculas, por lo tanto, asegúrese de establecer las variables correctas. Si estas variables están sin definir o no son válidas, el Explorador de Storage no utilizará un proxy. Reinicie el Explorador de Storage después de modificar las variables de entorno.

Si selecciona Use app proxy settings (Usar configuración de proxy de la aplicación), asegúrese de que la configuración del proxy dentro la aplicación sea correcta.

Pasos para el diagnóstico de problemas

Si todavía tiene problemas, pruebe estos métodos de solución de problemas:

  1. Si puede conectarse a Internet sin usar el proxy, compruebe que el Explorador de Storage funciona sin la configuración del proxy habilitada. Si el Explorador de Storage se conecta correctamente, puede haber un problema con el servidor proxy. Colabore con el administrador para identificar los problemas.
  2. Compruebe que las restantes aplicaciones que utilizan el servidor proxy funcionan como cabría esperar.
  3. Compruebe que puede conectarse al portal del entorno de Azure que intenta usar.
  4. Compruebe que puede recibir las respuestas de los puntos de conexión de servicio. Especifique una de las direcciones URL de punto de conexión en el explorador. Si puede conectarse, debe recibir una InvalidQueryParameterValue respuesta XML o similar.
  5. Compruebe si otro usuario que usa el Explorador de Storage con el mismo servidor proxy puede conectarse. Si puede, es posible que deba ponerse en contacto con el administrador del servidor proxy.

Herramientas para el diagnóstico de problemas

Una herramienta de red, como Fiddler, puede ayudarle a diagnosticar problemas.

  1. Configure la herramienta de red como un servidor proxy que se ejecute en el host local. Si tiene que seguir trabajando detrás de un proxy real, es posible que tenga que configurar la herramienta de redes para conectarse mediante el proxy.
  2. Compruebe el número de puerto utilizado por la herramienta de red.
  3. Configure Explorador de Storage opciones de proxy para usar el host local y el número de puerto de la herramienta de red, como localhost:8888.

Cuando se establece correctamente, la herramienta de red registra las solicitudes de red realizadas por Explorador de Storage a los puntos de conexión de administración y servicio.

Si la herramienta de red no parece estar registrando el tráfico del Explorador de Storage, intente probar la herramienta con otra aplicación. Por ejemplo, escriba la dirección URL del punto de conexión para uno de los recursos de almacenamiento, como https://contoso.blob.core.windows.net/ en un explorador web. Recibirá una respuesta similar a esta muestra 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>

La respuesta sugiere que el recurso existe, aunque no pueda acceder a él.

Si la herramienta de redes solo muestra el tráfico de otras aplicaciones, es posible que tenga que ajustar la configuración del proxy en el Explorador de Storage. De lo contrario, deberá ajustar la configuración de la herramienta.

Póngase en contacto con el administrador del servidor proxy

Si la configuración del proxy es correcta, es posible que deba ponerse en contacto con el administrador del servidor proxy para:

  • Asegurarse de que el proxy no bloquee el tráfico a los puntos de conexión de administración de Azure o de los recursos.
  • Compruebe el protocolo de autenticación utilizado por el servidor proxy. El Explorador de Storage solo admite protocolos de autenticación básicos. El Explorador de Storage no es compatible con los servidores proxy NTLM.

Mensaje de error "No se pueden recuperar los elementos secundarios"

Si está conectado a Azure a través de un servidor proxy, compruebe que la configuración de proxy sea correcta.

Si el propietario de una suscripción o cuenta le ha concedido acceso a un recurso, compruebe que ha leído o enumerado permisos para ese recurso.

La cadena de conexión no tiene una configuración completa

Si recibe este mensaje de error, es posible que no tenga los permisos necesarios para obtener las claves para la cuenta de Storage. Para confirmarlo, vaya al portal y busque la cuenta de almacenamiento. Haga clic con el botón derecho en el nodo de la cuenta de Storage y seleccione Abrir en el portal. Luego, vaya al panel Claves de acceso. Si no tiene permiso para ver las claves, verá un mensaje "No tiene acceso". Para solucionar este problema, puede obtener un nombre y clave de cuenta, o una firma de acceso compartido de cuenta y utilizarla para asociar la cuenta de Storage.

Si ve las claves de cuenta, abra un problema en GitHub para que podamos ayudarle a resolver el problema.

"Se ha producido un error al agregar una nueva conexión: TypeError: No se puede leer la propiedad "version" de undefined"

Si recibe este mensaje de error al intentar agregar una conexión personalizada, es posible que los datos de conexión almacenados en el administrador de credenciales local estén dañados. Para solucionar este problema, pruebe a eliminar las conexiones locales dañadas y volver a agregarlas:

  1. Inicie el Explorador de Storage. En el menú, vaya a Help (Ayuda)>Toggle Developer Tools (Activar y desactivar herramientas de desarrollo).

  2. En la ventana que se abre, en la pestaña Application (Aplicación), vaya a Local Storage (Almacenamiento local) >file:// en el lado izquierdo.

  3. Según el tipo de conexión con la que tenga el problema, busque su clave. A continuación, copie su valor en un editor de texto. El valor es una matriz de los nombres de conexión personalizados similar a la siguiente:

    • Cuentas de almacenamiento
      • StorageExplorer_CustomConnections_Accounts_v1
    • Contenedores de blobs
      • StorageExplorer_CustomConnections_Blobs_v1
      • StorageExplorer_CustomConnections_Blobs_v2
    • Recursos compartidos de archivos
      • StorageExplorer_CustomConnections_Files_v1
    • Colas
      • StorageExplorer_CustomConnections_Queues_v1
    • Tablas
      • StorageExplorer_CustomConnections_Tables_v1

  4. Después de guardar los nombres de conexión actuales, establezca el valor de Developer Tools (Herramientas de desarrollo) en [].

Para conservar las conexiones que no están dañadas, siga estos pasos para localizar las conexiones dañadas. Si no le importa perder todas las conexiones existentes, omita estos pasos y siga las instrucciones específicas de la plataforma para borrar los datos de conexión.

  1. En un editor de texto, vuelva a agregar cada nombre de conexión a Herramientas de desarrollo. A continuación, compruebe si la conexión sigue funcionando.
  2. Si una conexión funciona correctamente, no está dañada, por lo que puede no modificarla sin ningún riesgo. Si una conexión no funciona, quite su valor de Las herramientas de desarrollo y anótelo para que pueda volver a agregarlo más adelante.
  3. Repita el procedimiento hasta que haya examinado todas las conexiones.

Después de quitar los nombres de conexión, debe borrar sus datos dañados. Luego, puede volver a agregar las conexiones mediante los pasos de conexión estándar de Explorador de Storage.

  1. En el menú Inicio, busque Administrador de credenciales y ábralo.
  2. Vaya a Credenciales de Windows.
  3. En Credenciales genéricas , busque las entradas que tengan la clave <connection_type_key>/<corrupted_connection_name>. Un ejemplo es StorageExplorer_CustomConnections_Accounts_v1/account1.
  4. Elimine y vuelva a agregar estas conexiones.

Si el error no desaparece después de realizar estos pasos o si desea compartir lo que crea que ha dañado las conexiones, abra una incidencia en nuestra página de GitHub.

Problemas con una dirección URL de firma de acceso compartido

Si se conecta a un servicio mediante una dirección URL de firma de acceso compartido y experimenta un error:

  • Compruebe que la dirección URL proporciona los permisos necesarios para leer o enumerar los recursos.
  • Compruebe que no haya expirado la dirección URL.
  • Si la dirección URL de firma de acceso compartido se basa en una directiva de acceso, compruebe que no se haya revocado la directiva de acceso.

Si por error realizó la asociación mediante una dirección URL de firma de acceso compartido no válida y ahora no puede desasociarla, siga estos pasos:

  1. Cuando ejecute Explorador de Storage, seleccione F12 para abrir la ventana Herramientas de desarrollo.
  2. En la pestaña Application (Aplicación), seleccione Local Storage (Almacenamiento local) >file:// en el lado izquierdo.
  3. Busque la clave asociada al tipo de servicio del identificador URI de firma de acceso compartido. Por ejemplo, si el identificador URI de firma de acceso compartido incorrecto es para un contenedor de blobs, busque la clave llamada StorageExplorer_AddStorageServiceSAS_v1_blob.
  4. El valor de la clave debe ser una matriz JSON. Busque el objeto asociado con el identificador URI incorrecto y elimínelo.
  5. Seleccione Ctrl +R para volver a cargar Explorador de Storage.

Dependencias de Explorador de Storage

Explorador de Storage incluye todas las dependencias que necesita para ejecutarse en Windows.

Revisión del Explorador de Storage para las versiones más recientes de .NET Core

Para Explorador de Storage 1.7.0 o versiones anteriores, es posible que tenga que aplicar revisiones a la versión de .NET Core que usa Explorador de Storage:

  1. Vaya a la página NuGet y descargue la versión 1.5.43 de StreamJsonRpc desde el vínculo Descargar paquete en el lado derecho.

  2. Después de descargar el paquete, cambie la extensión del archivo de .nupkg a .zip.

  3. Descomprima el paquete.

  4. Abra la carpeta streamjsonrpc.1.5.43/lib/netstandard1.1/.

  5. Copie el archivo StreamJsonRpc.dll en las siguientes ubicaciones de la carpeta del Explorador de Storage:

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

El botón "Abrir en el Explorador" en Azure Portal no funciona

Si no funciona el botón Abrir en el Explorador de Azure Portal, asegúrese de que usa un explorador compatible. Se ha probado la compatibilidad de los siguientes exploradores:

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

Recopilación de registros

Al notificar un problema en GitHub, es posible que se le pida que recopile determinados registros para ayudar a diagnosticar el problema.

Registros del Explorador de Storage

El Explorador de Storage registra varias cosas en sus propios registros de aplicación. Puede acceder fácilmente a estos registros; para ello, seleccione Help>Open Logs Directory (Ayuda > Abrir directorio de registros). De manera predeterminada, el Explorador de Storage registra con un nivel de detalle bajo. Para cambiar el nivel de detalle, vaya a Settings (el símbolo de engranaje de la izquierda) >Application>Logging>Log Level (Configuración > Aplicación > Registro > Nivel de registro). Después, puede establecer el nivel de registro según sea necesario. Para solucionar problemas, se recomienda el nivel de registro de seguimiento, ya que es el nivel más detallado.

Los registros se dividen en carpetas para cada sesión del Explorador de Storage que ejecute. Para los archivos de registro que necesite compartir, colóquelos en un archivo ZIP, con los archivos de las diferentes sesiones en carpetas diferentes.

Registros de autenticación

Para problemas relacionados con el inicio de sesión o la biblioteca de autenticación de Explorador de Storage, lo más probable es que necesite recopilar registros de autenticación. Los registros de autenticación se almacenan en:

  • Windows: C:\Usuarios\<nombre_de_usuario>\AppData\Local\Temp\servicehub\logs
  • macOS: ~/.ServiceHub/logs
  • Linux: ~/.ServiceHub/logs

Por lo general, puede seguir estos pasos para recopilar los registros:

  1. Vaya a Settings (el símbolo de engranaje de la izquierda) >Application>Sign-in (Configuración > Aplicación > Inicio de sesión). Seleccione Verbose Authentication Logging (Registro de autenticación detallado). Si Explorador de Storage no se puede iniciar debido a un problema con su biblioteca de autenticación, este paso se realiza automáticamente.
  2. Cierre el Explorador de Storage.
  3. Opcional recomendado: borre los registros existentes de la carpeta logs. Este paso reduce la cantidad de información que tiene que enviarnos.
  4. Abra el Explorador de Storage y reproduzca el problema.
  5. Cierre el Explorador de Storage.
  6. Comprima en formato ZIP el contenido de la carpeta logs.

Registros de AzCopy

Si tiene problemas para transferir datos, es posible que tenga que obtener los registros de AzCopy. Los registros de AzCopy se pueden encontrar fácilmente mediante dos métodos diferentes:

  • En el caso de las transferencias con errores que aún están en el registro de actividad, haga clic en Ir al archivo de registro de AzCopy.

  • Para las transferencias que no se realizaron en el pasado, vaya a la carpeta de registros de AzCopy. Esta carpeta se puede encontrar en:

    • Windows: C:\Usuarios\<nombre_de_usuario>\.azcopy
    • macOS: ~/.azcopy
    • Linux: ~/.azcopy

Registros de red

Para algunos problemas, debe proporcionar registros de las llamadas de red realizadas por Explorador de Storage. En Windows, puede obtener registros de red mediante Fiddler.

Nota:

Los seguimientos de Fiddler pueden contener contraseñas que haya escrito o enviado en el explorador durante la recopilación del seguimiento. Asegúrese de leer las instrucciones sobre cómo sanear un seguimiento de Fiddler. No cargue los seguimientos de Fiddler en GitHub. Se le indicará dónde puede enviar de forma segura el seguimiento de Fiddler.

Parte 1: Instalación y configuración de Fiddler

  1. Instale Fiddler.
  2. Inicie Fiddler.
  3. Vaya a Tools>Options (Herramientas > Opciones).
  4. Seleccione la pestaña HTTPS.
  5. Asegúrese de que estén seleccionadas las opciones Capture CONNECTs (Capturar conexiones) y Decrypt HTTPS traffic (Descifrar el tráfico HTTPS).
  6. Seleccione Actions (Acciones).
  7. Seleccione Certificado raíz de confianza y, a continuación, seleccione Sí en el cuadro de diálogo siguiente.
  8. Inicie el Explorador de Storage.
  9. Vaya a Configuración (símbolo de engranaje a la izquierda) >Proxy de aplicación>.
  10. Cambie la lista desplegable origen del proxy a Usar proxy del sistema (versión preliminar).
  11. Reinicie el Explorador de Storage.
  12. Debería empezar a ver que las llamadas de red del proceso storageexplorer: se muestran en Fiddler.

Parte 2: Reproducción del problema

  1. Cierre todas las aplicaciones que no sean Fiddler.
  2. Borre el registro de Fiddler mediante la X en la esquina superior izquierda, cerca del menú Ver .
  3. Opcional recomendado: deje que Fiddler se establezca durante unos minutos. Si ve que aparecen llamadas de red que no están relacionadas con el Explorador de Storage, haga clic con el botón derecho en ellas y seleccione Filter Now>Hide <process name> (Filtrar ahora > Ocultar [nombre de proceso]).
  4. Inicie/reinicie el Explorador de Storage.
  5. Reproduzca el problema.
  6. Seleccione File>Save>All Sessions (Archivo > Guardar > Todas las sesiones). Guárdelo en un lugar que recuerde.
  7. Cierre Fiddler y el Explorador de Storage.

Parte 3: Saneamiento del seguimiento de Fiddler

  1. Haga doble clic en el seguimiento de Fiddler (archivo .saz).
  2. Seleccione Ctrl + F.
  3. En el cuadro de diálogo que aparece, asegúrese de que se establecen las siguientes opciones: Buscar = solicitudes y respuestas y Examinar = encabezados y cuerpos.
  4. Busque las contraseñas que usó mientras recopilaba el seguimiento de Fiddler y las entradas resaltadas. Haga clic con el botón derecho y seleccione Remove>Selected sessions (Quitar > Sesiones seleccionadas).
  5. Si definitivamente ha escrito contraseñas en el explorador mientras recopiló el seguimiento, pero no encuentra ninguna entrada al usar Ctrl + F, no desea cambiar las contraseñas, o si las contraseñas que usó se usan para otras cuentas, omita enviarnos el archivo .saz.
  6. Vuelva a guardar el seguimiento con un nuevo nombre.
  7. Opcional: elimine el seguimiento original.

Pasos siguientes

Si ninguna de estas soluciones funciona para usted, use uno de los métodos siguientes:

Aviso de declinación de responsabilidades sobre la información de terceros

Los productos de otros fabricantes que se mencionan en este artículo han sido creados por compañías independientes de Microsoft. Microsoft no ofrece ninguna garantía, ya sea implícita o de otro tipo, sobre la confiabilidad o el rendimiento de dichos productos.

Ponte en contacto con nosotros para obtener ayuda

Si tiene preguntas o necesita ayuda, cree una solicitud de soporte o busque consejo en la comunidad de Azure. También puede enviar comentarios sobre el producto con los comentarios de la comunidad de Azure.