Segurança e certificação

Esta página é para administradores e revisores de segurança. Ela explica o que permanece dentro do visual, a quais serviços o Icon Map Pro se conecta e o que ele envia a esses serviços, e por que o visual não é certificado pela Microsoft.

Resumo

• O Icon Map Pro é executado dentro da área restrita (sandbox) de visuais personalizados do Power BI, no navegador ou no Power BI Desktop. O Power BI entrega a ele somente os campos que você adiciona.
• Ele desenha os seus dados dentro do visual. Nada dos dados do seu relatório é enviado ao Icon Map.
• Ele carrega mapas base, e quaisquer camadas às quais você se vincule por link, de serviços externos. É disso que um mapa precisa, e é o motivo pelo qual o visual não pode ser certificado.
• Um servidor que você conecta aos seus dados, como uma camada do ArcGIS unida a eles, recebe os valores de que precisa para fazer a correspondência. Você escolhe esses servidores.
• Ele envia telemetria de uso de recursos que não contém dados do relatório, e que você pode desativar.
• No mecanismo Moderno, as bibliotecas JavaScript que ele usa estão empacotadas dentro do visual. Nenhuma é carregada da internet em tempo de execução.

Os dados do seu relatório

• O Icon Map Pro desenha as suas linhas ele mesmo, dentro do visual. Ele não tem nenhum serviço de geocodificação ao qual as suas linhas sejam enviadas: você fornece coordenadas, formas ou valores que correspondem a feições.
• As rotas e as linhas de fluxo são calculadas dentro do visual.
• Nada dos dados do seu relatório é enviado aos serviços do Icon Map: nem aos mapas base, nem à verificação de licença, nem à telemetria, nem ao Catálogo do Icon Map.
• O controle Pesquisar procura lugares em um índice que o visual baixa. Ele pesquisa o que um leitor digita, e não os seus dados.
• Quando você une uma camada de feições do ArcGIS aos seus dados pelo campo Referência da feição, o visual pede a esse servidor ArcGIS as feições correspondentes. Os valores que ele procura são enviados a esse servidor como parte da consulta.
• Um link que você monta a partir dos seus dados com a formatação condicional, como um link de arquivo ou um valor de filtro, é enviado ao servidor para o qual esse link aponta, como parte da solicitação.
• As dicas de ferramenta, a seleção e o filtro cruzado passam pelas interfaces do próprio Power BI.

O que o visual tem permissão para fazer

O Power BI executa todo visual personalizado em uma área restrita: um quadro separado que não pode ler a página do relatório, os outros visuais dela nem a sua entrada no Power BI. O Power BI passa ao visual somente os campos que você adiciona a ele, e o visual devolve as seleções e as dicas de ferramenta por meio do Power BI.

O Power BI também concede a um visual personalizado somente os privilégios que ele declara. O Icon Map Pro declara três:

Serviços externos

Cada serviço só é contatado quando o recurso que o utiliza está em uso. Os endereços estão listados, para regras de firewall, em Ambientes compatíveis e limites.

Para impedir todas as chamadas aos serviços do Icon Map, ative Ambiente isolado. Consulte Power BI Report Server (local).

Os mapas base e os recursos que pertencem ao mecanismo Herdado, como os fundos do Google Maps, do Mapbox e do MapTiler, estão descritos na documentação da versão 1.1.0.9 e anteriores.

O proxy

O proxy do Icon Map vem desativado por padrão. Quando você o ativa para um servidor que não permite que o Power BI o leia, as solicitações a esse servidor passam no caminho por uma retransmissão operada pelo Icon Map, junto com qualquer credencial anexada a elas, e a retransmissão devolve a resposta. Os registros dela guardam o site e o caminho de cada solicitação, e não a consulta nem o que foi enviado.

Chaves de API, autenticação e o proxy descreve exatamente quando o proxy é usado e o que é enviado a ele.

Credenciais

• As chaves de API dos fornecedores e a chave de licença do Icon Map são salvas no relatório como configurações. Trate de acordo um relatório que as contenha.
• Um segredo do cliente do ArcGIS é salvo em forma protegida.
• As entradas pessoais no ArcGIS são mantidas no armazenamento local do visual no dispositivo do leitor, e não no relatório.

Consulte Chaves de API, autenticação e o proxy e Conectar ao ArcGIS.

Verificações de licença

• As licenças de usuário são verificadas pelo Power BI. O visual pergunta ao Power BI quais planos do Icon Map o usuário conectado tem. Nada é enviado ao Icon Map para isso.
• As chaves de licença são validadas online no serviço de licenciamento do Icon Map. Um visual licenciado por chave também registra o uso nesse serviço quando carrega dados: a chave, o ambiente em que está sendo executado, o produto, a Referência opcional, o ID da instância do visual e um ID de sessão. As licenças baseadas em uso são medidas dessa forma. O uso de camadas do Catálogo do Icon Map é registrado na licença.

Telemetria

O Icon Map Pro envia telemetria de uso de recursos ao Azure Application Insights na região UK South. Ela é usada para entender quais recursos são utilizados e para diagnosticar erros.

• O que é enviado. Uma lista dos recursos que um mapa usa, e não os seus dados: o mecanismo de mapa e a projeção, o tipo de mapa base e o estilo do Icon Map, se o sombreamento de relevo está ativado, quais camadas de referência e camadas de dados estão ativadas, a fonte das imagens, o número de níveis de formas e, para as camadas do Catálogo do Icon Map, o nome, o ID, o tipo de acesso e a visibilidade. Cada evento também traz o ID da instância do visual, a versão dele, o ambiente em que está sendo executado e se o relatório está sendo editado ou lido.
• Erros. Erros como uma falha na validação da licença são enviados como exceções. Antes de um erro ser enviado, os textos entre aspas, os números e os endereços da Web são removidos da mensagem dele, por isso ele não pode levar nenhum valor do seu relatório.
• O que não é coletado. O rastreamento automático de exibições de página e de solicitações de rede está desativado. Somente os eventos acima são enviados. Nenhum dado do seu relatório é incluído.
• Recusar. Ative Painel Formato > Icon Map Pro > Informações para o suporte > Recusar a telemetria. A telemetria só é iniciada depois que o visual lê essa configuração, por isso um relatório que a recusa não envia absolutamente nada.
• Telemetria detalhada. Eventos adicionais de diagnóstico só são enviados enquanto Telemetria detalhada para o suporte está ativado. Deixe desativado, a menos que o suporte peça.

Certificação pela Microsoft

O Icon Map Pro não pode ser certificado pela Microsoft. Um dos requisitos de um visual certificado é que ele não acesse nenhum serviço externo:

Accessing external services or resources. For example, no HTTP/S or WebSocket requests can go out of Power BI to any services.

Os mapas base são grandes demais para serem armazenados dentro de um visual, por isso precisam ser servidos por uma fonte externa. Os critérios completos estão na documentação da Microsoft sobre visuais certificados.

Os visuais não certificados não são permitidos na minha organização

Ao publicar um relatório no serviço do Power BI, você pode ver esta mensagem no lugar do visual:

Ela significa que os visuais não certificados não são permitidos no seu locatário do Power BI ou do Microsoft Fabric. Um administrador pode abrir uma exceção para um visual específico adicionando-o como visual organizacional, que pode então ser usado em toda a organização. Consulte as orientações da Microsoft sobre visuais organizacionais.

Revisões de segurança do código

Temos prazer em apoiar revisões de segurança do código. Podemos liberar o código-fonte sob um acordo de confidencialidade (NDA) para que a equipe de segurança de TI da sua organização o revise. Entre em contato com support@icon-map.com.

Relacionados

• Ambientes compatíveis e limites
• Chaves de API, autenticação e o proxy
• Power BI Report Server (local)
• Contrato de licença de usuário final
• Avisos de terceiros