Idioma
Português

Considerações sobre navegador e rede

Mesmo depois que o consentimento do administrador e as configurações de locatário estiverem prontos, as políticas de navegador e de rede ainda podem gerar pop-ups de entrada ou erros de "acesso negado". Esta página lista as causas comuns e as soluções para compartilhar com a sua equipe de TI e de suporte ao usuário.

O Icon Map é executado em um iframe

O editor do Icon Map é executado dentro do shell do Fabric como um frame servido por app.iconmap.ai, e o visualizador incorporado é executado como um frame nos seus próprios sites a partir de embed.iconmap.ai. Duas consequências:

  • Cookies de terceiros / prevenção de rastreamento. O bloqueio rigoroso de cookies de terceiros ou a prevenção de rastreamento podem interromper o agente de entrada. Permita cookies para os domínios do Icon Map e da Microsoft (abaixo).
  • Bloqueadores de pop-up. O fluxo de entrada pode abrir um pop-up. Permita pop-ups para *.fabric.microsoft.com e para os domínios do Icon Map, para que a autenticação seja concluída.

Sites a permitir

Quando a sua organização mantém uma lista de sites confiáveis ou de cookies permitidos, inclua:

  • *.fabric.microsoft.com e app.powerbi.com
  • login.microsoftonline.com
  • app.iconmap.ai
  • api.iconmap.ai
  • embed.iconmap.ai (somente quando você incorpora mapas publicados)
  • mesh.iconmap.ai (somente quando os mapas usam camadas de catálogo com malha 3D fotorrealista)

Quando os mapas usam as camadas de clima ao vivo, permita também os buckets públicos de dados meteorológicos (anônimos, somente leitura):

  • noaa-gfs-bdp-pds.s3.amazonaws.com
  • noaa-gefs-pds.s3.amazonaws.com
  • ecmwf-forecasts.s3.eu-central-1.amazonaws.com

Acesso Condicional

As políticas de Acesso Condicional (autenticação multifator, exigência de dispositivo em conformidade ou gerenciado, frequência de entrada) se aplicam aos recursos que o Icon Map chama: OneLake/Azure Storage, Azure Data Explorer e o serviço do Power BI. Em locatários muito restritos, elas podem aparecer como solicitações extras ou erros de acesso negado. Se os usuários receberem solicitações inesperadas, revise as políticas de Acesso Condicional que têm esses recursos como alvo.

As entradas por fonte são separadas

Algumas camadas se conectam a serviços externos que têm autenticação própria, sem relação com a sua configuração do Fabric/Entra:

  • Serviços WMS com OAuth ou autenticação por chave.
  • Entrada no ArcGIS para importar camadas de feições.

Essas solicitações são esperadas: elas autenticam você no serviço de terceiros, e as credenciais são armazenadas com segurança no item de mapa, e não na configuração da camada.

Recursos externos e CORS

Várias camadas carregam recursos diretamente de uma URL: um serviço WMS ou WMTS, blocos raster ou vetoriais XYZ / PMTiles, uma sobreposição de imagem, um DEM personalizado de terreno 3D em Efeitos do mundo ou um feed ao vivo. Os navegadores aplicam CORS a essas solicitações entre origens: se o host não retornar os cabeçalhos CORS corretos, o navegador bloqueia a solicitação e a camada não carrega.

Para resolver isso, o Icon Map recorre automaticamente a um proxy de busca do lado do servidor (hospedado em api.iconmap.ai). Primeiro ele tenta carregar o recurso diretamente no navegador; se isso for bloqueado pelo CORS, ou por conteúdo misto, quando um recurso http:// é solicitado a partir da página https://, ele busca o mesmo recurso novamente pelo proxy, que o obtém do lado do servidor (onde o CORS não se aplica) e o devolve ao mapa. Toda solicitação que leva uma credencial (uma chave de API ou um segredo armazenado) sempre passa pelo proxy, para que o segredo fique no servidor e nunca chegue ao navegador.

Para os administradores, isso significa:

  • Nenhuma configuração de CORS por host é necessária: o recurso alternativo é automático e funciona por recurso.
  • Mantenha api.iconmap.ai na sua lista de sites confiáveis / permitidos para que o proxy esteja acessível.
  • O proxy apenas encaminha a solicitação; ele não retém o recurso. Os serviços externos autenticados continuam se autenticando como descrito acima.

Próximas etapas