Explorador de Azure Storage guía de solución de problemas
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 datos de Azure Storage en Windows, macOS y Linux. La aplicación puede conectarse a cuentas de almacenamiento hospedadas en Azure, nubes nacionales y Azure Stack.
En esta guía se resumen las soluciones para los problemas que se suelen ver en Explorador de Storage.
Problemas de permisos de RBAC de Azure
El control de acceso basado en rol de Azure (RBAC de Azure) permite una administración de acceso muy granular de los recursos de Azure mediante la combinación de conjuntos de permisos en roles. Estas son algunas estrategias para que RBAC de Azure funcione de forma óptima en Explorador de Storage.
Cómo acceder a mis recursos en Explorador de Storage?
Si tiene problemas para acceder a los recursos de almacenamiento a través de RBAC de Azure, es posible que no se le hayan asignado los roles adecuados. En las secciones siguientes se describen los permisos Explorador de Storage actualmente necesarios para acceder a los recursos de almacenamiento. Póngase en contacto con el administrador de la cuenta de Azure si no está seguro de que tiene los roles o permisos adecuados.
Problema de permisos "Read: List/Get Storage Account(s)"
Debe tener permiso para enumerar las cuentas de almacenamiento. Para obtener este permiso, se le debe asignar el rol Lector.
Enumeración de claves de cuenta de almacenamiento
Explorador de Storage también puede usar claves de cuenta para autenticar solicitudes. Puede obtener acceso a las claves de cuenta a través de roles más eficaces, como el rol Colaborador.
Nota:
Las claves de acceso conceden permisos sin restricciones a cualquier persona que las contenga. Como resultado, no se recomienda que entregue estas claves a los usuarios de la cuenta. Si necesita revocar las claves de acceso, puede volver a generarlas desde el Azure Portal.
Roles de datos
Debe tener 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é necesito un rol de capa de administración para ver mis recursos en Explorador de Storage?
Azure Storage tiene dos niveles de acceso: administración y datos. Se accede a las suscripciones y a las cuentas de almacenamiento a través de la capa de administración. Se accede a los contenedores, blobs y otros recursos de datos a través de la capa de datos. Por ejemplo, si desea obtener una lista de las cuentas de almacenamiento de Azure, envíe una solicitud al punto de conexión de administración. Si desea una lista de contenedores de blobs en una cuenta, envíe una solicitud al punto de conexión de servicio adecuado.
Los roles de Azure pueden concederle permisos para la administración o el acceso a la capa de datos. El rol Lector, por ejemplo, concede acceso de solo lectura a los recursos de la capa de administración.
En términos estrictos, el rol Lector no proporciona permisos de capa de datos y no es necesario para acceder a la capa de datos.
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, Explorador de Storage envía una solicitud de "contenedores de lista" al punto de conexión de Blob Service. Para obtener ese punto de conexión, Explorador de Storage busca en la lista de suscripciones y cuentas de almacenamiento a las que tiene acceso. Para buscar las suscripciones y las cuentas de almacenamiento, Explorador de Storage también necesita acceso a la capa de administración.
Si no tiene un rol que conceda permisos de capa de administración, Explorador de Storage no puede obtener la información que necesita para conectarse a la capa de datos.
¿Qué ocurre si no puedo obtener los permisos de la capa de administración que necesito de mi administrador?
Si desea acceder a contenedores de blobs, Azure Data Lake Storage Gen2 contenedores, directorios o colas, puede asociarlos a esos recursos mediante sus credenciales de Azure.
- Abra el cuadro de diálogo Conectar .
- Seleccione el tipo de recurso al que desea conectarse.
- Seleccione Iniciar sesión con Microsoft Entra ID>Siguiente.
- Seleccione la cuenta de usuario y el inquilino asociados al recurso al que se va a asociar y, a continuación, seleccione Siguiente.
- Escriba la dirección URL del recurso y, a continuación, escriba un nombre para mostrar único para la conexión. Seleccione Siguiente>conexión.
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:
- Abra el cuadro de diálogo Conectar .
- Seleccione el tipo de recurso al que desea conectarse.
- Seleccione Firma de acceso compartido (SAS)>Siguiente.
- 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>conexión.
Para obtener más información sobre cómo asociar a recursos, vea Asociar a un recurso individual.
Roles integrados recomendados de Azure
Varios roles integrados de Azure pueden proporcionar los permisos necesarios para usar Explorador de Storage. Algunos de esos roles son:
- Propietario: administre todo, incluido el acceso a los recursos.
- Colaborador: administre todo, excepto el acceso a los recursos.
- Lector: leer y enumerar recursos.
- Colaborador de la cuenta de almacenamiento: administración completa de cuentas de almacenamiento.
- Propietario de datos de Storage Blob: acceso completo a los datos y contenedores de blobs de Azure Storage.
- Colaborador de datos de Storage Blob: lectura, escritura y eliminación de contenedores y blobs de Azure Storage.
- Lector de datos de Storage Blob: lea y enumere los contenedores y blobs de Azure Storage.
Nota:
Los roles Propietario, Colaborador y Colaborador de cuenta de almacenamiento conceden acceso a la clave de la cuenta.
Problemas de certificado SSL
En esta sección se describen los problemas del certificado SSL.
Descripción de los problemas del certificado SSL
Asegúrese de leer la sección Certificados SSL en la documentación de redes Explorador de Storage antes de continuar.
Uso del proxy del sistema
Si solo usa características que admiten la configuración de proxy del sistema de uso , pruebe a usar esa configuración. Para obtener más información sobre la configuración del proxy del sistema, consulte Conexiones de red en Explorador de Storage.
Importación de certificados SSL
Si tiene una copia de los certificados autofirmados, puede indicar a Explorador de Storage que confíen en ellos:
- Obtenga una copia X.509 (.cer) codificada en Base 64 del certificado.
- Vaya a Edición> decertificados> SSLImportar certificados. A continuación, use el selector de archivos para buscar, seleccionar y abrir el archivo .cer.
Este problema también puede producirse 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, pida ayuda al administrador de TI.
Siga estos pasos para encontrarlos:
Instale OpenSSL:
- Windows: cualquiera de las versiones ligeras debe ser suficiente.
- Mac: OpenSSL debe incluirse con el sistema operativo.
- Linux: OpenSSL debe incluirse con el sistema operativo.
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.
Ejecute el comando
openssl s_client -showcerts -connect <hostname>:443
para cualquiera de los nombres de host de Microsoft o Azure de los que están detrás los recursos de almacenamiento. Para obtener más información, consulte esta lista de nombres de host a los que se accede con frecuencia por Explorador de Storage.Busque certificados autofirmados. Si el firmante
("s:")
y el emisor("i:")
son los mismos, lo más probable es que el certificado se autofirme.Cuando encuentre los certificados autofirmados, copie y pegue todo de
-----BEGIN CERTIFICATE-----
a-----END CERTIFICATE-----
en un nuevo archivo .cer.Abra Explorador de Storage y vaya a Editar>certificados> SSLImportar certificados. A continuación, use el selector de archivos para buscar, seleccionar y abrir los archivos .cer que creó.
Deshabilitación de la validación de certificados SSL
Si no encuentra ningún certificado autofirmado siguiendo estos pasos, póngase en contacto con nosotros a través de la herramienta de comentarios. También puede abrir Explorador de Storage desde la línea de comandos con la --ignore-certificate-errors
marca . Cuando se abre con esta marca, Explorador de Storage omite los errores de certificado.
No se recomienda esta marca.
Problemas de inicio de sesión
En esta sección se describen los problemas de inicio de sesión que puede encontrar.
Descripción del inicio de sesión
Asegúrese de leer la documentación de Inicio de sesión en Explorador de Storage antes de continuar.
Tener que volver a escribir credenciales con frecuencia
Es muy probable que tener que volver a escribir las credenciales sea el resultado de las directivas de acceso condicional establecidas por el administrador de Microsoft Entra. Cuando Explorador de Storage le pida que vuelva a escribir las credenciales en el panel de la cuenta, debería ver un vínculo Detalles del error. Selecciónela para ver por qué Explorador de Storage le pide 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 acceder.
- El administrador ha realizado un cambio de configuración.
Para reducir la frecuencia de tener que volver a escribir credenciales debido a errores como los anteriores, póngase en contacto con el administrador de Microsoft Entra.
Directivas de acceso condicional
Si tiene directivas de acceso condicional que deben cumplirse para su cuenta, asegúrese de que usa el valor de Explorador web predeterminado para la configuración Iniciar sesión con . Para obtener información sobre esa configuración, consulte Cambiar dónde se produce el inicio de sesión.
El explorador se queja de la redirección HTTP o la 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 la redirección se realiza con HTTP en lugar de HTTPS. Es posible que algunos exploradores también intenten forzar que el redireccionamiento se realice con HTTPS. Si se produce cualquiera de estos problemas, en función del explorador, tiene opciones:
- Omita la advertencia.
- Agregue una excepción para localhost.
- Deshabilite force 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 en el inicio de sesión integrado para evitar usar el explorador por completo.
No se puede adquirir el token, el inquilino se filtra
En ocasiones, es posible que vea un mensaje de error que indica que no se puede adquirir un token porque se filtra un inquilino. Esto significa que está intentando acceder a un recurso que se encuentra en un inquilino que filtró. Para incluir el inquilino, vaya al Panel de cuentas. Asegúrese de que está activada la casilla del inquilino especificado en el error. Para obtener más información sobre el filtrado de inquilinos en Explorador de Storage, consulte Administración de cuentas.
No se pudo iniciar correctamente la biblioteca de autenticación
Si, al iniciarse, aparece 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:
- El sistema operativo.
- Qué versión de Explorador de Storage está intentando usar.
- Si ha comprobado los requisitos previos.
- Registros de autenticación desde un inicio incorrecto de 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 al usar el inicio de sesión integrado
Si decide 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 suelen producirse cuando un servidor de Servicios de federación de Active Directory (AD FS) solicita a Explorador de Storage que realice una redirección no admitida por Electron.
Para cambiar a otro método de inicio de sesión, cambie la configuración Iniciar sesión con en Configuración>Inicio de sesión deaplicación>. Para obtener información sobre los diferentes tipos de métodos de inicio de sesión, vea Cambiar dónde se produce el inicio de sesión.
Bucle de reautenticación o cambio de UPN
Si está en un bucle de reautenticación o ha cambiado el UPN de una de sus cuentas, pruebe estos pasos:
- Abra Explorador de Storage.
- Vaya a Restablecimiento de ayuda>.
- Asegúrese de que al menos autenticación está seleccionada. Borre otros elementos que no desea restablecer.
- Seleccione Restablecer.
- Reinicie Explorador de Storage e intente iniciar sesión de nuevo.
Si sigue teniendo problemas después de realizar un restablecimiento, pruebe estos pasos:
- Abra Explorador de Storage.
- Quite todas las cuentas y cierre Explorador de Storage.
- Elimine . Carpeta IdentityService de la máquina. En Windows, la carpeta se encuentra en C:\users\<username>\AppData\Local. Para Mac y Linux, puede encontrar la carpeta en la raíz del directorio de usuario.
- Si ejecuta Mac o Linux, también debe eliminar la
Microsoft.Developer.IdentityService
entrada 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 se denomina normalmente Keyring, pero el nombre puede diferir en función de la distribución. - Reinicie Explorador de Storage e intente iniciar sesión de nuevo.
macOS: errores de cadena de claves o ninguna ventana de inicio de sesión
a veces, la cadena de claves de macOS puede entrar en un estado que provoca problemas para la biblioteca de autenticación de Explorador de Storage. Para sacar a Keychain de este estado, siga estos pasos:
Cierre Explorador de Storage.
Abra Llavero seleccionando Barraespaciadora de comandos + , escriba cadena de claves y seleccione Entrar.
Seleccione la cadena de claves de inicio de sesión .
Seleccione el candado para bloquear la cadena de claves. Una vez finalizado el proceso, el candado aparece bloqueado. Puede tardar unos segundos, en función de las aplicaciones que tenga abiertas.
Abra Explorador de Storage.
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 Permitir si Always Allow no está disponible.
Intente iniciar sesión.
Linux: no hay errores de ventana de aplicación ni administrador de contraseñas en el inicio
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 llavero predeterminado si no existe en el inicio. Sin embargo, en algunos casos, esto podría no ocurrir, lo que no da lugar a errores de ventana de aplicación o de servicio del administrador de contraseñas. Para resolver los problemas, establezca manualmente un conjunto de claves predeterminado.
Si usa Seahorse y no hay llaveros existentes, o quiere crear uno nuevo, siga estos pasos para crear un keyring predeterminado:
- Inicie la aplicación "Contraseñas y claves".
- Seleccione el botón "+" y, a continuación, seleccione Teclado de contraseña.
- Establezca un nombre y una contraseña para el nuevo keyring.
- Haga clic con el botón derecho en el nuevo teclado y seleccione Establecer como valor 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 comprobarlo, ejecute el siguiente comando:
snap connect storage-explorer:password-manager-service :password-manager-service
El explorador predeterminado no se abre
Si el explorador predeterminado no se abre al intentar iniciar sesión, pruebe todas las técnicas siguientes:
- Reinicie Explorador de Storage.
- Abra el explorador manualmente antes de empezar a iniciar sesión.
- Pruebe a usar el inicio de sesión integrado. Para obtener instrucciones, consulte Cambiar dónde se produce el inicio de sesión.
Otros problemas de inicio de sesión
Si no se aplica ninguna de las instrucciones anteriores al problema de inicio de sesión o si no resuelven el problema de inicio de sesión, abra un problema en GitHub.
Faltan suscripciones y 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 su cuenta tiene acceso a las suscripciones que espera. Para comprobar el acceso, inicie sesión en el portal del entorno de Azure que está intentando usar.
- Asegúrese de que ha iniciado sesión en el entorno de Azure correcto, como Azure, Azure China 21Vianet, Azure Alemania, Azure US Government o Custom Environment.
- Si está detrás de un servidor proxy, asegúrese de configurar el proxy de Explorador de Storage correctamente.
- Intente quitar y agregar de nuevo la cuenta.
- Si hay un vínculo "Más información" o "Detalles del error", compruebe qué mensajes de error se notifican para los inquilinos que producen errores. Si no está seguro de cómo responder a los mensajes de error, abra un problema 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, lo más probable es que el Administrador de credenciales de Windows esté lleno. Para dejar espacio en el Administrador de credenciales de Windows, siga estos pasos:
- Cierre Explorador de Storage.
- En el menú Inicio , busque Administrador de credenciales y ábralo.
- Vaya a Credenciales de Windows.
- En Credenciales genéricas, busque las entradas asociadas a los programas que ya no use y elimínelas. También puede buscar entradas como
azcopy/aadtoken/<some number>
y eliminar esas entradas.
Si el mensaje sigue apareciendo después de completar los pasos anteriores o si encuentra este mensaje en plataformas distintas de Windows, puede abrir un problema en GitHub.
No se puede quitar una cuenta de almacenamiento o un recurso adjuntos
Si no puede quitar una cuenta adjunta o un recurso de almacenamiento a través de la interfaz de usuario, puede eliminar manualmente todos los recursos adjuntos mediante la eliminación de las carpetas siguientes:
- Windows: %AppData%/StorageExplorer
- macOS: /Users/<your_name>/Library/Application Support/StorageExplorer
- Linux: ~/.config/StorageExplorer
Cierre Explorador de Storage antes de eliminar estas carpetas.
Nota:
Si alguna vez ha importado algún certificado SSL, realice una copia de seguridad del contenido del directorio certs . Más adelante, puede usar 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 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:
Explorador de Storage no admite archivos de configuración automática de proxy para configurar la configuración del proxy.
Comprobación de Explorador de Storage configuración del proxy
> La configuraciónde Proxy deproxy> de aplicación determina de qué Explorador de Storage de origen obtiene la configuración del proxy.
Si selecciona Usar variables de entorno, asegúrese de establecer las variables de HTTPS_PROXY
entorno o HTTP_PROXY
. Las variables de entorno distinguen mayúsculas de minúsculas, por lo que asegúrese de establecer las variables correctas. Si estas variables no están definidas o no son válidas, Explorador de Storage no usarán un proxy. Reinicie Explorador de Storage después de modificar las variables de entorno.
Si selecciona Usar configuración de proxy de aplicación, asegúrese de que la configuración del proxy en la aplicación sea correcta.
Pasos para diagnosticar problemas
Si sigue experimentando problemas, pruebe estos métodos de solución de problemas:
- Si puede conectarse a Internet sin usar el proxy, compruebe que Explorador de Storage funciona sin la configuración de proxy habilitada. Si Explorador de Storage se conecta correctamente, puede haber un problema con el servidor proxy. Trabaje con el administrador para identificar los problemas.
- Compruebe que otras aplicaciones que usan el servidor proxy funcionan según lo esperado.
- Compruebe que puede conectarse al portal para el entorno de Azure que está intentando usar.
- Compruebe que puede recibir respuestas de los puntos de conexión de servicio. Escriba una de las direcciones URL del punto de conexión en el explorador. Si puede conectarse, debe recibir una
InvalidQueryParameterValue
respuesta XML o similar. - Compruebe si otra persona que use Explorador de Storage con el mismo servidor proxy puede conectarse. Si es posible, es posible que tenga que ponerse en contacto con el administrador del servidor proxy.
Herramientas para diagnosticar problemas
Una herramienta de redes, como Fiddler, puede ayudarle a diagnosticar problemas.
- Configure la herramienta de red como un servidor proxy que se ejecuta 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.
- Compruebe el número de puerto usado por la herramienta de red.
- Configure Explorador de Storage configuración 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 parece que la herramienta de red no registra Explorador de Storage tráfico, pruebe a probar la herramienta con una aplicación diferente. 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. Recibirá una respuesta similar a la de este ejemplo 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 red solo muestra el tráfico de otras aplicaciones, es posible que tenga que ajustar la configuración del proxy en Explorador de Storage. De lo contrario, es posible que deba 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 tenga que ponerse en contacto con el administrador del servidor proxy para:
- Asegúrese de que el proxy no bloquea el tráfico a los puntos de conexión de recursos o de administración de Azure.
- Compruebe el protocolo de autenticación usado por el servidor proxy. Explorador de Storage solo admite protocolos de autenticación básicos. Explorador de Storage no admite servidores proxy NTLM.
Mensaje de error "No se puede recuperar elementos secundarios"
Si está conectado a Azure a través de un proxy, compruebe que la configuración del proxy es correcta.
Si el propietario de una suscripción o cuenta le ha concedido acceso a un recurso, compruebe que tiene permisos de lectura o enumerados para ese recurso.
La cadena de conexión no tiene valores de configuración completos
Si recibe este mensaje de error, es posible que no tenga los permisos necesarios para obtener las claves de la cuenta de almacenamiento. 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 almacenamiento y seleccione Abrir en el portal. A continuación, 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 de cuenta y una clave o una firma de acceso compartido de la cuenta y usarla para adjuntar la cuenta de almacenamiento.
Si ve las claves de cuenta, escriba un problema 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 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, intente eliminar y agregar de nuevo las conexiones locales dañadas:
Inicie Explorador de Storage. En el menú, vaya a Ayuda Para>alternar herramientas de desarrollo.
En la ventana abierta, en la pestaña Aplicación, vaya a Almacenamiento> localfile:// en el lado izquierdo.
En función del tipo de conexión con la que tenga un 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, como:
- Cuentas de almacenamiento
StorageExplorer_CustomConnections_Accounts_v1
- Contenedores de blob
StorageExplorer_CustomConnections_Blobs_v1
StorageExplorer_CustomConnections_Blobs_v2
- Recursos compartidos de archivos
StorageExplorer_CustomConnections_Files_v1
- Colas
StorageExplorer_CustomConnections_Queues_v1
- Tables
StorageExplorer_CustomConnections_Tables_v1
- Cuentas de almacenamiento
Después de guardar los nombres de conexión actuales, establezca el valor de 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.
- Desde un editor de texto, agregue cada nombre de conexión a Developer Tools. A continuación, compruebe si la conexión sigue funcionando.
- Si una conexión funciona correctamente, no está dañada; puedes dejarla allí sin problemas. Si una conexión no funciona, quite su valor de Herramientas de desarrollo y anote para que pueda agregarlo más adelante.
- Repita la operación hasta que haya examinado todas las conexiones.
Después de quitar los nombres de conexión, debe borrar los datos dañados. A continuación, puede volver a agregar las conexiones mediante los pasos de conexión estándar de Explorador de Storage.
- En el menú Inicio , busque Administrador de credenciales y ábralo.
- Vaya a Credenciales de Windows.
- En Credenciales genéricas, busque entradas que tengan la
<connection_type_key>/<corrupted_connection_name>
clave. Por ejemplo,StorageExplorer_CustomConnections_Accounts_v1/account1
. - Elimine y agregue estas conexiones.
Si sigue detectando este error después de ejecutar estos pasos, o si desea compartir lo que sospecha que ha dañado las conexiones, abra un problema en nuestra página de GitHub.
Problemas con una dirección URL de firma de acceso compartido
Si se conecta a un servicio a través de 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 la dirección URL no ha expirado.
- Si la dirección URL de firma de acceso compartido se basa en una directiva de acceso, compruebe que la directiva de acceso no se ha revocado.
Si se adjunta accidentalmente mediante una dirección URL de firma de acceso compartido no válida y ahora no se puede desasociar, siga estos pasos:
- Cuando ejecute Explorador de Storage, seleccione F12 para abrir la ventana Herramientas de desarrollo.
- En la pestaña Aplicación, seleccione Almacenamiento> localfile:// en el lado izquierdo.
- Busque la clave asociada al tipo de servicio del URI de firma de acceso compartido. Por ejemplo, si el URI de firma de acceso compartido incorrecto es para un contenedor de blobs, busque la clave denominada
StorageExplorer_AddStorageServiceSAS_v1_blob
. - El valor de la clave debe ser una matriz JSON. Busque el objeto asociado al URI incorrecto y elimínelo.
- Seleccione Ctrl +R para volver a cargar Explorador de Storage.
dependencias de Explorador de Storage
Explorador de Storage viene empaquetado con todas las dependencias que necesita para ejecutarse en Windows.
Revisión de Explorador de Storage para 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 usada por Explorador de Storage:
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.
Después de descargar el paquete, cambie su extensión de archivo de .nupkg a .zip.
Descomprima el paquete.
Abra la carpeta streamjsonrpc.1.5.43/lib/netstandard1.1/ .
Copie StreamJsonRpc.dll en las siguientes ubicaciones de la carpeta 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" del Azure Portal no funciona
Si el botón Abrir en el Explorador del 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 a GitHub, es posible que se le pida que recopile determinados registros para ayudar a diagnosticar el problema.
registros de Explorador de Storage
Explorador de Storage registra varios elementos en sus propios registros de aplicación. Para acceder fácilmente a estos registros, seleccione Ayuda>Para abrir el directorio de registros. De forma predeterminada, Explorador de Storage registros en un nivel bajo de detalle. Para cambiar el nivel de detalle, vaya a Configuración (el símbolo de engranaje de la izquierda) >Nivel>> deregistro de registro de aplicaciones. A continuación, 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 de Explorador de Storage que ejecute. Para los archivos de registro que necesite compartir, colóquelos en un archivo ZIP, con archivos de distintas 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 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:\Users\<your username>\AppData\Local\Temp\servicehub\logs
- macOS: ~/. ServiceHub/logs
- Linux: ~/. ServiceHub/logs
Por lo general, puede seguir estos pasos para recopilar los registros:
- Vaya a Configuración (el símbolo de engranaje de la izquierda) >Inicio de sesión dela aplicación>. Seleccione Registro de autenticación detallado. Si Explorador de Storage no se inicia debido a un problema con su biblioteca de autenticación, este paso se realiza automáticamente.
- Cierre Explorador de Storage.
- Opcional o recomendado: borre los registros existentes de la carpeta de registros . Este paso reduce la cantidad de información que tiene que enviarnos.
- Abra Explorador de Storage y reproduzca el problema.
- Cierre Explorador de Storage.
- Comprima el contenido de la carpeta de registros .
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 todavía están en el registro de actividad, seleccione Ir al archivo de registro de AzCopy.
Para las transferencias que no se pudieron realizar en el pasado, vaya a la carpeta de registros de AzCopy. Esta carpeta se puede encontrar en:
- Windows: C:\Users\<your username>\.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 escribió o envió 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 pedirá dónde puede enviar de forma segura el seguimiento de Fiddler.
Parte 1: Instalación y configuración de Fiddler
- Instale Fiddler.
- Inicie Fiddler.
- Vaya a Opciones de herramientas>.
- Seleccione la pestaña HTTPS .
- Asegúrese de que Capture CONNECTs (Capturar CONNECTs ) y Decrypt HTTPS traffic (Descifrar tráfico HTTPS ) estén seleccionados.
- Seleccione Acciones.
- Seleccione Confiar certificado raíz y, a continuación, seleccione Sí en el cuadro de diálogo siguiente.
- Inicie Explorador de Storage.
- Vaya a Configuración (el símbolo de engranaje de la izquierda) >Proxy de aplicación>.
- Cambie la lista desplegable de origen del proxy a Usar proxy del sistema (versión preliminar).
- Reinicie Explorador de Storage.
- Debería empezar a ver que las llamadas de red de un
storageexplorer:
proceso aparecen en Fiddler.
Parte 2: Reproducir el problema
- Cierre todas las aplicaciones que no sean Fiddler.
- Borre el registro de Fiddler con la X de la esquina superior izquierda, cerca del menú Ver .
- Opcional o recomendado: deje que Fiddler se establezca durante unos minutos. Si ve que aparecen llamadas de red que no están relacionadas con Explorador de Storage, haga clic con el botón derecho en ellas y seleccione Filtrar ahora>Ocultar <nombre> del proceso.
- Iniciar o reiniciar Explorador de Storage.
- Reproduzca el problema.
- SeleccioneGuardar>todas las sesiones en archivo>. Guárdelo en un lugar que no olvidará.
- Cierre Fiddler y Explorador de Storage.
Parte 3: Desinfección del seguimiento de Fiddler
- Haga doble clic en el seguimiento de Fiddler (archivo .saz).
- Seleccione Ctrl + F.
- En el cuadro de diálogo que aparece, asegúrese de que se establecen las siguientes opciones: Búsqueda = Requests and responses y ExamineHeaders and bodies(Examinar = encabezados y cuerpos).
- Búsqueda para las contraseñas que usó al recopilar el seguimiento de Fiddler y las entradas resaltadas. Haga clic con el botón derecho y seleccione Quitar>sesiones seleccionadas.
- Si definitivamente escribió contraseñas en el explorador mientras recopiló el seguimiento, pero no encuentra ninguna entrada al usar Ctrl + F, no quiere cambiar las contraseñas o si las contraseñas que usó se usan para otras cuentas, omita enviarnos el archivo .saz.
- Vuelva a guardar el seguimiento con un nuevo nombre.
- Opcional: elimine el seguimiento original.
Pasos siguientes
Si ninguna de estas soluciones funciona, use uno de los métodos siguientes:
Para abrir un problema en GitHub , seleccione el botón Notificar problema a GitHub en la esquina inferior izquierda.
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.