ArcGIS Survey123 Web サイトをインストールおよび構成する

サマリー

組織では、インターネットへの外部アクセスが存在しない完全な非接続環境での作業が求められる場合があります。 また、接続されている環境の場合でも、ArcGIS Survey123 Web サイトまたは Survey123 REST API、もしくはその両方を組織自体のインフラストラクチャ上でホストすることが必要な場合もあります。

Survey123 REST API は、調査の構成を取得して、Survey123 アプリ (フィールド アプリ / Web フォーム) 用の形式、すなわち、接続されて作成された .xlsx ファイルや Web サイト上で作成された構成などに変換するために使用されます。 これに対して、ArcGIS Survey123 Web サイトは、調査を作成および管理するとともに、収集されたデータを表示、解析する両方の機能を提供します。 これらはどちらも独立したコンポーネントですが、相互に連携することで ArcGIS Survey123 Web サイト (https://survey123.arcgis.com) で得られる機能を提供します。

操作内容
Survey123 REST API および Web サイトをローカルにインストールします。これにより、Survey123 Connect または独自のインフラストラクチャ上の Web サイトで調査を作成して公開できるようになります。 この操作手順では、ArcGIS Survey123 Web サイトの全機能のうち、ほとんどを提供できますが、レポート API をローカルでホストすることはできません。

必要条件
My Esri Web サイトからインストーラー ファイルをダウンロードする必要があります。 下記のインストール手順は Windows 上でのインストールにのみ適用されます。 また、ArcGIS Enterprise ポータル管理者の認証情報および Web サーバー用の管理者アクセス権も必要です。 Survey123 Web サイト インストーラーはポータル インスタンスと同じコンピューター上に配置することも、スタンドアロン Web サーバー上に配置することもできます。 インストールされた Survey123 Web サイトが ArcGIS Enterprise ポータル バージョン 10.5.1 以降を使用したテストに成功したとしても、この初期リリースでは公式には 10.7 以降のバージョンのみがサポートされます。

手順

インストール

Windows:
ダウンロードしたファイルを目的のコンピューターに解凍して、Setup.exe を実行します。 マスター契約書に同意して、インストール場所を選択し、[インストール] をクリックします。 このプロセスの所要時間は約 30 分です。 プロセスが完了したら、[完了] をクリックしてインストールを終了します。

Linux:

注意: ここに含まれるアーカイブ ファイルは、UNIX コンピューターで抽出する必要があります。 Windows コンピューターから抽出すると、適切なセットアップの実行に必要な権限が失われ、一部のファイル名の大文字/小文字が変更されることがあります。

1. Survey123 Web サイトをインストールするコンピューターに .tar.gz ファイルの内容を展開します。このとき、[ターミナル] で「gunzip [ファイル名].tar.gz」コマンドに続いて「tar xf [ファイル名].tar」を使用します。
2. ファイルを展開したら [ターミナル] で「./Setup」を実行し、マスター契約書に同意して、インストール場所を選択し、[インストール] をクリックします。 このプロセスの所要時間は約 5 〜 10 分です。 プロセスが完了したら、[完了] をクリックしてインストールを終了します。

注意: お使いのブラウザーにセキュリティの警告が表示されることがあります。 その場合は、警告に同意して、Web サイトを続行してください。この問題は、ポスト インストール中に証明書を構成することで対処します。

注意: ポスト インストールの実行前に config.json ファイル (デフォルトの場所: C:\Program Files\ArcGIS\Survey123website) のバックアップを作成してください。 インストールが正しく構成されない場合は、このファイルを使用して復元および再起動することができます (または、既存の config.json を手動で編集します)。

ポータルが、ArcGIS REST API に CORS (Cross-Origin Resource Sharing) を介して接続できるドメインを制限しているかどうか確認します。

• 管理者として ArcGIS Enterprise にログインし、組織 → 設定 → セキュリティ → オリジンの許可グループの順に移動します。 デフォルトではすべてのドメインが許可されます。つまり、このリストに URL は指定されていません。 すでにドメインが制限されている場合は、Survey123 のホスト URL をリストに追加します。
• 追加をクリックし、Survey123 Web サイトのホスト URL を追加します。 例:
  • https://<survey123website.domain>:5443
  
  
• [ドメインの追加] をクリックします。 これで、Survey123 Web アプリケーション ドメインが ArcGIS REST API に CORS (Cross-Origin Resource Sharing) を介して接続できるようになります。

認証が組み込まれた ArcGIS Enterprise
インストール先のコンピューター上で https://localhost:5443/share/post-install.html を開いて、ポスト インストールを実行します。

ポスト インストールは、config.json ファイルを編集するための調査形式のウィザードとして表示されます。 このウィザードで次の内容を構成します。

• デフォルトの ArcGIS Portal URL (このインストールはデフォルトで ArcGIS Online を参照する)
• ArcGIS Portal 管理者の認証情報 (ポータルへのサイン イン用のリダイレクト URI を設定するために必要)
• ArcGIS JavaScript API (非接続環境で必要)
• HTTP(s) ポート
• SSL 証明書
• Survey123 Web サイトのホスト URL (Survey123 Web サイトをホストしているコンピューターの http または https URL – ポート番号を忘れずに含めること) この URL は、サイン インを許可するために redirectURI としてポータルに追加されます。
• 非接続環境用の設定。 「インターネット アクセスが存在しない非接続環境で Survey123 Web サイトをインストールしますか？」という質問に対して [はい] を選択すると、Survey123 Connect からインターネット経由の呼び出し (チュートリアル ビデオ、Twitter、Geonet など) を実行できなくする Survey123 組織プロパティが設定されます。

設定を確認し、[送信] をクリックすると、config.json ファイルが更新され、さらに次のことも実行されます。

• 証明書ファイルが ~ArcGIS\Survey123website\server\cert\ フォルダーにインポートされる
• Survey123 Web サイトのホスト URL が redirectURI として survey123hub AppID に追加される
• Survey123 組織プロパティ (basemapsGroupQuery、showCommunityContent、および showTutorialContent) が更新される

テキスト エディターで config.json ファイルを開いて、更新された設定を表示します。

Windows 認証 (IWA) を使用する ArcGIS Enterprise

• Survey123 Web サイトが ArcGIS Enterprise と同じホスト URL にインストールされていない場合は、下記の「ポスト インストールの手動実行」をご参照ください。
• Survey123 Web サイトが ArcGIS Enterprise と同じホスト URL にインストールされている場合は、ArcGIS Enterprise (IWA) サインイン証明書をブラウザーで使用できるようにするために、ポスト インストール用の次の URL にアクセスしてください。

https://<survey123website.domain >:5443/share/post-install.html

これにより、ArcGIS Enterprise (IWA) サインイン証明書をブラウザーで使用できるようになります。

ポスト インストールでは、前述のすべての内容が設定されますが、ArcGIS Enterprise 管理者は、サインインを許可するために、Survey123 Web サイトのホスト URL である https://<survey123website.domain >:5443 を redirectURI としてポータルに手動で追加する必要があります。

1. ポータル管理者の REST インターフェイスにログインします。次に例を示します。
   • https://portal_webadaptorhost.domain /portal_webadaptorname/portaladmin
   
   
2. [Security] → [OAuth] → [Get App Info] の順に移動し、「App ID survey123hub」と入力して [Get App Info] をクリックします。
3. レスポンスのコンテンツをコピーします。
4. [OAuth] に戻って、今回は [Update App Info] に移動します。
5. コピーしたレスポンスを入力ボックスに貼り付けて、Survey123 Web サイトへのアクセスに使用する URL を redirectURI のリストに確実に追加し、[Update App] をクリックします。このとき、リバース プロキシ アクセス ポイントの設定を予定している場合は、そのアクセス ポイントを含めることもできます。次に例を示します。
   • https://survey123website.domain /survey123
   
   
6. ステップ 2 を繰り返して、追加の redirectURI がリストに正常に追加されていることを確認します。

ポスト インストールの手動実行

1. 証明書ファイル (.pfx または .pem) を次のようなインストールの cert フォルダーにコピーします。
   • ~\ArcGIS\Survey123website\server\cert\
   • .pfx ファイルを使用する場合は、インストールされた Survey123 REST API に対するリクエストを実行してパスワードを暗号化する必要があります。 次に、このレスポンスを config.json ファイルにコピーできます (以下を参照)。
     • これを実行するには、encrypt?text= パラメーターを使用して .pfx のパスワードを API URL に追加します。次に例を示します。
     • https://<survey123website.domain>:5443/api/encrypt?text=<pfx_パスワード>
     
     
   • レスポンスは {'result':'a6c2812bed063dd9be'} の形式になります。その結果である a6c2812bed063dd9be を、後で使用するために config.json ファイルにコピーします。
   
   
2. ArcGIS Enterprise 管理者は、Survey123 Web サイトのホスト URL を手動で追加する必要があります。次に例を示します。
   • https://<survey123website.domain >:5443 - これはポータルへの redirectURI です。 前のセクションのステップ 1 ～ 5 をご参照ください。
     
     
   
   
3. テキスト エディターで config.json ファイルを開きます。 このファイルは、Survey123 Web サイトのルート フォルダー (例: ~\ArcGIS\Survey123website) にあります。
   • 要件に従って次のパラメーターを更新します。
     • portalUrl: ArcGIS Enterprise URL (例: https://portal_webadaptorhost.domain.com/portal_webadaptorname)
     • arcgisJsAPi3Url: ArcGIS JavaScript v3.x API URL (例: https://portal_webadaptorhost.domain.com/portal_webadaptorname/jsapi/jsapi/init.js)
     • arcgisJsApiUrl: ArcGIS JavaScript v4.x API URL (例: https://portal_webadaptorhost.domain.com/portal_webadaptorname/jsapi/jsapi4/init.js)
     • httpPort: Survey123 Web サイトの HTTP ポート (デフォルトは 5080)
     • https.port: Survey123 Web サイトの HTTPS ポート (デフォルトは 5443)
     • https.cert: Survey123 Web サイトの HTTPS Base64 Ascii サーバー証明書 (.pem) へのパス (デフォルトは ./server/cert/cert.pem)
     • https.key: Survey123 Web サイトの HTTPS Base64 Ascii サーバー証明書キー (.pem) へのパス (デフォルトは ./server/cert/key.pem)
     • https.pfx: Survey123 Web サイトの HTTPS バイナリ証明書ファイル (.pfx) へのパス (例: ./server/cert/your_certificate.pfx)
     • https.passphrase: Survey123 Web サイトの HTTPS バイナリ証明書用の暗号化されたパスワード。 前述の https://<survey123website.domain>:5443/api/encrypt?text=<pfx_パスワード> の結果を使用して、暗号化されたパスワードを取得してください。
     
     
   
   
4. config.json ファイルを保存します。
5. ArcGIS Survey123 Web サイトの Windows サービスと Linux の Survey123 サービスを再起動して変更を有効にします。