ArcGIS Velocity は、(フィードや解析などの) アイテムの作成、(フィーチャ レイヤーからのフィードなどの) アイテムの実行、出力フィーチャ レイヤーへのフィーチャの書き込みに ArcGIS Online へのアクセスを必要とします。 ユーザー名とパスワードを保存するのではなく、Velocity はリフレッシュ トークンまたは ArcGIS API キーを使用して、ArcGIS Online を認証し接続します。
ArcGIS API キーとリフレッシュ トークンの両方を Velocity に登録できます。 そのような状況では、Velocity は、リフレッシュ トークンではなく、ArcGIS API キーを使用します。 ArcGIS API キーが期限切れまたは無効になると、Velocity は、リフレッシュ トークンに切り替えて、アイテムを作成および実行しようとします。
認証メカニズム
次のセクションでは、両方の認証方法の詳細と Velocity による認証方法の使用方法について説明します。
リフレッシュ トークン
リフレッシュ トークンは、デフォルトの有効期間が 2 週間の短期アクセス トークンです。 長期間にわたってフィードと解析を実行できるようにするために、Velocity には、リフレッシュ トークンが期限切れ間近になるタイミングを示すメカニズムがあります。 Velocity は、これらのトークンを自動的にリクエストおよび更新します。
ArcGIS API キー
ArcGIS API キーは、有効期限が 1 日から 1 年の長期アクセス トークンです。 ArcGIS API キーを作成するときに、その有効期限の値を定義します。 1 年の有効期限の値を使用することをおすすめします。 ArcGIS Online ユーザー アカウントに、ArcGIS API キーの作成に必要な権限が付与されている必要があります。
ArcGIS Online での API キーの作成
注意:
まず ArcGIS Online に API キーを作成して、ArcGIS API キーを Velocity に登録する必要があります。
API キーを作成するには、次の手順を実行します:
- ブラウザーで ArcGIS Online を開き、ArcGIS 組織の認証情報を使用してサイン インします。
- ポータルで、[コンテンツ] > [マイ コンテンツ] > [新しいアイテム] の順にクリックします。
- [開発者の認証情報] > [API キーの認証情報] の順にクリックして、[次へ] をクリックします。
- [ユーザーを偽装するプライベート アプリケーション] オプションを選択して、[次へ] をクリックします。
- [開発者の認証情報を作成] ウィンドウで、次の手順を実行します:
- [有効期限日 (必須)] パラメーターをクリックし、API キーの有効期限日を設定します。
注意:
有効期限日の最小値は 1 日で、最大値は 1 年です。 有効期限日を 1 年に設定することをおすすめします。
- [参照元 URL] パラメーター値を指定して、[次へ] をクリックします。
参照 URL の値として「https://*.arcgis.com」を入力します。
- [アイテムの詳細] セクションで、[タイトル] パラメーターの値を入力して API キー アイテムに名前を付け、[次へ] をクリックします。
- [選択した権限の機能を理解して受け入れます] メッセージ チェックボックスをオンにして、[次へ] をクリックします。
- API キーを作成するときのオプションを選択し、[次へ] をクリックします。
次のオプションを利用できます。
- 今すぐ API キーを生成します。 キーをコピーして保存する準備ができました。
- アイテム詳細ページに移動します。 後で API キーを生成します。
- [有効期限日 (必須)] パラメーターをクリックし、API キーの有効期限日を設定します。
- [API キーの生成] ページで、生成された API キーをコピーして、[閉じる] をクリックします。
注意:
アクセスできるのはこの時だけであるため、必ず API キーをコピーしてください。
- アイテム詳細ページで [設定] > [一般] の順に移動して、[一般] ページを開きます。
[削除の管理] 切り替えボタンをオンにして、このアイテムが誤って削除されないようにすることをおすすめします。
- [一般] ページで [有効期限] テキストにポインターを合わせて、完全な API キーの有効期限日を表示します。
返り値はローカル タイム ゾーンになります。
上記の手順がすべて終了したら、ArcGIS Online に API キーが作成され、Velocity に登録できます。
Velocity への ArcGIS API キーの登録
ArcGIS Online に API キーを生成したら、Velocity に登録できます。
Velocity に ArcGIS API キーを登録するには、次の手順を実行します:
- ブラウザーで Velocity アプリを開き、ArcGIS 組織の認証情報を使用してサイン インします。
- [認証メカニズムの表示] ボタン
をクリックして、[認証メカニズム] ドロップダウン メニューを展開します。
- [認証メカニズムの更新] をクリックして、[認証メカニズムの構成] ダイアログ ボックスを開きます。
- [ArcGIS API キー] オプションを選択して、[次へ] をクリックします。
- 前のセクションで作成した API キーを [ArcGIS API キー] テキスト ボックスに貼り付けます。
- [有効期限日] オプションを前のセクションで選択した日と同じ日に設定します。
- [確認] をクリックします。
上記の手順が完了したら、成功メッセージが表示されます。 [認証メカニズム] ドロップダウン メニューで [ArcGIS API キーが登録されました] 切り替えボタンがオンになっていると、ArcGIS API キーが登録されていることに注意してください。
検討事項および制限事項
Velocity で ArcGIS API キーを使用する場合は、以下を考慮してください:
- 現時点では、登録されている ArcGIS API キーの有効期限が近づいているときに、Velocity は電子メール通知を送信しません。
ArcGIS Online アカウントで、[開発者の認証情報を作成] メニューに [API キー認証情報] オプションが表示されていない場合、アカウントに適切な権限がない可能性があります。 アカウントに、認証を作成して API キー認証情報に割り当てるための権限が必要です。
[メンバー ロール] ページで一般権限を編集できます。 [メンバー ロール] ページを開くには、[組織] > [設定] > [メンバー ロール] に移動します。
[メンバー ロール] セクションの [メンバー ロール] で、ArcGIS Online の既存のロールをすべて表示できます。 ロールの横にあるその他のオプション ボタンをクリックし、[編集] オプションを選択して、[ロールの編集] ウィンドウを開きます。
[ロールの編集] ウィンドウで [一般権限] > [コンテンツ] の順に展開し、[API キーの生成] および [OAuth 2.0 アプリケーションへの権限の割り当て] 切り替えボタンをオンにして、API キー認証情報を作成して認証を割り当てます。
注意:
これらの権限がない場合は、組織の管理者に連絡して、必要な権限でロールを更新してください。
- Velocity で対象のユーザーが作成した API キーを使用するには、そのユーザー アカウントが Velocity アイテムにアクセスできる必要があります。