Bagikan melalui

Mengonfigurasi ArcGIS Pro untuk mengakses GeoCatalog

Panduan ini menunjukkan cara mengonfigurasi ArcGIS Pro untuk mengakses himpunan data geospasial dari Microsoft Planetary Computer Pro GeoCatalog menggunakan autentikasi yang didelegasikan OAuth 2.0 dengan ID Microsoft Entra. Ini memerlukan pendaftaran dua aplikasi di Microsoft Entra ID (API web dan klien desktop), mengonfigurasi izin yang didelegasikan dengan lingkup user_impersonation, dan menghubungkan ArcGIS Pro ke Azure Blob Storage serta dataset yang sesuai dengan SpatioTemporal Access Catalog (STAC) yang dihosting di lingkungan Microsoft Planetary Computer Pro.

Pada akhir panduan ini, Anda akan dapat menelusuri dan mengakses data yang dihosting Microsoft Planetary Computer dengan aman langsung di ArcGIS Pro menggunakan peniruan pengguna MICROSOFT Entra ID.

Prasyarat

  • Akses ke penyewa MICROSOFT Entra ID
  • Langganan Azure dengan izin untuk mengelola pendaftaran aplikasi
  • ArcGIS Pro terinstal di komputer Anda

Petunjuk / Saran

Sebelum memulai, tinjau Mendaftarkan aplikasi di ID Microsoft Entra untuk informasi latar belakang tentang pendaftaran aplikasi.

Mendaftarkan aplikasi API web untuk ArcGIS Pro

  1. Buka Portal Microsoft Azure dan buka ID Microsoft Entra.

    Cuplikan layar memperlihatkan pengguna yang memilih ID Microsoft Entra dari portal Microsoft Azure.

  2. Navigasi ke Pendaftaran> aplikasiPendaftaran baru.

    Cuplikan layar memperlihatkan pendaftaran aplikasi baru.

  3. Daftarkan aplikasi API Web. Nama yang disarankan:

    • ArcGISPro-GeoCatalog-WebAPI atau
    • ArcGIS Pro

  4. Atur Multitenant sebagai jenis akun. Cuplikan layar memperlihatkan daftarkan aplikasi ArcGIS Pro.

    Cuplikan layar memperlihatkan pendaftaran aplikasi baru ArcGIS Pro.

  5. Setelah pendaftaran, selesaikan konfigurasi berikut dalam pendaftaran aplikasi baru ArcGIS Pro.

    • Buka tab Autentikasi .

    • Tambahkan platform: Web.

    Cuplikan layar memperlihatkan pilihan untuk menambahkan jenis autentikasi platform web.

  6. Atur URI Pengalihan: https://localhost.

    Cuplikan layar memperlihatkan cara menambahkan URI pengalihan.

  7. Menambahkan platform: Aplikasi Seluler dan Desktop

    Cuplikan layar memperlihatkan tambahkan aplikasi desktop seluler.

  8. Atur URI Pengalihan Kustom: arcgis-pro://auth.

    Cuplikan layar memperlihatkan konfigurasi perangkat desktop.

  9. Aktifkan token ID di bawah Pemberian implisit dan alur hibrid.

  10. Pilih Simpan.

    Cuplikan layar memperlihatkan aktifkan token ID ArcGIS App authentication.

  11. Buka Izin API.

    • Tambahkan dan berikan persetujuan admin untuk:
      • Azure Storage > peniruan_pengguna.
      • Microsoft Graph > User.Read (Izin ini diaktifkan secara default).

    Cuplikan layar memperlihatkan cara mengonfigurasi penambahan izin API.

  12. Berikan persetujuan admin setelah izin ditambahkan.

    Cuplikan layar memperlihatkan cara memberikan persetujuan admin.

  13. Pergi ke Mengekspos API.

    • Tambahkan URI ID Aplikasi.

    Cuplikan layar memperlihatkan cara menambahkan URI id aplikasi .

  14. Tentukan cakupan:

    • user_authentication (Nama tampilan: ArcGISPro-API-User-Auth)
    • user_impersonation (Nama tampilan: ArcGISPro-API-Impersonation)

    Cuplikan layar memperlihatkan tambahkan cakupan autentikasi pengguna.

    Cuplikan layar yang menampilkan penambahan cakupan impersonasi pengguna.

  15. Pilih Tambahkan aplikasi klien dan catat ID Aplikasi.

    Cuplikan layar memperlihatkan cara menambahkan aplikasi klien.

Mendaftarkan aplikasi klien desktop untuk ArcGIS Pro

Daftarkan aplikasi kedua (dengan nama yang berbeda) untuk mewakili ArcGIS Pro Desktop dan mengonfigurasi izin API-nya --- memastikannya mencakup akses ke API web yang diekspos oleh aplikasi pertama.

  1. Buat pendaftaran aplikasi kedua untuk klien desktop ArcGIS Pro.

    • Nama yang disarankan: ArcGISPro-GeoCatalog-DesktopClient atau GeoCatalog-ArcGIS.

    • Atur jenis akun: Penyewa tunggal.

    Cuplikan layar memperlihatkan pendaftaran aplikasi kedua arcgisprodesktopclient.

    Cuplikan layar memperlihatkan pendaftaran aplikasi baru GeoCatalog ArcGIS.

  2. Mengonfigurasi Aplikasi Klien Desktop.

    Selesaikan konfigurasi berikut dalam Pendaftaran aplikasi baru GeoCatalog-ArcGIS.

    • Untuk Autentikasi, ulangi langkah yang sama seperti pada Langkah 1:

      • Tambahkan platform: Web.
      • Atur URI Pengalihan:https://localhost.
      • Tambahkan platform.
      • Atur URI Pengalihan: arcgis-pro://auth.
      • Aktifkan token ID di bawah Pemberian implisit dan alur hibrid.
      • Pilih Simpan.

    • Izin API: Menambahkan Akses ke Aplikasi API Web.

      • Di tab Izin API , pilih Tambahkan izin.

      • Buka tab API yang digunakan organisasi saya dan cari aplikasi API Web yang dibuat di Langkah 1 (misalnya, ArcGIS Pro).

      • Pilih nama aplikasi untuk membuka layar Minta Izin API .

    Cuplikan layar memperlihatkan izin API permintaan.

    • Pilih user_authentication dan user_impersonation; kedua izin yang didelegasikan tersebut ditentukan di aplikasi pertama.

    • Pilih Tambahkan izin.

    Cuplikan layar memperlihatkan tambahkan izin API ArcGIS Pro.

    • Lanjutkan untuk menambahkan izin yang didelegasikan berikut ini:

      • Azure Storage> penyamaran_pengguna.
      • Azure Orbital Spatio> penyamaran_pengguna.
      • Microsoft Graph> User.Read (Izin ini diaktifkan secara default).
      • Pilih Tambahkan izin.
      • Pilih Berikan perizinan admin.

    Cuplikan layar memperlihatkan pilihan aplikasi pada layar izin API permintaan.

    Cuplikan layar memperlihatkan pemberian persetujuan admin (4).

Mengonfigurasi ArcGIS Pro (Desktop) untuk akses GeoCatalog Microsoft Planetary Computer Pro

Bagian ini menguraikan cara mengonfigurasi autentikasi dan akses data di aplikasi desktop ArcGIS Pro, menggunakan integrasi OAuth 2.0 dengan MICROSOFT Entra ID dan akses ke Microsoft Planetary Computer Pro GeoCatalog. Ini termasuk langkah-langkah untuk menambahkan koneksi autentikasi dan membuat koneksi data penyimpanan dan STAC.

Menambahkan koneksi autentikasi

  1. Buka halaman pengaturan ArcGIS Pro dengan salah satu cara berikut:

    • Dari proyek terbuka, pilih tab Proyek pada pita.
    • Dari halaman mulai, pilih tab Pengaturan .

  2. Di menu samping, pilih Opsi.

  3. Dalam kotak dialog Opsi , di bawah Aplikasi, pilih Autentikasi.

  4. Pilih Tambahkan Koneksi untuk menambahkan koneksi autentikasi baru.

  5. Dalam kotak dialog Tambahkan Koneksi :

    • Masukkan Nama Koneksi.

    • Untuk Jenis, pilih ID Microsoft Entra.

    • Masukkan Domain Entra dan ID Klien Anda.

    • Tambahkanlah cakupan berikut:

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

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

    Cuplikan layar memperlihatkan cara menambahkan koneksi.

    • Pilih OK.

    • Masuk melalui dialog Autentikasi dan selesaikan perintah.

    Cuplikan layar memperlihatkan cara masuk dengan dialog Autentikasi.

Petunjuk / Saran

Untuk informasi selengkapnya, lihat dokumentasi resmi ArcGIS Pro Terhubung ke penyedia autentikasi dari ArcGIS Pro.

Menyiapkan dan merekam informasi GeoCatalog

  1. Buat Microsoft Planetary Computer Pro GeoCatalog di langganan Azure Anda (misalnya, arcgisprogeocatalog), dan temukan di grup sumber daya yang sesuai.

    Cuplikan layar memperlihatkan temukan hiddentype GeoCatalog.

  2. Pilih pada GeoCatalog. Misalnya, arcgisprogeocatalog.

  3. Rekam URI GeoCatalog. Misalnya, https://arcgisprogeocatalog.<identitas> unik.<cloud-region.geocatalog.spatio.azure.com>.

    Cuplikan layar memperlihatkan cara mengambil URI GeoCatalog.

  4. Buka tautan ke URI GeoCatalog Anda di browser dan pilih tombol Koleksi

    Cuplikan layar memperlihatkan antarmuka web Microsoft Planetary Computer Pro.

  5. Catat Nama Koleksi. Misalnya, sentinel-2-l2a-tutorial-1000.

  6. Buat Titik Akhir API Token menggunakan pola ini:

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

    Contoh:

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

  7. Pilih nama koleksi.

    Cuplikan layar memperlihatkan klik pada nama koleksi.

  8. Pilih tombol Edit Koleksi.

    Cuplikan layar memperlihatkan cara mengedit koleksi GeoCatalog.

  9. Dalam tampilan JSON yang dihasilkan, temukan kunci "title:assets:thumbnail:href" dan salin nilai yang sesuai. Contohnya:

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

  10. Catat nilai Nama Akun dan Nama Kontainer:

    • Nama Akun: misalnya <penyimpanan unik>
    • Nama Kontainer: misalnya sentinel-2-l2a-tutorial-1000-unique-id<>

    Cuplikan layar memperlihatkan tampilan JSON koleksi.

Menyiapkan koneksi ke Azure Blob

  1. Di ArcGIS Pro, buka alat geoprocessing Buat File Koneksi Penyimpanan Cloud untuk membuat file koneksi ACS yang baru. Alat ini dapat diakses di Pita utama pada Tab Analisis. Pilih Tombol Alat, lalu cari alat dengan mengetik namanya.

  2. Tentukan Lokasi File Koneksi untuk file ACS.

  3. Berikan Nama File Koneksi. Misalnya, geocatalog_connection.acs.

  4. Untuk Penyedia Layanan pilih Azure.

  5. Untuk Autentikasi, pilih nama profil autentikasi yang Anda buat di langkah sebelumnya.

  6. Untuk ID Kunci Akses (Nama Akun), gunakan nilai Nama Akun yang Anda rekam sebelumnya: <penyimpanan> unik.

  7. Untuk Nama Wadah (Kontainer) gunakan nilai Nama Kontainer yang Anda rekam sebelumnya: sentinel-2-l2a-tutorial-1000-unique-id<>.

  8. Tambahkan opsi penyedia ARC_TOKEN_SERVICE_API dan atur nilai ke Titik Akhir API Token yang Anda buat sebelumnya. Contohnya:

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

  9. Tambahkan opsi penyedia ARC_TOKEN_OPTION_NAME dan atur nilai ke AZURE_STORAGE_SAS_TOKEN.

    Cuplikan layar memperlihatkan membuat sampel file koneksi penyimpanan cloud.

Membuat koneksi STAC ke Microsoft Planetary Computer Pro

  1. Buat koneksi STAC baru di ArcGIS Pro (desktop).

    Petunjuk / Saran

    Lihat dokumentasi ArcGIS Pro untuk Membuat koneksi STAC.

    Cuplikan layar memperlihatkan buat koneksi stac baru.

    • Berikan nama untuk Koneksi STAC: Misalnya, GeoCatalog_Connection.

    • Untuk Koneksi, gunakan formulir\<GeoCatalog URI\>/api . Contohnya,

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

    • Referensikan pengaturan Autentikasi yang dibuat pada langkah sebelumnya.

    • Tambahkan file koneksi ACS yang dibuat pada langkah sebelumnya ke koneksi STAC.

    • Pilih OK.

    Cuplikan layar memperlihatkan cara membuat koneksi STAC.

  2. Jelajahi hubungan STAC.

    Petunjuk / Saran

    Pelajari selengkapnya tentang Panel ArcGIS Jelajahi STAC.

    Cuplikan layar memperlihatkan kotak dialog Jelajahi STAC.

    • Cari, ambil metadata STAC yang lengkap, dan lihat gambar penelusuran.

    • Tambahkan gambar yang dipilih ke Peta atau Adegan.

    Cuplikan layar memperlihatkan menjelajahi jendela data STAC.

Konten terkait