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 Slicer 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 Slicer é 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.
• Quando um leitor seleciona itens, ele filtra o relatório pela interface de filtros do próprio Power BI. O filtro permanece dentro do Power BI.
• 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.
• 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 Slicer 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 áreas de tempo de viagem, as rotas e as linhas de fluxo são calculadas dentro do visual. Para os tempos de viagem, ele baixa dados de vias. O ponto em que um leitor clica não é enviado para lugar nenhum.
• 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.
• A seleção, a filtragem, as dicas de ferramenta e o menu de contexto 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, os filtros 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 Slicer 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.

Ambiente isolado interrompe o Catálogo do Icon Map e o proxy. Sem uma URL de estilos personalizados, ele também impede que o visual leia a lista de estilos do Icon Map: o mapa então desenha um estilo alternativo. Ele não interrompe a telemetria: para isso, ative Recusar a telemetria.

Consulte Power BI Report Server (local).

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. O proxy nunca é usado quando Ambiente isolado está ativado ou quando a sua licença do Icon Map não o permite.

Entrada no ArcGIS e o proxy descreve exatamente quando o proxy é usado e o que é enviado a ele.

Credenciais

• Uma chave de API do ArcGIS, as credenciais inseridas para uma camada WMS 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. A janela de entrada do ArcGIS indica o Icon Map Slicer como o aplicativo que pede acesso.

Consulte Entrada no ArcGIS 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 Slicer 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.
• As chaves de licença para ambientes isolados são aceitas pelo próprio visual quando o serviço de licenciamento não pode ser acessado, por isso funcionam sem conexão.

Telemetria

O Icon Map Slicer 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. Quando um mapa é desenhado pela primeira vez, uma lista dos recursos que ele usa, e não os seus dados: o tipo de mapa base e o estilo do Icon Map, se o sombreamento de relevo, o terreno e o céu estão ativados, 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.
• O que cada evento traz. O ID da instância do visual, a versão dele, o produto, o ambiente em que está sendo executado e se o relatório está sendo editado ou lido. Quando o relatório usa uma chave de licença, a chave e a Referência opcional são incluídas, para que o suporte possa associar os eventos a uma licença.
• 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, e nada sobre o que os leitores selecionam.
• Recusar. Ative Painel Formato > Icon Map Slicer > Comentários > 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. Eles descrevem problemas, como um ID de célula que não pode ser lido, sem os valores envolvidos. Deixe desativado, a menos que o suporte peça.

Certificação pela Microsoft

O Icon Map Slicer 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
• Power BI Report Server (local)
• Contrato de licença de usuário final
• Avisos de terceiros