Inicio de sesión de ArcGIS y el proxy
Icon Map Slicer no necesita claves de API para sus propios mapas base. Las únicas credenciales que usa son las de ArcGIS. Esta página explica adónde van esas credenciales, cómo se guardan y qué hace el proxy de Icon Map cuando un servidor no permite que Power BI lo lea.
La tarjeta Autenticación de ArcGIS
La tarjeta Autenticación de ArcGIS define cómo se conecta el mapa a ArcGIS Online o ArcGIS Enterprise. No siempre está en el panel Formato: aparece cuando el mapa usa ArcGIS, es decir, en cualquiera de estos casos:
- Capa de fondo > Origen del mapa es ArcGIS.
- Una lista de mapas base creada en el cuadro de diálogo Mapas base contiene un mapa base o un mapa web de ArcGIS.
- Hay una capa de referencia de ArcGIS activada (Capas de referencia > Capa de ArcGIS - configuración inicial).
- La capa de datos de ArcGIS está activada (Capas de datos > Capa de ArcGIS).
- Sombreado del relieve o Terreno 3D lee un servicio de elevación de ArcGIS.
- Tipo de autenticación ya está establecido en Iniciar sesión con ArcGIS.
La guía completa, con los pasos de cada método, es Conectar con ArcGIS. En resumen:
| Tipo de autenticación | Quién inicia sesión | Qué se guarda en el informe |
|---|---|---|
| Clave de API | Nadie | La clave de API |
| OAuth2 (ID de cliente y secreto) | Nadie. Se conecta una aplicación registrada en la organización de ArcGIS | El ID de cliente y, en forma protegida, el Secreto de cliente |
| Nombre de usuario y contraseña | Cada persona, en una ventana de inicio de sesión de Power BI | Nada. La sesión se conserva en el almacenamiento local del objeto visual en el dispositivo de esa persona |
| Iniciar sesión con ArcGIS | Cada persona, en una pestaña del explorador | Nada. La sesión se conserva en el almacenamiento local del objeto visual en el dispositivo de esa persona |
Con Iniciar sesión con ArcGIS, la página de inicio de sesión de ArcGIS se abre en una pestaña del explorador. Un servicio de retransmisión en api.iconmap.ai devuelve el resultado del inicio de sesión al objeto visual, y el objeto visual lo intercambia después por un token directamente con el portal. El token no se envía a Icon Map.
Enviar la credencial como define cómo viaja la credencial hasta ArcGIS: Parámetro de URL (predeterminado) o Encabezado de autorización (Bearer). Déjelo en Parámetro de URL salvo que el servidor lo rechace. ArcGIS Enterprise 11.5 y versiones posteriores pueden rechazar las claves de API más recientes en la URL con "Invalid Token". Esos servidores necesitan la opción Encabezado de autorización y deben permitir el encabezado Authorization en su configuración de CORS.
Sin ninguna credencial, el contenido de ArcGIS se lee como contenido público.
Probar conexión comprueba el portal, la credencial y todas las capas de ArcGIS del mapa, y explica cualquier error.
Cómo se guardan las credenciales
- Una clave de API de ArcGIS se guarda en el informe como un ajuste normal. Cualquier persona que pueda editar el informe puede leerla, y el objeto visual la envía a ArcGIS con cada solicitud. Restrinja la clave en ArcGIS a los servicios que usa el mapa.
- El Secreto de cliente de ArcGIS se guarda en forma protegida y se muestra como puntos después de introducirlo.
- Las sesiones de un inicio de sesión personal en ArcGIS se conservan en el almacenamiento local del objeto visual en el dispositivo del lector, no en el informe. Para ello se usa el privilegio opcional de almacenamiento local, por lo que el inquilino de Power BI debe permitir el almacenamiento local para los objetos visuales personalizados. Sin él, las personas tienen que iniciar sesión con más frecuencia.
- La clave de licencia de Icon Map, cuando se usa una, se guarda en el informe en Icon Map Slicer > Clave de licencia (para licencias no basadas en usuario). Consulte Claves de licencia y activación.
El proxy
Por qué existe un proxy
Power BI ejecuta cada objeto visual personalizado en un marco aislado. Un servidor web debe permitir explícitamente las solicitudes de ese marco, mediante encabezados CORS, para que el objeto visual pueda leer su respuesta. La mayoría de los servicios de mapas públicos lo hacen. Algunos servidores no, normalmente los servidores de ArcGIS Enterprise y algunos servidores de teselas, GeoJSON y WFS. Una capa de un servidor así se queda en blanco, aunque el mismo vínculo se abra en un explorador.
La solución que mantiene todo bajo su control es permitir CORS en su servidor. Cuando no es posible, el proxy de Icon Map puede obtener el recurso en nombre del objeto visual y devolverlo con los encabezados que Power BI necesita.
El proxy es un servicio de retransmisión que Icon Map ejecuta en proxy.icon-map.com. Está desactivado de forma predeterminada. Requiere una clave de licencia de Icon Map, y las solicitudes que pasan por el proxy pueden consumir créditos de uso adicionales.
Cuándo se usa el proxy
El ajuste se llama Usar el proxy cuando sea necesario y funciona como indica su nombre:
- Primero se intenta acceder directamente a cada servidor.
- Solo se obtiene a través del proxy un servidor que, según se ha detectado, no permite Power BI. Esto se aplica a la solicitud que detectó el bloqueo y a las solicitudes posteriores a ese servidor en la misma sesión. Las teselas y las imágenes del mapa siguen la misma regla.
- Los servidores que permiten Power BI nunca pasan por el proxy, aunque el conmutador esté activado.
El proxy se puede activar en estos lugares:
| Dónde | Se aplica a |
|---|---|
| Autenticación de ArcGIS > Usar el proxy cuando sea necesario | Todas las solicitudes a ArcGIS que hace el mapa, incluidos los mapas base, los mapas web y la elevación de ArcGIS |
| El cuadro de diálogo Examinar ArcGIS, con su botón Usar el proxy CORS cuando se detecta un servidor bloqueado | El mismo conmutador que el anterior |
| El Administrador de capas, al añadir una capa de archivo mediante un vínculo (GeoJSON, KML, CSV o WFS) cuando la comprobación del vínculo detecta que el servidor bloquea Power BI: marque Leerlo a través del proxy CORS de Icon Map (solo para servidores de confianza) | El vínculo de esa capa |
| El Administrador de capas, al añadir una capa de teselas ráster cuando la comprobación del vínculo detecta que el servidor bloquea Power BI: la misma casilla | Las teselas de esa capa |
| El Administrador de capas, en el editor de una capa de archivo o de teselas ráster que ya ha añadido: Usar el proxy cuando sea necesario, en su sección Origen | Esa capa |
Cuando se detecta que hay servidores de ArcGIS bloqueados, la explicación situada bajo el conmutador de ArcGIS los nombra: "Estos servidores de ArcGIS bloquearon solicitudes de Power BI: ...".
La opción de proxy de una capa de archivo o ráster se elige en el Administrador de capas: la casilla al añadir la capa y, después, Usar el proxy cuando sea necesario en su editor. Los grupos del panel Formato de esas capas no tienen un conmutador de proxy.
Las capas de referencia WMS no tienen opción de proxy, y el Administrador de capas no ofrece ninguna al añadir una capa WMS. Tampoco la tienen los mapas base de un servidor de teselas, un WMS o un vínculo de estilo, salvo que el mismo servidor lo use también una capa que tenga el proxy activado.
Qué se envía al proxy
No se envía nada al proxy a menos que una opción de proxy esté activada y se haya detectado que un servidor bloquea Power BI.
Para abrir una sesión, el objeto visual envía:
- la clave de licencia de Icon Map de la tarjeta Icon Map Slicer
- el entorno en el que se ejecuta el informe (por ejemplo, Power BI Desktop, el servicio Power BI o Power BI Embedded)
- el nombre del producto, IconMapSlicer
- la Referencia opcional de la tarjeta Icon Map Slicer
- el identificador de instancia del objeto visual y un identificador de sesión
El proxy responde con un token de sesión de corta duración, que el objeto visual reutiliza hasta poco antes de que caduque.
Para cada solicitud que pasa por el proxy, el objeto visual envía:
- la dirección completa del recurso, incluida su cadena de consulta. Un token o una clave que formen parte de la dirección viajan con ella
- el token de sesión
- los encabezados de solicitud adicionales que necesite el servidor, por ejemplo un encabezado de autorización
El proxy hace la solicitud al servidor y devuelve la respuesta, incluido el contenido binario, como las teselas.
Qué significa esto:
- El servicio de proxy ve la dirección de cada solicitud que pasa por él, cualquier credencial adjunta y la respuesta.
- Las filas de los datos de Power BI no se envían mediante este mecanismo. Solo se envían las solicitudes de capas y de teselas. Si el vínculo o el filtro de una capa se construye a partir de los datos mediante formato condicional, los valores de ese vínculo forman parte de la dirección.
- El servidor debe ser accesible desde Internet para que el proxy pueda obtener sus recursos. El proxy no puede llegar a un servidor que solo está disponible dentro de la red interna.
Desactivar el proxy en todas partes
Active Icon Map Slicer > Personalización > Entorno aislado. A partir de entonces, el proxy queda descartado para todo el mapa. Usar el proxy cuando sea necesario se muestra desactivado y deshabilitado, con la nota "No disponible: el Entorno aislado (airgapped) está activado, por lo que el mapa no realiza llamadas a los servicios de Icon Map, incluido el proxy." El Administrador de capas oculta su casilla y su interruptor de proxy.
Una licencia de Icon Map también puede excluir el proxy. El conmutador indica entonces "No disponible: esta licencia no incluye el proxy de Icon Map."
Consulte Power BI Report Server (local).
Consejos y límites
- Es preferible corregir CORS en el servidor propio. Así se evitan el proxy, el requisito de la clave de licencia y el salto adicional.
- Un vínculo que se abre en un explorador pero no en el mapa es el síntoma habitual de un bloqueo de CORS. Consulte Solución de problemas.
- El proxy no convierte en público un servidor privado. Reenvía las credenciales que el mapa ya usa.
- Si la red restringe el tráfico saliente, permita las direcciones de ArcGIS y de Icon Map que se indican en Entornos compatibles y límites.