Partilhar via

Configurar o ArcGIS Pro para acessar um GeoCatalog

Aprenda a configurar o ArcGIS Pro para aceder a conjuntos de dados geoespaciais do Microsoft Planetary Computer Pro GeoCatalog, utilizando autenticação delegada OAuth 2.0 com o Microsoft Entra ID.

Este processo exige que:

  • Registar duas aplicações no Microsoft Entra ID (uma API web e um cliente de ambiente de trabalho).
  • Configure permissões delegadas com o user_impersonation âmbito.
  • Ligue o ArcGIS Pro a conjuntos de dados compatíveis com Azure Blob Storage e Catálogo de Ativos SpatioTemporal (STAC) no ambiente Microsoft Planetary Computer Pro.

Aprenda a navegar e aceder de forma segura a dados alojados no Microsoft Planetary Computer Pro diretamente no ArcGIS Pro, utilizando a usurpação de utilizador do Microsoft Entra ID.

Prerequisites

  • Acesso a um locatário do Microsoft Entra ID
  • Subscrição do Azure com permissões para gerir registos de aplicações
  • ArcGIS Pro instalado em sua máquina

Tip

Antes de começar, consulte informações de fundo em Registar uma candidatura no Microsoft Entra ID.

Registar uma aplicação web API para o ArcGIS Pro

  1. Abra o portal Azure e procure Entra. Selecione Microsoft Entra ID.

    Captura de ecrã que mostra um utilizador a selecionar o ID Microsoft Entra a partir do portal Azure.

  2. Aceda a Registos na> aplicaçãoNovo registo.

    Captura de ecrã que mostra o registo da nova aplicação.

  3. Registre o aplicativo de API Web. Aqui ficam algumas sugestões de nomes:

    • ArcGISPro-GeoCatalog-WebAPI
    • ArcGIS Pro

  4. Em Tipos de Conta Suportados, selecione Contas em qualquer diretório organizacional (Qualquer inquilino Microsoft Entra ID - Multiinquilino).

    Captura de ecrã que mostra como registar uma aplicação.

    Captura de ecrã que mostra como registar uma nova aplicação.

  5. Na sua nova aplicação (chamada ArcGIS Pro no nosso exemplo), vá a Autenticação>Adicionar uma plataforma>Web.

    Captura de ecrã que mostra como escolher a web para autenticação.

  6. Em Configurar Web>URI de Redirecionamento, adicione<https://localhost>. Selecione Configurar.

    Captura de ecrã que mostra como adicionar um URI de redirecionamento.

  7. Voltar a Autenticação>Adicionar uma plataforma e depois selecionar Aplicações móveis e de ambiente de trabalho.

    Captura de ecrã que mostra como adicionar uma aplicação de desktop móvel.

  8. Em Configurar Web>URI de Redirecionamento, adicionearcgis-pro://auth. Selecione Configurar.

    Captura de ecrã que mostra como configurar um dispositivo de secretária.

  9. Em Concessão implícita e fluxos híbridos, selecione a opção para os tokens de ID (usados para fluxos implícitos e híbridos). Selecione Guardar.

    Captura de ecrã que mostra como ativar os ID tokens para a autenticação da aplicação ArcGIS.

  10. Selecione Permissões da API no menu esquerdo. Adicionar e conceder consentimento administrativo para:

    • Azure Storage>user_impersonation
    • Microsoft Graph>User.Read (por defeito)

    Captura de ecrã que mostra como adicionar permissões da API.

  11. Depois de adicionares permissões, seleciona Conceder consentimento de administrador para o Diretório Predefinido.

    Captura de ecrã que mostra como conceder o consentimento do administrador.

  12. No menu esquerdo, selecione Expor uma API>Adicionar. Em Editar URI de ID de aplicação, adicione o URI da sua aplicação em URI de ID de aplicação.

    Captura de ecrã que mostra como adicionar o URI do ID da aplicação.

  13. Selecione Adicionar um âmbito e adicione a seguinte informação:

    • user_authentication (nome de exibição: ArcGISPro-API-User-Auth)

      Captura de ecrã que mostra como adicionar um escopo de autenticação de utilizador.

    • user_impersonation (nome de visualização: ArcGISPro-API-Impersonation)

      Captura de ecrã que mostra como adicionar um âmbito de personificação de utilizador.

  14. Selecione Adicionar um aplicativo cliente. Escolha e tome nota do ID do cliente. Precisa do ID do cliente para configurar uma ligação de autenticação no ArcGIS Pro.

    Captura de ecrã que mostra como adicionar uma aplicação cliente.

Registar uma aplicação cliente de ambiente de trabalho para ArcGIS Pro

Depois de registares a tua primeira candidatura, regista uma segunda (com um nome distinto). A segunda aplicação representa o ArcGIS Pro Desktop e configura as permissões da API. Garanta que a nova aplicação pode aceder à API web que expôs com a primeira aplicação.

  1. Crie um segundo registo de aplicação para o cliente desktop ArcGIS Pro com um destes nomes sugeridos: ArcGISPro-GeoCatalog-DesktopClient ou GeoCatalog-ArcGIS. Defina o tipo de conta selecionando Inquilino Único.

    Captura de ecrã que mostra como registar uma segunda aplicação chamada arcgisprodesktopclient.

    Captura de ecrã que mostra como registar uma nova aplicação chamada GeoCatalog ArcGIS.

  2. Configura a aplicação cliente de ambiente de trabalho. Neste exemplo, usamos o nome GeoCatalog-ArcGIS. Repita os passos do primeiro registo da aplicação:

    • Para adicionar uma plataforma, selecione Web.
    • Para URI de Redirecionamento, adicione <https://localhost>.
    • Para adicionar uma plataforma, selecione aplicações móveis e desktop.
    • Para URI de Redirecionamento, adicione arcgis-pro://auth.
    • Em Concessão implícita e fluxos híbridos, selecione os tokens ID (usados para fluxos implícitos e híbridos). Selecione Guardar.

  3. Adicionar acesso à aplicação web API:

    • No separador de permissões da API , selecione Adicionar uma permissão.

    • Vai ao separador das APIs que a minha organização usa e procura a aplicação Web API que criaste anteriormente (por exemplo, ArcGIS Pro).

    • Selecione o nome do aplicativo para abrir a tela Solicitar permissões da API .

      Captura de ecrã que mostra como pedir permissões da API.

    • Selecione as permissões delegadas user_authentication e user_impersonation que definiu na primeira aplicação.

    • Selecione Adicionar permissões.

      Captura de ecrã que mostra como adicionar permissões de API para o ArcGIS Pro.

  4. Adicione as seguintes permissões delegadas:

    • Azure Storage>user_impersonation
    • Azure Orbital Spatio>user_impersonation
    • Microsoft Graph>User.Read (ativado por defeito)
    • Adicionar permissões
    • Conceder consentimento administrativo

    Captura de ecrã que mostra a seleção da aplicação no ecrã de permissões da API de pedido.

    Captura de ecrã que mostra o consentimento do administrador.

Configure o ArcGIS Pro (ambiente de trabalho) para acesso ao Microsoft Planetary Computer Pro GeoCatalog

Esta secção descreve como configurar autenticação e acesso a dados na aplicação de ambiente de trabalho ArcGIS Pro. Utilizas a integração do OAuth 2.0 com o Microsoft Entra ID e acedes ao Microsoft Planetary Computer Pro GeoCatalog. Esta secção inclui passos para adicionar uma ligação de autenticação e criar ligações de armazenamento e dados STAC.

Adicionar uma conexão de autenticação

  1. Aceda à página de definições do ArcGIS Pro de uma das seguintes formas:

    • Em um projeto aberto, selecione a guia Projeto na faixa de opções.
    • Na página inicial, selecione a guia Configurações .

  2. No menu esquerdo, selecione Opções.

  3. Vá a Opções>Aplicação>Autenticação.

  4. Selecione Adicionar conexão.

  5. Insira um valor no campo Nome da Ligação .

  6. Em Tipo, selecione ID do Microsoft Entra.

  7. Introduza valores nos campos Entra Domain e Client ID .

    • Pode encontrar o seu domínio Microsoft Entra ID (também conhecido como domínio principal) no Microsoft Entra ID no portal Azure.
    • Para o ID do cliente, introduza o ID do cliente que definiu na etapa Adicionar uma aplicação cliente .

  8. Adicione os seguintes valores nos campos Scopes :

    • https://storage.azure.com/.default
    • https://geocatalog.spatio.azure.com/.default

    Captura de ecrã que mostra como adicionar uma ligação.

  9. Selecione OK.

  10. Inicie sessão através do diálogo de Autenticação e complete as instruções.

    Captura de ecrã que mostra como iniciar sessão com o diálogo de autenticação.

Tip

Para mais informações, consulte a documentação: Ligue-se a fornecedores de autenticação do ArcGIS Pro.

Preparar e registrar informações do GeoCatalog

GeoCatalog URI, nome da coleção e endpoint da API de tokens

  1. Crie um Microsoft Planetary Computer Pro GeoCatalog na sua subscrição Azure (por exemplo, arcgisprogeocatalog) e localize-o no grupo de recursos apropriado.

    Captura de ecrã que mostra como encontrar um GeoCatálogo.

  2. Selecione o GeoCatálogo que criou.

  3. Copie o valor do seu URI do GeoCatálogo. Por exemplo, https://arcgisprogeocatalog.<unique-identity>.<cloud-region>.geocatalog.spatio.azure.com.

    Captura de ecrã que mostra como recuperar o URI do GeoCatalog.

  4. Cole o link do seu URI GeoCatalog no navegador e selecione o botão Coleções .

    Captura de ecrã que mostra a interface web do Microsoft Planetary Computer Pro.

  5. Registar o valor no Nome da Coleção. Por exemplo, sentinel-2-l2a-tutorial-1000.

  6. Construa o endpoint da API do token usando este padrão: <GeoCatalog URI>/sas/token/<Collection Name>?api-version=2025-04-30-preview. Por exemplo: https://arcgisprogeocatalog.<unique-identity>.<cloud-region>.geocatalog.spatio.azure.com/sas/token/sentinel-2-l2a-tutorial-1000?api-version=2025-04-30-preview.

Encontre e registre o local de armazenamento

Cada coleção dentro do Microsoft Planetary Computer Pro GeoCatalog armazena dados geoespaciais e ativos de itens STAC numa conta de armazenamento dedicada e num contentor de blob Azure. Nos passos seguintes, encontra e regista os nomes da conta de armazenamento e dos contentores para uma coleção específica.

Observação

Uma conta Azure Storage e um contentor de blob só podem ser descobertos depois de Itens STAC ou outros ativos serem adicionados a uma coleção.

Existem duas formas fáceis de descobrir a conta de armazenamento e o contentor de blob para uma coleção: usando uma miniatura ou usando um item STAC com assets.

Descubra a conta de armazenamento utilizando uma imagem representativa da coleção

  1. A partir de uma página específica de Coleções , selecione o valor para o Nome da Coleção.

    Captura de ecrã que mostra como selecionar o nome da coleção.

  2. Selecione o botão Editar coleção .

    Captura de ecrã que mostra como editar uma coleção do GeoCatalog.

  3. No ecrã JSON resultante, localiza a chave title:assets:thumbnail:href e copia o valor correspondente. Por exemplo:

    https://<unique-storage>.blob.core.windows.net/sentinel-2-l2a-tutorial-1000-<unique-id>/collection-assets/thumbnail/lulc.png

  4. Regista os valores sob Nome da Conta e Nome do Contentor. Por exemplo:

    • Nome da conta (Armazenamento):<unique-storage>
    • Nome do recipiente: sentinel-2-l2a-tutorial-1000-<unique-id>

    Captura de ecrã que mostra uma coleção em json.

Descubra a conta de armazenamento usando um Item STAC

  1. Numa página específica de Coleções , selecione Itens STAC.

    Captura de ecrã que mostra como selecionar o Item STAC.

  2. Selecione a caixa de seleção ao lado de um dos itens STAC listados.

    Captura de ecrã que mostra como selecionar uma caixa de item STAC.

  3. Desloce-se até ao fundo do painel direito do Item STAC e selecione o link para recuperar o JSON do Item STAC.

    Captura de ecrã que mostra como selecionar o link JSON do item STAC.

  4. Encontre o objeto chamado assets dentro da especificação JSON do Item STAC. Selecione um dos tipos de ativos dentro deste objeto e encontre a href chave.

     "assets": {
     "image": {
         "href": "https://<unique-storage>.blob.core.windows.net/naip-sample-datasets-<unique-id>/12f/va_m_3807708_sw_18_060_20231113_20240103/image.tif",
     }
 }

  5. Regista o valor do Nome da Conta e do Nome do Contentor. Por exemplo:

    • Nome da conta (Armazenamento):<unique-storage>
    • Nome do recipiente: naip-sample-datasets-<unique-id>

Configurar uma ligação ao Azure Blob Storage

  1. No ArcGIS Pro, abra a ferramenta de geoprocessamento Criar Arquivo de Conexão de Armazenamento em Nuvem para criar um novo arquivo de conexão ACS. Pode aceder a esta ferramenta na barra de ferramentas principal no separador Análise. Em seguida, selecione Ferramentas e procure a ferramenta escrevendo o seu nome.

  2. Especifique um valor para a Localização do Ficheiro de Ligação do ficheiro ACS.

  3. Dê um nome ao Ficheiro de Ligação. Por exemplo, geocatalog_connection.acs.

  4. Selecionar Service Provider>Azure.

  5. Para Autenticação, selecione o nome do perfil de autenticação que usou anteriormente.

  6. Para ID da Chave de Acesso (Nome da Conta), use o valor Nome da Conta que você registrou anteriormente: <unique-storage>.

  7. Para Bucket (Container) Name use o valor Container Name que você registrou anteriormente: sentinel-2-l2a-tutorial-1000-<unique-id>.

  8. Não especifiquem um valor para Pasta.

  9. Adicione a opção de fornecedor ARC_TOKEN_SERVICE_API e defina o valor para o endpoint da API do token que construiu anteriormente. Por exemplo:

     https://arcgisprogeocatalog.<unique-identity>.<cloud-region>.geocatalog.spatio.azure.com/sas/token/sentinel-2-l2a-tutorial-1000?api-version=2025-04-30-preview

  10. Adicione a opção do fornecedor ARC_TOKEN_OPTION_NAME e defina o valor para AZURE_STORAGE_SAS_TOKEN.

    Captura de ecrã que mostra um exemplo de ficheiro de ligação para criar armazenamento na cloud.

Criar uma conexão STAC com o Microsoft Planetary Computer Pro

Tip

Consulte a documentação do ArcGIS Pro Criar uma ligação STAC.

Captura de ecrã que mostra como criar uma nova ligação STAC.

  1. Dê um nome em STAC Connection. Por exemplo, GeoCatalog_Connection.

  2. Para Conexão, use a forma <GeoCatalog URI>/stac. Por exemplo:

     https://arcgisprogeocatalog.<unique-identity>.<cloud-storage>.geocatalog.spatio.azure.com/stac

  3. Consulta as definições de autenticação que criaste no passo anterior.

  4. Adicionar valores para Parâmetros Personalizados:

    • Designação:api-version
    • Valor:2025-04-30-preview

  5. Adicione o ficheiro de ligação ACS que criou no passo anterior à lista de Ligações de Armazenamento na Nuvem . Selecione OK.

    Captura de ecrã que mostra como criar uma ligação STAC.

  6. Explore a conexão STAC.

    Tip

    Saiba mais sobre o painel ArcGIS Explore STAC.

    Captura de ecrã que mostra o diálogo Explorar STAC.

  7. Pesquise, obtenha metadados extensos do STAC e visualize e navegue pelas imagens.

  8. Adicione imagens selecionadas às funções Mapa ou Cena .

    Captura de ecrã que mostra a janela de dados do STAC.

Conteúdo relacionado

  • Last updated on