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

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 (RBAC) de Azure permite realizar una administración muy pormenorizada del acceso a los recursos de Azure mediante la combinación de conjuntos de permisos para formar 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. Por tanto, no se recomienda dar 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, necesitará tener, como mínimo, 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 ADLS 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 Azure Active Directory (Azure AD) . Seleccione Next (Siguiente).
  4. Seleccione la cuenta de usuario y el inquilino asociados al recurso al que los está adjuntando. Seleccione Next (Siguiente).
  5. Escriba la dirección URL del recurso y un nombre para mostrar único para la conexión. Seleccione Siguiente y luego Conectar.

Actualmente no tenemos una solución relacionada con RBAC de Azure para otros tipos de recursos. Como solución alternativa, puede solicitar una dirección URL de SAS y asociarla al recurso siguiendo estos pasos:

  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) de cuenta. Seleccione Next (Siguiente).
  4. Escriba la dirección URL de SAS que ha recibido y un nombre para mostrar único para la conexión. Seleccione Siguiente y luego Conectar.

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

Hay varios roles integrados de Azure que pueden proporcionar los permisos necesarios para usar el 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

Descripción de los problemas de certificados SSL

Asegúrese de que ha 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, debe intentar usar esa configuración. Puede leer más sobre la configuración del proxy del sistema aquí.

Importación de certificados SSL

Si tiene una copia de los certificados autofirmados, puede indicar al Explorador de Storage que confíe en ellos. Para ello, debe seguir estos pasos:

  1. Obtenga una copia X.509 codificado base 64 (.cer) del certificado.
  2. Vaya a Editar > Certificados SSL > Importar certificados y, luego, utilice el selector de archivos para encontrar, seleccionar y abrir el archivo .cer.

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

Búsqueda de certificados SSL

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

Puede intentar seguir estos pasos para encontrarlos:

  1. Instale OpenSSL.
    • Windows: cualquiera de las versiones ligeras debería ser suficiente.
    • Mac y Linux: debe estar incluido en el sistema operativo.
  2. Ejecute OpenSSL.
    • Windows: abra el directorio de instalación, seleccione /bin/ y, luego, haga doble clic en openssl.exe.
    • Mac y Linux: Ejecute openssl desde un terminal.
  3. Ejecute este comando: 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. Puede encontrar una lista de nombres de host a los que el Explorador de Storage accede con frecuencia aquí.
  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 certificados autofirmados, en cada uno de ellos, copie y pegue todo el contenido desde -----BEGIN CERTIFICATE----- hasta -----END CERTIFICATE----- (inclusive) en un archivo .cer nuevo.
  6. Abra el Explorador de Storage y vaya a Editar > Certificados SSL > Importar certificados. Luego, use el selector de archivos para encontrar, seleccionar y abrir los archivos .cer que creó.

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. No se recomienda esta marca.

Problemas de inicio de sesión

Información del inicio de sesión

Asegúrese de que ha leído la documentación del 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 probablemente el resultado de las directivas de acceso condicional que ha establecido el administrador de AAD. Cuando el Explorador de Storage le pida que vuelva a escribir las credenciales desde el panel de la cuenta, debería ver un vínculo denominado Detalles del error... . Haga clic en esta opción para ver por qué el Explorador de Storage le pide que vuelva a escribir las credenciales. Los errores de la directiva de acceso condicional que requieren volver a escribir las credenciales pueden tener un aspecto parecido al siguiente:

  • El token de actualización expiró...
  • Debe usar la autenticación multifactor para acceder a...
  • Debido a un cambio de configuración realizado por el administrador...

Para reducir la frecuencia de tener que volver a escribir las credenciales debido a errores como los anteriores, deberá hablar con el administrador de AAD.

Directivas de acceso condicional

Si tiene directivas de acceso condicional que deben cumplirse en la cuenta, asegúrese de que usa el valor Explorador web predeterminado en la opción 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 del redireccionamiento de HTTP durante el inicio de sesión

Cuando el Explorador de Storage inicia sesión en el explorador web, se realiza un redireccionamiento 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 ocurre alguna de estas opciones, en función del explorador, tiene una variedad de opciones:

  • Ignore la advertencia.
  • Agregue una excepción para localhost.
  • Deshabilite la opción para forzar HTTPS, ya sea globalmente o solo para localhost.

Si no puede realizar ninguna de esas opciones, también puede cambiar dónde se produce el inicio de sesión.

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

Si ve un mensaje de error que indica que no se puede adquirir un token porque un inquilino está filtrado, significa que está intentando acceder a un recurso que se encuentra en un inquilino que ha filtrado. Para quitar el filtro del inquilino, vaya al Panel de cuentas y asegúrese de que la casilla del inquilino especificado en el error esté activada. Consulte Administración de cuentas para obtener 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 en el inicio ve un mensaje de error que indica que la biblioteca de autenticación del 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 está intentando usar.
  • Si ya 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 ha elegido usar el inicio de sesión integrado y ve 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 Iniciar sesión con en Configuración > Aplicación > Iniciar 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 sus cuentas, siga estos pasos:

  1. Abra el Explorador de Storage.
  2. Vaya a Ayuda > Restablecer.
  3. Asegúrese de que al menos la opción Autenticación está activada. Puede desactivar otros elementos que no quiera restablecer.
  4. Haga clic en el botón 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:\users\<username>\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 de su 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 cadena de claves o sin ventana de inicio de sesión.

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

  1. Cierre el Explorador de Storage.

  2. Abra el llavero (presione Comando + barra espaciadora, escriba llavero y presione Entrar).

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

  4. Seleccione el icono de candado para cerrar el llavero (el candado aparecerá cerrado cuando se complete el proceso. Puede tardar unos segundos, en función de las aplicaciones que haya abiertas).

    Icono del candado

  5. Abra el Explorador de Storage.

  6. Aparece un mensaje similar a este: "Service hub wants to access the Keychain" (El Centro de servicios desea acceder al llavero). Escriba la contraseña de la cuenta de administrador de Mac y seleccione Permitir siempre (o Permitir si Permitir siempre no está disponible).

  7. Intente iniciar sesión.

El explorador predeterminado no se abre

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

  • Reinicio de Explorador de Storage
  • Abra el explorador manualmente antes de realizar el inicio de sesión.
  • Use el inicio de sesión integrado y consulte Cambiar dónde se produce el inicio de sesión para obtener instrucciones sobre cómo hacerlo.

Otros problemas de inicio de sesión

Si ninguna de las opciones anteriores se aplica a su problema de inicio de sesión o si no se puede resolver el problema de inicio de sesión, abra un problema 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 (Azure, Azure China 21Vianet, Azure Alemania, Azure US Government o entorno personalizado).
  • Si está detrás de un servidor proxy, asegúrese de que ha configurado correctamente el proxy del Explorador de Storage.
  • Pruebe a eliminar 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, no dude en 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/<your_name>/Library/Application Support/StorageExplorer
  • Linux: ~/.config/StorageExplorer

Nota

Cierre el Explorador de Storage antes de eliminar estas carpetas.

Nota

Si alguna vez ha importado un certificado 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 a través de un proxy, estas son algunas sugerencias.

Nota

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

El valor de Aplicación → Proxy → Configuración de proxy determina de qué origen el Explorador de Storage obtiene la configuración del proxy.

Si selecciona "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 mayúsculas de minúsculas, por lo que debe asegurarse 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 la configuración de proxy de aplicación), asegúrese de que la configuración del proxy de 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. Junto con el administrador identifique 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 respuesta InvalidQueryParameterValue o XML 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 red para conectarse a través del proxy.
  2. Compruebe el número de puerto utilizado por la herramienta de red.
  3. Configure los valores del proxy del Explorador de Storage para usar el host local y el número de puerto de la herramienta de red (por ejemplo, "localhost: 8888").

Cuando lo haya hecho correctamente, la herramienta de red registrará las solicitudes de red realizadas por el Explorador de Storage para puntos de conexión de servicio y administración.

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 de uno de los recursos de almacenamiento (como https://contoso.blob.core.windows.net/) en un explorador web y recibirá una respuesta similar a la siguiente:

Código de ejemplo

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

Si la herramienta de red solo muestra el tráfico de otras aplicaciones, es posible que necesite 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 una cuenta le concedió acceso a un recurso, compruebe que disponga de permisos de lectura o lista para dicho 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 confirmar si este es el motivo, vaya al portal y busque la cuenta de Storage. Para ello, haga clic con el botón derecho en el nodo de la cuenta de Storage y seleccione Abrir en el portal. Luego, vaya a la hoja Claves de acceso. Si no tiene permisos para ver las claves, verá el mensaje "You don't have access" (No tiene acceso). Para solucionar este problema, puede obtener la clave de cuenta de otra persona y asociarla mediante el nombre y la clave, o bien puede pedir una SAS para la cuenta de Storage y usarla para asociar la cuenta de Storage.

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

Error al agregar una nueva conexión: TypeError: no se puede leer la propiedad "version" de la conexión no definida

Si recibe este mensaje de error al intentar agregar una conexión personalizada, es posible que los datos de la 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, después, vuelva 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 abierta, en la pestaña Application (Aplicación), vaya a Local Storage (Almacenamiento local) (lado izquierdo) > file:// .
  3. En función del tipo de conexión con el que tenga un problema, busque su clave y copie su valor en un editor de texto. El valor es una matriz de los nombres de conexión personalizados parecida 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, en Herramientas de desarrollo seleccione [].

Si desea conservar las conexiones que no estén dañadas, puede usar los siguientes pasos para buscar las conexiones dañadas. Si no le importa perder todas las conexiones existentes, puede omitir estos pasos y seguir las instrucciones específicas de la plataforma para borrar los datos de la conexión.

  1. En un editor de texto, vuelva a agregar los nombres de conexión a Herramientas de desarrollo y compruebe si la conexión sigue funcionando.
  2. Si una conexión funciona correctamente, no está dañada y se puede dejar ahí sin ningún riesgo. Si una conexión no funciona, quite su valor de Herramientas de desarrollo y guárdelo para poder volver a agregarlo más adelante.
  3. Repita el procedimiento hasta que haya examinado todas las conexiones.

Después de recorrer todas las conexiones, en busca de todos los nombres de conexión que no se han agregado de nuevo, debe borrar los datos dañados (si los hay) y volver a agregarlos mediante los pasos estándar del 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> (por ejemplo, StorageExplorer_CustomConnections_Accounts_v1/account1).
  4. Elimine estas entradas y vuelva a agregar las 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 la URL de SAS

Si se va conectar a un servicio mediante una dirección URL de SAS y se produce este error:

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

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

  1. Al ejecutar el Explorador de Storage, presione F12 para abrir la ventana Herramientas de desarrollo.
  2. En la pestaña Aplicación, seleccione Almacenamiento local > file:// en el árbol de la izquierda.
  3. Busque la clave asociada al tipo de servicio del URI de SAS problemática. Por ejemplo, si el identificador URI de SAS 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. Presione Ctrl + R para volver a cargar el Explorador de Storage.

Dependencias de Linux

Ajustar

Tanto el Explorador de Storage 1.10.0 como las versiones posteriores en forma de complemento están disponibles en Snap Store. El complemento de Explorador de Storage instala automáticamente todas sus dependencias y se actualiza cuando hay una nueva versión del complemento disponible. La instalación del complemento de Explorador de Storage es el método recomendado de instalación.

El Explorador de Storage requiere el uso de un administrador de contraseñas, que puede que se necesite para establecer una conexión manualmente para que el Explorador de Storage funcione correctamente. Puede conectar el Explorador de Storage al administrador de contraseñas del sistema mediante la ejecución del siguiente comando:

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

Archivo .tar.gz

También puede descargar la aplicación en forma de archivo .tar.gz, pero tendrá que instalar las dependencias manualmente.

El Explorador de Storage tal y como se proporciona en la descarga .tar.gz solo es compatible con las siguientes versiones de Ubuntu. Es posible que el Explorador de Storage funcione en otras distribuciones de Linux, pero no se admiten oficialmente.

  • Ubuntu 20.04 x64
  • Ubuntu 18.04 x64
  • Ubuntu 16.04 x64

El Explorador de Storage requiere que .NET Core 3.1 esté instalado en el sistema.

Nota

Las versiones 1.8.0 a 1.20.1 del Explorador de Storage requieren .NET Core 2.1. La versión 1.7.0 del Explorador de Storage y anteriores requieren .NET Core 2.0.

  1. Descargue el archivo .tar.gz del Explorador de Storage.

  2. Instale el entorno de ejecución de .NET Core:

    wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb; \
  sudo dpkg -i packages-microsoft-prod.deb; \
  sudo apt-get update; \
  sudo apt-get install -y apt-transport-https && \
  sudo apt-get update && \
  sudo apt-get install -y dotnet-runtime-3.1

Muchas de las bibliotecas que necesita el Explorador de Storage viene preinstaladas con las instalaciones estándar de Canonical de Ubuntu. Es posible que falten algunas de estas bibliotecas en los entornos personalizados. Si tiene problemas para iniciar el Explorador de Storage, se recomienda que se asegure de que los siguientes paquetes están instalados en el sistema:

  • iproute2
  • libasound2
  • libatm1
  • libgconf2-4
  • libnspr4
  • libnss3
  • libpulse0
  • libsecret-1-0
  • libx11-xcb1
  • libxss1
  • libxtables11
  • libxtst6
  • xdg-utils

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

En el caso del Explorador de Storage 1.7.0, u otras versiones anteriores, es posible que tenga que aplicar un parche a la versión de .NET Core que usa el Explorador de Storage:

  1. Descargue la versión 1.5.43 de StreamJsonRpc de NuGet. Busque el vínculo "Descargar paquete" en el lado derecho de la página.
  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 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/

"Abrir en el Explorador", de Azure Portal, no funciona

Si el botón Abrir en el Explorador de Azure Portal no funciona, 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

A partir de la versión 1.16.0, el Explorador de Storage registra varias cosas en sus propios registros de aplicación. Puede acceder fácilmente a estos registros mediante un clic en 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, agregue una variable de entorno con el nombre STG_EX_LOG_LEVEL y cualquiera de los valores siguientes:

  • silent
  • critical
  • error
  • warning
  • info (nivel predeterminado)
  • verbose
  • debug

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

Registros de autenticación

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

  • Windows: C:\Users\<your username>\AppData\Local\Temp\servicehub\logs
  • macOS y Linux: ~/.ServiceHub/logs

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

  1. Vaya a Configuración (icono de engranaje de la izquierda) > Aplicación > Inicio de sesión > active Registro de autenticación detallada. Si el Explorador de Storage no se puede iniciar debido a un problema con la biblioteca de autenticación, esto se hará automáticamente.
  2. Cierre el Explorador de Storage.
  3. Opcional recomendado: borre los registros existentes de la carpeta logs. Al hacerlo, se reducirá 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:\Users\<your username>\.azcopy
    • macOS y Linux : `~/.azcopy

Registros de red

Para algunos problemas, deberá proporcionar los registros de las llamadas de red realizadas por el Explorador de Storage. En Windows, puede hacerlo 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 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. Haga clic en la pestaña HTTPS.
  5. Asegúrese de que Capture CONNECTs (Capturar conexiones) y Decrypt HTTPS traffic (Descifrar tráfico HTTPS) estén activados.
  6. Haga clic en el botón "Actions" (Acciones).
  7. Elija "Trust Root Certificate" (Confiar en el certificado raíz) y luego "Yes" (Sí) en el cuadro de diálogo siguiente.
  8. Haga clic de nuevo en el botón "Actions" (Acciones).
  9. Elija "Export Root Certificate to Desktop" (Exportar el certificado raíz al escritorio).
  10. Vaya al escritorio.
  11. Busque el archivo FiddlerRoot.cer.
  12. Haga doble clic para abrirlo.
  13. Vaya a la pestaña "Detalles".
  14. Haga clic en "Copiar en archivo...".
  15. En el asistente para exportación, elija las siguientes opciones.
    • X.509 codificado en Base 64
    • Para el nombre de archivo, vaya a Examinar... C:\Users\<your user dir>\AppData\Roaming\StorageExplorer\certs y después puede guardarlo con cualquier nombre de archivo.
  16. Cierre la ventana del certificado.
  17. Inicie el Explorador de Storage.
  18. Vaya a Edit > Configure Proxy (Editar > Configurar proxy).
  19. En el cuadro de diálogo, elija "Use app proxy settings" (Usar configuración de proxy de la aplicación) y establezca la dirección URL en http://localhost y el puerto en 8888.
  20. Haga clic en Aceptar.
  21. Reinicio de Explorador de Storage
  22. 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 (icono de X en la parte 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 son del Explorador de Storage, haga clic con el botón derecho en ellas y elija "Filtrar ahora" > "Ocultar (nombre del proceso)".
  4. Inicie el Explorador de Storage.
  5. Reproduzca el problema
  6. Haga clic en File > Save > All Sessions… (Archivo > Guardar > Todas las sesiones), para guardar la información en algún 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. Pulse ctrl+f.
  3. En el cuadro de diálogo que aparece, asegúrese de que están establecidas las siguientes opciones: Buscar = Solicitudes y respuestas, Examinar = Encabezados y cuerpos
  4. Busque las contraseñas que usó al recopilar el seguimiento de Fiddler, las entradas resaltadas, haga clic con el botón derecho y elija Remove > Selected sessions (Quitar > Sesiones seleccionadas).
  5. Si definitivamente ha escrito contraseñas en el explorador al recopilar el seguimiento, pero no encuentra ninguna entrada al usar ctrl+F y no desea cambiar las contraseñas o las contraseñas se usan para otras cuentas, no dude en omitir el envío del archivo .saz. Es mejor estar seguro que arrepentido. :)
  6. Vuelva a guardar el seguimiento con un nuevo nombre.
  7. Opcional: elimine el seguimiento original.

Pasos siguientes

Si ninguna de estas soluciones funciona, puede hacer lo siguiente:

  • Creación de una incidencia de soporte técnico
  • Abrir una incidencia en GitHub. Para ello, seleccione el botón Report issue to GitHub (Informar de problema a GitHub), que se encuentra en la esquina inferior izquierda.

Comentarios