Condividi tramite

Configurare ArcGIS Pro per accedere a geoCatalog

Questa guida illustra come configurare ArcGIS Pro per accedere ai set di dati geospaziali da Microsoft Planetary Computer Pro GeoCatalog usando l'autenticazione delegata OAuth 2.0 con Microsoft Entra ID. Ciò richiede la registrazione di due applicazioni in Microsoft Entra ID (un'API Web e un client desktop), la configurazione delle autorizzazioni delegate con ambito user_impersonation e la connessione di ArcGIS Pro all'archiviazione BLOB di Azure e ai set di dati conformi a SpatioTemporal Access Catalog (STAC) ospitati nell'ambiente Microsoft Planetary Computer Pro.

Al termine di questa guida, sarà possibile esplorare e accedere in modo sicuro ai dati ospitati da Microsoft Planetary Computer direttamente in ArcGIS Pro usando la rappresentazione dell'utente microsoft Entra ID.

Prerequisiti

  • Accesso a un tenant di Microsoft Entra ID
  • Sottoscrizione di Azure con autorizzazioni per gestire le registrazioni delle app
  • ArcGIS Pro installato nel computer

Suggerimento

Prima di iniziare, vedere Registrare un'applicazione in Microsoft Entra ID per informazioni generali sulla registrazione dell'app.

Registrare l'applicazione API Web per ArcGIS Pro

  1. Aprire il portale di Azure e passare a Microsoft Entra ID.

    Screenshot che mostra un utente che seleziona l'ID Microsoft Entra nel portale di Azure.

  2. Passare a Registrazioni app>Nuova registrazione.

    Screenshot che mostra la registrazione della nuova app.

  3. Registrare l'applicazione dell'API Web. Nomi suggeriti:

    • ArcGISPro-GeoCatalog-WebAPI o
    • ArcGIS Pro

  4. Impostare Multitenant come tipo di account. Screenshot che mostra la registrazione di un'app ArcGIS Pro.

    Screenshot che mostra la registrazione della nuova app ArcGIS Pro.

  5. Dopo la registrazione, completare la configurazione seguente all'interno della nuova registrazione dell'app ArcGIS Pro.

    • Passare alla scheda Autenticazione .

    • Aggiungi piattaforma: Web.

    Screenshot che mostra la selezione per aggiungere un tipo di piattaforma Web di autenticazione.

  6. Impostare l'URI di reindirizzamento: https://localhost.

    Screenshot che mostra come aggiungere un URI di reindirizzamento.

  7. Aggiungere una piattaforma: applicazioni per dispositivi mobili e desktop

    Screenshot che mostra l'aggiunta di un'app desktop per dispositivi mobili.

  8. Impostare l'URI di reindirizzamento personalizzato: arcgis-pro://auth.

    Screenshot che mostra la configurazione del dispositivo desktop.

  9. Abilitare i token ID nei flussi ibridi e nella Concessione implicita.

  10. Seleziona Salva.

    Screenshot che mostra l'abilitazione dei token ID per l'autenticazione dell'app ArcGIS.

  11. Passare ad Autorizzazioni API.

    • Aggiungere e concedere il consenso amministratore per:
      • Archiviazione di Azure > user_impersonation.
      • Microsoft Graph > User.Read (questa autorizzazione è abilitata per impostazione predefinita).

    Screenshot che mostra come configurare l'aggiunta di autorizzazioni API.

  12. Concedere il consenso da parte dell'amministratore dopo l'aggiunta delle autorizzazioni.

    Screenshot che mostra come concedere il consenso degli amministratori.

  13. Passare a Esporre un'API.

    • Aggiungere App ID URI.

    Screenshot che mostra come aggiungere l'URI id app .

  14. Definire gli ambiti:

    • user_authentication (nome da visualizzare: ArcGISPro-API-User-Auth)
    • user_impersonation (nome visualizzato: ArcGISPro-API-Impersonation)

    Screenshot che mostra l'aggiunta dell'ambito di autenticazione utente.

    Screenshot che mostra l'ambito di aggiunta della rappresentazione utente.

  15. Selezionare Aggiungi un'applicazione client e prendere nota dell'ID app.

    Screenshot che mostra come aggiungere un'app client.

Registrare l'applicazione client desktop per ArcGIS Pro

Registrare una seconda applicazione (con un nome distinto) per rappresentare ArcGIS Pro Desktop e configurarne le autorizzazioni API --- garantire che includa l'accesso all'API Web esposta dalla prima applicazione.

  1. Creare una seconda registrazione dell'app per il client desktop ArcGIS Pro.

    • Nome suggerito: ArcGISPro-GeoCatalog-DesktopClient o GeoCatalog-ArcGIS.

    • Impostare il tipo di account: single-tenant.

    Screenshot che mostra la registrazione della seconda app arcgisprodesktopclient.

    Screenshot che mostra la registrazione della nuova app GeoCatalog ArcGIS.

  2. Configurare l'applicazione client desktop.

    Completare la configurazione seguente all'interno della nuova registrazione dell'app GeoCatalog-ArcGIS.

    • Per l'autenticazione ripetere gli stessi passaggi del passaggio 1:

      • Aggiungi piattaforma: Web.
      • Impostare l'URI di reindirizzamento: https://localhost.
      • Aggiungere piattaforma.
      • Impostare l'URI di reindirizzamento: arcgis-pro://auth.
      • Abilitare i token ID nei flussi ibridi e nella Concessione implicita.
      • Seleziona Salva.

    • Autorizzazioni API: aggiunta dell'accesso all'app per le API Web.

      • Nella scheda Autorizzazioni API selezionare Aggiungi un'autorizzazione.

      • Passare alle API usate dall'organizzazione e cercare l'app per le API Web creata nel passaggio 1, ad esempio ArcGIS Pro.

      • Selezionare il nome dell'app per aprire la schermata Richiedi autorizzazioni API .

    Screenshot che mostra le autorizzazioni API di richiesta.

    • Selezionare sia user_authentication sia user_impersonation, quindi le autorizzazioni delegate definite nella prima app.

    • Selezionare Aggiungi autorizzazioni.

    Screenshot che mostra l'aggiunta di autorizzazioni API ArcGIS Pro.

    • Continuare ad aggiungere le autorizzazioni delegate seguenti:

      • Archiviazione di> Azure user_impersonation.
      • Azure Orbital Spatio> user_impersonation.
      • Microsoft Graph> User.Read (questa autorizzazione è abilitata per impostazione predefinita).
      • Selezionare Aggiungi autorizzazioni.
      • Seleziona Concedi consenso amministratore.

    Screenshot che mostra la selezione dell'app nella schermata richiedi autorizzazioni API.

    Screenshot che mostra i consensi amministrativi concessi (4).

Configurare ArcGIS Pro (Desktop) per l'accesso GeoCatalog di Microsoft Planetary Computer Pro

Questa sezione descrive come configurare l'autenticazione e l'accesso ai dati nell'applicazione desktop ArcGIS Pro usando l'integrazione di OAuth 2.0 con Microsoft Entra ID e l'accesso a Microsoft Planetary Computer Pro GeoCatalog. Include i passaggi per aggiungere una connessione di autenticazione e per creare connessioni di archiviazione e dati STAC.

Aggiungere una connessione di autenticazione

  1. Aprire la pagina delle impostazioni di ArcGIS Pro in uno dei modi seguenti:

    • Da un progetto aperto selezionare la scheda Progetto sulla barra multifunzione.
    • Nella pagina iniziale selezionare la scheda Impostazioni .

  2. Nel menu laterale selezionare Opzioni.

  3. Nella finestra di dialogo Opzioni , in Applicazione, selezionare Autenticazione.

  4. Selezionare Aggiungi connessione per aggiungere una nuova connessione di autenticazione.

  5. Nella finestra di dialogo Aggiungi connessione :

    • Immettere un Nome connessione.

    • In Tipo selezionare Microsoft Entra ID.

    • Immettere il dominio Entra e l'ID del cliente.

    • Aggiungere i ambiti seguenti:

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

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

    Screenshot che mostra come aggiungere una connessione.

    • Seleziona OK.

    • Accedere tramite la finestra di dialogo Autenticazione e completare le richieste.

    Screenshot che mostra come accedere con la finestra di dialogo Autenticazione.

Suggerimento

Per ulteriori informazioni, consultare la documentazione ufficiale di ArcGIS Pro Come connettersi ai provider di autenticazione con ArcGIS Pro.

Preparare e registrare le informazioni di GeoCatalog

  1. Creare un Microsoft Planetary Computer Pro GeoCatalog nella sottoscrizione di Azure (ad esempio arcgisprogeocatalog) e individuarlo nel gruppo di risorse appropriato.

    Screenshot che mostra la funzione di ricerca hiddentype nel GeoCatalog.

  2. Seleziona il GeoCatalog. Ad esempio, arcgisprogeocatalog.

  3. Registrare l'URI GeoCatalog. Ad esempio, https://arcgisprogeocatalog.<unique-identity>.<cloud-region.geocatalog.spatio.azure.com>.

    Screenshot che mostra come recuperare l'URI GeoCatalog.

  4. Aprire il collegamento all'URI GeoCatalog nel browser e selezionare il pulsante Raccolte

    Screenshot che mostra l'interfaccia Web Microsoft Planetary Computer Pro.

  5. Registrare il nome della raccolta. Ad esempio, sentinel-2-l2a-tutorial-1000.

  6. Creare l'endpoint dell'API token usando questo modello:

    \<GeoCatalog URI\>/sas/token/\<Collection Name\api-version=2025-04-30-preview

    Esempio:

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

  7. Selezionare il nome della raccolta.

    Screenshot che mostra il clic sul nome della raccolta.

  8. Selezionare il pulsante Modifica raccolta .

    Screenshot che mostra come modificare una raccolta GeoCatalog.

  9. Nella visualizzazione JSON risultante individuare la chiave "title:assets:thumbnail:href" e copiare il valore corrispondente. Per esempio:

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

  10. Registrare il valore del Nome Account e del Nome Contenitore.

    • Nome account: ad esempio <unique-storage>
    • Nome contenitore: ad esempio sentinel-2-l2a-tutorial-1000-unique-id<>

    Screenshot che mostra la visualizzazione json della raccolta.

Configurare una connessione al BLOB di Azure

  1. In ArcGIS Pro aprire lo strumento di geoprocessing Create Cloud Storage Connection File per creare un nuovo file di connessione ACS. È possibile accedere a questo strumento nella barra multifunzione principale della scheda Analisi. Selezionare il pulsante Strumenti, quindi cercare lo strumento digitandone il nome.

  2. Specificare il percorso del file di connessione per il file ACS.

  3. Specificare un nome file di connessione. Ad esempio, geocatalog_connection.acs.

  4. Per il Provider di servizi selezionare Azure.

  5. Per Autenticazione selezionare il nome del profilo di autenticazione creato nei passaggi precedenti.

  6. Per ID chiave di accesso (nome account) usare il valore Nome account registrato in precedenza: <unique-storage>.

  7. Per Nome bucket (contenitore) usare il valore Nome contenitore registrato in precedenza: sentinel-2-l2a-tutorial-1000-unique-id<>.

  8. Aggiungere l'opzione provider ARC_TOKEN_SERVICE_API e impostare il valore al tuo Endpoint API del token che hai creato in precedenza. Per esempio:

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

  9. Aggiungere l'opzione provider ARC_TOKEN_OPTION_NAME e impostare il valore su AZURE_STORAGE_SAS_TOKEN.

    Screenshot che mostra l'esempio di creazione del file di connessione all'archiviazione cloud.

Creare una connessione STAC a Microsoft Planetary Computer Pro

  1. Creare una nuova connessione STAC in ArcGIS Pro (desktop).

    Suggerimento

    Vedere la documentazione di ArcGIS Pro per creare una connessione STAC.

    Screenshot che mostra la creazione di una nuova connessione stac.

    • Specificare un nome per la connessione STAC: ad esempio, GeoCatalog_Connection.

    • Per Connessione usare il modulo\<GeoCatalog URI\>/api . Ad esempio:

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

    • Fare riferimento alle impostazioni di autenticazione eseguite nel passaggio precedente.

    • Aggiungere il file di connessione ACS creato nel passaggio precedente alla connessione STAC.

    • Seleziona OK.

    Screenshot che mostra come creare una connessione STAC.

  2. Esplorare la connessione STAC.

    Suggerimento

    Altre informazioni sul riquadro Esplora STAC di ArcGIS.

    Screenshot che mostra la finestra di dialogo Esplora STAC.

    • Cercare, ottenere metadati STAC estesi e visualizzare le immagini di anteprima.

    • Aggiungere immagini selezionate a Mappa o Scena.

    Screenshot che mostra la finestra di esplorazione dei dati STAC.

Contenuti correlati