Conectar ao ArcGIS

O conteúdo público do ArcGIS não precisa de configuração. Para o conteúdo privado, seu ou da sua organização, diga ao mapa como se autenticar. Uma única configuração vale para todas as camadas e mapas base do ArcGIS no visual.

As configurações ficam em Painel Formato > Chaves de API e autenticação > Autenticação do ArcGIS.

Escolher um tipo de autenticação

Sem nenhuma credencial (Chave de API selecionada e a chave deixada vazia), o mapa lê o conteúdo público e as camadas do Living Atlas. Para um mapa base, isso significa serviços em tiles públicos, estilos indicados pela sua URL e mapas da Web com camadas públicas. Os estilos de mapa base da Esri sempre precisam de uma credencial.

Entrar com o ArcGIS

Com este tipo, nada secreto é armazenado no relatório. Cada pessoa inicia sessão com a sua própria conta do ArcGIS e o mapa mostra o que essa conta tem permissão para ver.

1. Em Autenticação do ArcGIS, defina Tipo de autenticação como Entrar com o ArcGIS.
2. Para o ArcGIS Online, deixe URL do portal e ID do cliente como estão. Para o ArcGIS Enterprise, veja abaixo.
3. Ative Entrar. O ArcGIS abre em uma guia do navegador.
4. Inicie sessão ali com a sua conta do ArcGIS, ou com o login da sua organização se o ArcGIS estiver configurado para isso, e depois volte ao Power BI.

O painel mostra então "Conectado ao ArcGIS como" seguido do seu nome de usuário, e Sair substitui Entrar.

Você inicia sessão no ArcGIS, não no Icon Map. O mapa recebe o token diretamente do seu portal.

O que os leitores do relatório veem

Cada pessoa que abre o relatório inicia sessão com a sua própria conta. Um leitor que não iniciou sessão vê um aviso no mapa: "Este mapa mostra conteúdo do ArcGIS que exige que você entre." com um botão Entrar no ArcGIS.

O início de sessão é lembrado no navegador e é renovado sem novo aviso por até duas semanas. Lembrá-lo depende da configuração de armazenamento local para visuais personalizados no portal de administração do Power BI. Se o seu locatário tiver essa configuração desativada, os leitores são solicitados a iniciar sessão com mais frequência.

ArcGIS Enterprise

Para o seu próprio portal, um administrador registra um aplicativo uma única vez:

1. No portal, registre um aplicativo e adicione este URI de redirecionamento: https://api.iconmap.ai/arcgis/oauth/callback
2. Em Autenticação do ArcGIS, insira o endereço do portal em URL do portal e o ID do cliente do aplicativo em ID do cliente.

O portal deve permitir solicitações do Power BI (CORS) para que a entrada seja concluída.

Chave de API

1. Crie uma chave de API no ArcGIS e conceda a ela os itens e serviços que o relatório usa.
2. Defina Tipo de autenticação como Chave de API e cole a chave em Chave de API.

As chaves de API expiram e não podem ser renovadas pelo mapa. Quando o ArcGIS rejeita uma chave, o mapa informa isso. Crie uma nova chave e cole-a.

OAuth2 (ID e segredo do cliente)

1. Crie credenciais de desenvolvedor OAuth 2.0 no ArcGIS. Quando o ArcGIS pedir uma URL de redirecionamento, insira https://app.powerbi.com.
2. Defina Tipo de autenticação como OAuth2 (ID e segredo do cliente).
3. Insira a URL do portal se você não usa o ArcGIS Online e depois o ID do cliente e o Segredo do cliente.

O segredo do cliente é armazenado criptografado no relatório e mostrado como pontos depois de inserido. A credencial do aplicativo vê apenas o conteúdo compartilhado com o proprietário do aplicativo, ou que é público.

Nome de usuário e senha

Defina Tipo de autenticação como Nome de usuário e senha e insira a URL do portal se você não usa o ArcGIS Online. Nenhum nome de usuário ou senha é salvo no relatório.

Cada pessoa que abre o relatório vê uma janela Entrar no ArcGIS na primeira vez que o mapa precisa de conteúdo do ArcGIS, e insere o seu próprio nome de usuário e senha do ArcGIS. A sessão dura duas semanas quando o navegador tem permissão para lembrá-lo. Quando ele expira, a janela é mostrada de novo.

Testar a conexão

Ative Testar conexão para verificar toda a configuração. A opção abre Procurar no ArcGIS em uma vista que lista as verificações: o portal, a credencial e todas as camadas do ArcGIS do mapa. Uma verificação do proxy é listada apenas quando o proxy está em uso. As camadas de referência aparecem com os títulos "Sobreposição do ArcGIS 1", "Sobreposição do ArcGIS 2" e assim por diante. Tudo o que falha vem com uma explicação e com o que fazer a respeito.

Resultados comuns:

Servidores que bloqueiam o Power BI

Um visual do Power BI só pode ler um servidor que o permite (CORS). O ArcGIS Online permite. Alguns servidores ArcGIS Enterprise não.

Ative Usar o proxy quando necessário para deixar o proxy do Icon Map buscar nesses servidores. Cada servidor ainda é primeiro tentado diretamente, e apenas um servidor que bloqueia o Power BI é lido por meio do proxy. A solicitação e a sua credencial passam pelo proxy. É necessária uma chave de licença do Icon Map, e as solicitações via proxy podem consumir créditos de uso adicionais.

Procurar no ArcGIS oferece a mesma opção quando encontra um servidor bloqueado: selecione Usar o proxy CORS.

O proxy não está disponível quando Ambiente isolado está ativada. Para saber o que o proxy recebe e como ele é protegido, consulte Chaves de API, autenticação e o proxy.

Como a credencial é enviada

Enviar credencial como decide como o token ou a chave viaja até o ArcGIS.

• Parâmetro de URL (padrão) adiciona-o ao endereço de cada solicitação. Deixe nesta opção, a menos que o seu servidor a rejeite.
• Cabeçalho de autorização (Bearer) envia-o como um cabeçalho de solicitação. O ArcGIS Enterprise 11.5 e posteriores podem rejeitar as chaves de API mais recentes (que começam com AAPT) na URL com "Invalid Token". Esses servidores precisam desta opção e devem permitir o cabeçalho Authorization nas suas configurações de CORS.

As solicitações de conteúdo público não levam credencial, e uma credencial é enviada apenas aos servidores aos quais ela pertence.

Configurações

Painel Formato > Chaves de API e autenticação > Autenticação do ArcGIS

Entrar, Sair e Testar conexão são opções que agem uma vez e se desativam sozinhas em seguida.

Relacionados

• Camadas do ArcGIS
• Camadas do ArcGIS vinculadas a dados
• Outros fornecedores de mapa base - mapas base do ArcGIS
• Chaves de API, autenticação e o proxy