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
| Tipo de autenticação | Quem inicia sessão | O que o mapa pode ver | Use quando |
|---|---|---|---|
| Chave de API | Ninguém. A chave é salva no relatório | Apenas o que a chave concede | Os leitores não têm conta do ArcGIS |
| OAuth2 (ID e segredo do cliente) | Ninguém. A credencial do aplicativo é salva no relatório | O conteúdo compartilhado com o proprietário do aplicativo e o conteúdo público | Os leitores não têm conta do ArcGIS e você usa credenciais de aplicativo |
| Nome de usuário e senha | Cada pessoa, em uma janela de entrada no mapa | Tudo o que essa pessoa pode ver no ArcGIS | Os leitores têm contas do ArcGIS e devem ver apenas o que lhes é permitido |
Sem nenhuma credencial (Chave de API selecionada e a chave deixada vazia), o mapa lê o conteúdo público.
Uma chave de API ou um segredo do cliente salvo em um relatório dá a todos os que podem abrir o relatório o acesso que a credencial tem. Conceda a ela apenas os itens de que o relatório precisa.
Chave de API
- Crie uma chave de API no ArcGIS e conceda a ela os itens e serviços que o relatório usa. Para usar os mapas base do ArcGIS, conceda também os mapas base.
- Defina Tipo de autenticação como Chave de API e cole a chave em Chave de API.
As chaves de API expiram. Quando uma chave expirar, crie uma nova e cole-a.
OAuth2 (ID e segredo do cliente)
- Crie credenciais de desenvolvedor OAuth 2.0 no ArcGIS. Quando o ArcGIS pedir uma URL de redirecionamento, insira
https://app.powerbi.com. - Defina Tipo de autenticação como OAuth2 (ID e segredo do cliente).
- 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. 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.
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.
Configurações
Painel Formato > Chaves de API e autenticação > Autenticação do ArcGIS
| Configuração | O que faz | Padrão |
|---|---|---|
| Tipo de autenticação | Chave de API, OAuth2 (ID e segredo do cliente) ou Nome de usuário e senha | Chave de API |
| Enviar credencial como | Parâmetro de URL (padrão) ou Cabeçalho de autorização (Bearer) | Parâmetro de URL (padrão) |
| Chave de API | A chave de API do ArcGIS. Aparece para Chave de API | Vazio |
| URL do portal | O endereço do seu portal ArcGIS. Aparece para OAuth2 (ID e segredo do cliente) e Nome de usuário e senha | https://www.arcgis.com |
| ID do cliente | O ID do cliente do seu aplicativo. Aparece para OAuth2 (ID e segredo do cliente) | Vazio |
| Segredo do cliente | O segredo do cliente do seu aplicativo. Aparece para OAuth2 (ID e segredo do cliente) | Vazio |
Dicas e limites
- Um visual do Power BI só pode ler um servidor que o permite (CORS). O ArcGIS Online permite. Um servidor ArcGIS Enterprise deve ser configurado para permitir solicitações do Power BI antes que as suas camadas possam ser desenhadas.
- Uma camada WMS hospedada no ArcGIS usa a mesma credencial. Defina o Tipo de autenticação dela como ArcGIS. Consulte Tiles raster, WMTS e WMS.