Entrada no ArcGIS e o proxy
O Icon Map Slicer não precisa de chaves de API para os seus próprios mapas base. As únicas credenciais que ele usa são as do ArcGIS. Esta página explica para onde vão essas credenciais, como são armazenadas e o que o proxy do Icon Map faz quando um servidor não permite que o Power BI o leia.
O cartão Autenticação do ArcGIS
O cartão Autenticação do ArcGIS define como o mapa se conecta ao ArcGIS Online ou ao ArcGIS Enterprise. Ele nem sempre está no painel Formato: aparece quando o mapa usa o ArcGIS, ou seja, em qualquer um destes casos:
- Camada de fundo > Fonte do mapa é ArcGIS.
- Uma lista de mapas base criada na caixa de diálogo Mapas base contém um mapa base ou um mapa da Web do ArcGIS.
- Uma camada de referência do ArcGIS está ativada (Camadas de referência > Camada do ArcGIS - preparação).
- A camada de dados do ArcGIS está ativada (Camadas de dados > Camada do ArcGIS).
- Sombreamento de relevo ou Terreno 3D lê um serviço de elevação do ArcGIS.
- Tipo de autenticação já está definido como Entrar com o ArcGIS.
O guia completo, com as etapas de cada método, é Conectar ao ArcGIS. Em resumo:
| Tipo de autenticação | Quem entra | O que é salvo no relatório |
|---|---|---|
| Chave de API | Ninguém | A chave de API |
| OAuth2 (ID e segredo do cliente) | Ninguém. Um aplicativo registrado na sua organização do ArcGIS se conecta | O ID do cliente e o segredo do cliente, em forma protegida |
| Nome de usuário e senha | Cada pessoa, em uma janela de entrada do Power BI | Nada. A sessão é mantida no armazenamento local do visual no dispositivo dessa pessoa |
| Entrar com o ArcGIS | Cada pessoa, em uma guia do navegador | Nada. A sessão é mantida no armazenamento local do visual no dispositivo dessa pessoa |
Com Entrar com o ArcGIS, a página de entrada do ArcGIS abre em uma guia do navegador. Uma retransmissão em api.iconmap.ai devolve o resultado da entrada ao visual, e o visual o troca então por um token diretamente com o seu portal. O token não é enviado ao Icon Map.
Enviar credencial como define como a credencial viaja até o ArcGIS: Parâmetro de URL (padrão) ou Cabeçalho de autorização (Bearer). Deixe em Parâmetro de URL, a menos que o seu servidor o rejeite. O ArcGIS Enterprise 11.5 e posteriores podem rejeitar chaves de API mais novas na URL com "Invalid Token". Esses servidores precisam da opção Cabeçalho de autorização e devem permitir o cabeçalho Authorization nas suas configurações de CORS.
Sem credencial, o conteúdo do ArcGIS é lido como conteúdo público.
Testar conexão verifica o portal, a credencial e todas as camadas do ArcGIS do mapa, e explica qualquer falha.
Como as credenciais são armazenadas
- Uma chave de API do ArcGIS é salva no relatório como uma configuração comum. Qualquer pessoa que possa editar o relatório pode lê-la, e o visual a envia ao ArcGIS em cada solicitação. Restrinja a chave no ArcGIS aos serviços que o mapa usa.
- O Segredo do cliente do ArcGIS é salvo em forma protegida e mostrado como pontos depois que você o insere.
- As sessões de uma entrada pessoal no ArcGIS são mantidas no armazenamento local do visual no dispositivo do leitor, e não no relatório. Isso usa o privilégio opcional de armazenamento local, portanto o seu locatário do Power BI precisa permitir o armazenamento local para visuais personalizados. Sem ele, as pessoas precisam entrar de novo com mais frequência.
- A chave de licença do Icon Map, quando é usada, é salva no relatório em Icon Map Slicer > Chave de licença (para licenciamento não baseado em usuário). Consulte Chaves de licença e ativação.
O proxy
Por que existe um proxy
O Power BI executa cada visual personalizado em um quadro isolado (sandbox). Um servidor Web precisa permitir explicitamente as solicitações vindas desse quadro, por meio de cabeçalhos CORS, para que o visual possa ler a resposta. A maioria dos serviços públicos de mapas permite. Alguns servidores não permitem, em geral servidores ArcGIS Enterprise e alguns servidores de tiles, GeoJSON e WFS. Uma camada de um servidor assim fica em branco, embora o mesmo link abra em um navegador.
A correção que mantém tudo sob o seu controle é permitir o CORS no seu servidor. Quando isso não é possível, o proxy do Icon Map pode buscar o recurso em nome do visual e devolvê-lo com os cabeçalhos de que o Power BI precisa.
O proxy é um serviço de retransmissão operado pelo Icon Map em proxy.icon-map.com. Ele vem desativado por padrão. Exige uma chave de licença do Icon Map, e as solicitações que passam pelo proxy podem consumir créditos de uso adicionais.
Quando o proxy é usado
A configuração se chama Usar o proxy quando necessário e funciona como o nome diz:
- Todo servidor é tentado primeiro diretamente.
- Somente um servidor que comprovadamente não permite o Power BI é buscado pelo proxy. Isso vale para a solicitação que encontrou o bloqueio e para as solicitações seguintes a esse servidor na mesma sessão. Os tiles e as imagens do mapa seguem a mesma regra.
- Os servidores que permitem o Power BI nunca passam pelo proxy, mesmo com a opção ativada.
Você pode ativar o proxy nestes lugares:
| Onde | Aplica-se a |
|---|---|
| Autenticação do ArcGIS > Usar o proxy quando necessário | Todas as solicitações ao ArcGIS que o mapa faz, incluindo mapas base, mapas da Web e elevação do ArcGIS |
| A caixa de diálogo Procurar no ArcGIS, com o botão Usar o proxy CORS quando um servidor é encontrado bloqueado | A mesma opção acima |
| O Gerenciador de camadas, quando você adiciona uma camada de arquivo por link (GeoJSON, KML, CSV ou WFS) e a verificação do link descobre que o servidor bloqueia o Power BI: marque Ler através do proxy CORS do Icon Map (apenas para servidores de confiança) | O link dessa camada |
| O Gerenciador de camadas, quando você adiciona uma camada de tiles raster e a verificação do link descobre que o servidor bloqueia o Power BI: a mesma caixa de seleção | Os tiles dessa camada |
| O Gerenciador de camadas, no editor de uma camada de arquivo ou de tiles raster que você adicionou: Usar o proxy quando necessário na seção Fonte dela | Essa camada |
Quando servidores do ArcGIS foram encontrados bloqueados, a explicação abaixo da opção do ArcGIS os nomeia: "Estes servidores do ArcGIS bloquearam solicitações do Power BI: ...".
A escolha do proxy para uma camada de arquivo ou raster é feita no Gerenciador de camadas: a caixa de seleção enquanto você adiciona a camada e, depois, Usar o proxy quando necessário no editor dela. Os grupos dessas camadas no painel Formato não têm opção de proxy.
As camadas de referência WMS não têm opção de proxy, e o Gerenciador de camadas não oferece uma quando adiciona uma camada WMS. Os mapas base de um servidor de tiles, de um WMS ou de um link de estilo também não, a menos que o mesmo servidor também seja usado por uma camada que tenha o proxy ativado.
O que é enviado ao proxy
Nada é enviado ao proxy a menos que uma opção de proxy esteja ativada e um servidor tenha sido encontrado bloqueando o Power BI.
Para abrir uma sessão, o visual envia:
- a chave de licença do Icon Map do cartão Icon Map Slicer
- o ambiente em que o relatório está sendo executado (por exemplo, o Power BI Desktop, o serviço do Power BI ou o Power BI Embedded)
- o nome do produto, IconMapSlicer
- a Referência opcional do cartão Icon Map Slicer
- o ID da instância do visual e um ID de sessão
O proxy responde com um token de sessão de curta duração, que o visual reutiliza até pouco antes de expirar.
Para cada solicitação que passa pelo proxy, o visual envia:
- o endereço completo do recurso, incluindo a cadeia de consulta. Um token ou uma chave que faça parte do endereço viaja com ele
- o token de sessão
- quaisquer cabeçalhos de solicitação extras de que o servidor precise, por exemplo um cabeçalho de autorização
O proxy faz a solicitação ao seu servidor e devolve a resposta, incluindo conteúdo binário, como tiles.
O que isso significa:
- O serviço de proxy vê o endereço de cada solicitação que passa por ele, qualquer credencial anexada a ela e a resposta.
- As linhas dos seus dados do Power BI não são enviadas por esse mecanismo. Somente as solicitações de camadas e de tiles são. Se você montar o link ou o filtro de uma camada a partir dos seus dados com a formatação condicional, os valores desse link fazem parte do endereço.
- O seu servidor precisa ser acessível pela internet para que o proxy possa buscar nele. O proxy não alcança um servidor que só está disponível dentro da sua rede.
Desativar o proxy em tudo
Ative Icon Map Slicer > Personalização > Ambiente isolado. O proxy fica então excluído para o mapa inteiro. Usar o proxy quando necessário aparece desativada e indisponível, com a nota "Indisponível: o Ambiente isolado (airgapped) está ativado, portanto o mapa não faz chamadas aos serviços do Icon Map, incluindo o proxy." O Gerenciador de camadas oculta a caixa de seleção e a opção do proxy.
Uma licença do Icon Map também pode excluir o proxy. A opção então diz "Indisponível: esta licença não inclui o proxy do Icon Map."
Consulte Power BI Report Server (local).
Dicas e limites
- Prefira corrigir o CORS no seu próprio servidor. Isso evita o proxy, a exigência de chave de licença e o salto extra.
- Um link que abre em um navegador, mas não no mapa, é o sinal habitual de um bloqueio de CORS. Consulte Solução de problemas.
- O proxy não torna público um servidor privado. Ele encaminha as credenciais que o seu mapa já usa.
- Se a sua rede restringe o tráfego de saída, permita os endereços do ArcGIS e do Icon Map listados em Ambientes compatíveis e limites.