GeoCatalog にアクセスするように ArcGIS Pro を構成する

2025-05-20

このガイドでは、Microsoft Entra ID を使用した OAuth 2.0 委任認証を使用して、Microsoft Planetary Computer Pro GeoCatalog から地理空間データセットにアクセスするように ArcGIS Pro を構成する方法について説明します。これには、Microsoft Entra ID (Web API とデスクトップクライアント) に 2 つのアプリケーションを登録し、user_impersonation スコープで委任されたアクセス許可を構成し、Microsoft プラネタリーコンピューター Pro 環境でホストされている Azure Blob Storage および SpatioTemporal Access Catalog (STAC) 準拠のデータセットに ArcGIS Pro を接続する必要があります。

このガイドを終了すると、Microsoft Entra ID ユーザー偽装を使用して、ArcGIS Pro で Microsoft プラネタリーコンピューターでホストされているデータを安全に参照してアクセスできるようになります。

[前提条件]

Microsoft Entra ID テナントへのアクセス
アプリの登録を管理するためのアクセス許可を持つ Azure サブスクリプション
ご自分のマシンにインストールされた ArcGIS Pro

ヒント

開始する前に、「 Microsoft Entra ID にアプリケーションを登録する」で、アプリの登録に関する背景情報を確認してください。

ArcGIS Pro 用の Web API アプリケーションを登録する

Azure Portal を開き、 Microsoft Entra ID に移動します。
[アプリの登録>新しい登録] に移動します。
Web API アプリを登録します。推奨される名前:
- ArcGISPro-GeoCatalog-WebAPI または
- ArcGIS Pro
マルチテナントをアカウントの種類として設定します。
登録後、新しいアプリ登録 ArcGIS Pro 内で次の構成を完了します。
- [ 認証 ] タブに移動します。
- プラットフォームの追加: Web。
リダイレクト URI の設定: https://localhost。
プラットフォームの追加: モバイルアプリケーションとデスクトップアプリケーション
カスタムリダイレクト URI の設定: arcgis-pro://auth。
[暗黙的な許可とハイブリッドフロー] で ID トークンを有効にします。
保存を選択します。
[API のアクセス許可] に移動します。
- 次の場合に管理者の同意を追加して付与します。
  - Azure Storage > user_impersonation。
  - Microsoft Graph > User.Read (このアクセス許可は既定で有効になっています)。
アクセス許可が追加された後、管理者の同意を付与します。
API の 公開に移動します。
- アプリ ID URI を追加します。
スコープを定義します。
- user_authentication (表示名: ArcGISPro-API-User-Auth)
- user_impersonation (表示名: ArcGISPro-API-Impersonation)
[ クライアントアプリケーションの追加] を選択し、アプリ ID をメモします。

ArcGIS Pro 用のデスクトップクライアントアプリケーションを登録する

ArcGIS Pro Desktop を表す 2 つ目のアプリケーションを (個別の名前で) 登録し、その API アクセス許可を構成---、最初のアプリケーションによって公開される Web API へのアクセスを確実に含めます。

ArcGIS Pro デスクトップクライアントの 2 つ目のアプリ登録を作成します。
- 推奨名: ArcGISPro-GeoCatalog-DesktopClient または GeoCatalog-ArcGIS。
- アカウントの種類を設定する: シングルテナント。
デスクトップクライアントアプリを構成します。

新しいアプリ登録 GeoCatalog-ArcGIS 内で次の構成を完了します。
- 認証の場合は、手順 1 と同じ手順を繰り返します。
  - プラットフォームの追加: Web。
  - リダイレクト URI の設定:https://localhost.
  - プラットフォームを追加します。
  - リダイレクト URI の設定: arcgis-pro://auth。
  - [暗黙的な許可とハイブリッドフロー] で ID トークンを有効にします。
  - 保存を選択します。
- API のアクセス許可: Web API アプリへのアクセスの追加。
  - [ API のアクセス許可 ] タブで、[ アクセス許可の追加] を選択します。
  - 組織で使用している API タブに移動し、手順 1 で作成した Web API アプリ (ArcGIS Pro など) を検索します。
  - アプリ名を選択して、[ API アクセス許可の要求 ] 画面を開きます。
- user_authentication と user_impersonation (最初のアプリで定義した委任されたアクセス許可) の両方を選択します。
- アクセス許可の追加 を選択します。
- 引き続き、次の委任されたアクセス許可を追加します。
  - Azure Storage> user_impersonation。
  - Azure Orbital Spatio> user_impersonation。
  - Microsoft Graph> User.Read (このアクセス許可は既定で有効になっています)。
  - アクセス許可の追加 を選択します。
  - [ 管理者の同意の付与] を選択します。

Microsoft プラネタリーコンピューター Pro GeoCatalog アクセス用に ArcGIS Pro (Desktop) を構成する

このセクションでは、OAuth 2.0 と Microsoft Entra ID の統合と Microsoft プラネタリーコンピューター Pro GeoCatalog へのアクセスを使用して、ArcGIS Pro デスクトップアプリケーションで認証とデータアクセスを構成する方法について説明します。これには、認証接続を追加し、ストレージと STAC データ接続を作成する手順が含まれています。

認証接続を追加する

次のいずれかの方法で ArcGIS Pro の設定 ページを開きます。
- 開いているプロジェクトから、リボンの [ プロジェクト ] タブを選択します。
- スタートページで、[ 設定] タブを選択します。
サイドメニューで、[ オプション] を選択します。
[ オプション ] ダイアログボックスの [ アプリケーション] で、[ 認証] を選択します。
[ 接続の追加] を選択して、新しい認証接続を追加します。
[ 接続の追加 ] ダイアログボックスで、次の手順を実行します。
- 接続名を入力します。
- [Type] には [Microsoft Entra ID] を選択します。
- Entra ドメインとクライアント ID を入力します。
- 次の スコープを追加します。
  - https://storage.azure.com/.default
  - https://geocatalog.spatio.azure.com/.default
- [OK] を選択.
- [認証] ダイアログからサインインし、プロンプトを完了します。

ヒント

詳細については、ArcGIS Pro の公式ドキュメント「 ArcGIS Pro から認証プロバイダーに接続する」を参照してください。

GeoCatalog 情報を準備して記録する

Azure サブスクリプションに Microsoft Planetary Computer Pro GeoCatalog (arcgisprogeocatalog など) を作成し、適切なリソースグループで見つけます。
GeoCatalog を選択します。たとえば、 arcgisprogeocatalog です。
GeoCatalog URI を記録します。たとえば、 https://arcgisprogeocatalog.<unique-identity>.<cloud-region>.geocatalog.spatio.azure.com。
ブラウザーで GeoCatalog URI へのリンクを開き、[ コレクション ] ボタンを選択します
コレクション名を記録します。たとえば、sentinel-2-l2a-tutorial-1000 などです。

次のパターンを使用して トークン API エンドポイント を構築します。

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

例：

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

コレクション名を選択します。
[ コレクションの編集] ボタンを選択します。
結果の JSON 表示で、キー "title:assets:thumbnail:href" を見つけて、対応する値をコピーします。例えば次が挙げられます。
```
https://\<unique-storage\>.blob.core.windows.net/sentinel-2-l2a-tutorial-1000-\<unique-id\>/collection-assets/thumbnail/lulc.png
```
アカウント名とコンテナー名の値を記録します。
- アカウント名: <unique-storage など>
- コンテナー名: sentinel-2-l2a-tutorial-1000-<unique-id など>

Azure BLOB への接続を設定する

ArcGIS Pro で、[ クラウドストレージ接続ファイルの作成 ] ジオプロセシングツールを開き、新しい ACS 接続ファイルを作成します。このツールには、[分析] タブのメインリボンからアクセスできます。[ツール] ボタンを選択し、その名前を入力してツールを検索します。
ACS ファイルの接続ファイルの場所を指定します。
接続ファイル名を指定します。たとえば、 geocatalog_connection.acs です。
サービスプロバイダーの場合は、[Azure] を選択します。
[認証] で、前の手順で作成した認証プロファイルの名前を選択します。
アクセスキー ID (アカウント名) には、前に記録したアカウント名の値 (<unique-storage>を使用します。
[バケット (コンテナー) 名] には、前に記録したコンテナー名の値である sentinel-2-l2a-tutorial-1000-<unique-id> を使用します。
ARC_TOKEN_SERVICE_APIプロバイダーオプションを追加し、前に作成したトークン API エンドポイントに値を設定します。例えば次が挙げられます。
```
https://arcgisprogeocatalog.\<unique-identity\>.\<cloud-region\>.geocatalog.spatio.azure.com/api/token/sentinel-2-l2a-tutorial-1000?api=version=2025-04-30-preview
```
ARC_TOKEN_OPTION_NAMEプロバイダーオプションを追加し、値 を AZURE_STORAGE_SAS_TOKEN に設定します。

Microsoft プラネタリーコンピューター Pro への STAC 接続を作成する

ArcGIS Pro (デスクトップ) で新しい STAC 接続を作成します。

ヒント

STAC 接続の作成については、ArcGIS Pro のドキュメントを参照してください。
- STAC 接続の名前を指定します (例: GeoCatalog_Connection)。
- 接続の場合は、フォーム\<GeoCatalog URI\>/apiを使用します。たとえば、
```
  https://arcgisprogeocatalog.\<unique-identity\>.\<cloud-storage\>.geocatalog.spatio.azure.com/api
```
- 前の手順で行った認証設定を参照します。
- 前の手順で作成した ACS 接続ファイルを STAC 接続に追加します。
- [OK] を選択.
STAC 接続を調べる。

ヒント

ArcGIS Explore STAC Paneについてもっと詳しく知る。
- 広範な STAC メタデータを検索して取得し、参照画像を表示します。
- 選択したイメージをマップまたはシーンに追加します。