参照 URL を既存のアプリへ追加すると、組織や一般ユーザーのメンバーと作業を共有する際に効果的です (共有権限によります)。 URL に加えて、アプリのタイプ、目的、概要、説明、アプリの作成に使用されるコードを含む .zip ファイルなどの、その他の詳細情報も共有できます。アプリを ArcGIS Online に追加すると、アプリの URL への参照のみが追加されます。ArcGIS Online には、アプリ ファイルは保存されません。
組織アカウントを持つアプリ開発者は、プラットフォームにアプリを登録することもできます。 これには、組織のメンバーや組織外のユーザーがアプリにサイン インできるよう OAuth アプリケーションを登録する作業も含まれます。詳細については、以下の「開発者の認証情報を使用してアプリを追加し、登録する」セクションをご参照ください。
コード サンプルをアップロードする場合など、アプリを登録する必要がない場合は、以下の「URL からのアプリの追加」セクションの手順に従います。
ヒント:
アプリを組織や一般ユーザーのメンバーと共有する別の方法として、マップを使用したアプリとグループを使用したギャラリー アプリを作成する方法があります。
URL からのアプリの追加
URL を使用して Web 上のアプリにアクセスするが、登録する必要がないアイテム (コード サンプルなど) を追加するには、次の手順に従います。
注意:
登録済みのアプリを追加するには、開発者の認証情報を使用してアプリを追加し、登録する手順に従います。
- サイン インしていることと、コンテンツを作成する権限を持っていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブから [新しいアイテム] をクリックし、[アプリケーション] をクリックします。
- アプリのタイプを選択します。
- [Web マッピング] - JavaScript などの Web API で構築された Web アプリ。
- デスクトップ - Java や .NET (Microsoft Windows デスクトップ) などのデスクトップ プラットフォームで構築されたデスクトップ用アプリ
- モバイル - iOS や Android などのモバイル デバイス用に SDK で構築されたダウンロード可能なアプリ
- [他のアプリケーション] - アプリケーションの目的、API、SDK、URL アドレスなどの詳細情報のない、デスクトップ アプリケーション、Python スクリプト、または任意のタイプの一般アプリ。
- Web マッピング、デスクトップ、またはモバイルの場合、アプリの URL (「https://<myServer>/myWebMapApp」など) を入力します。
- デスクトップ アプリの場合、[参照] をクリックし、アプリを含む .zip ファイルを選択します。
- [次へ] をクリックします。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
- 組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [保存] をクリックします。
アプリを追加すると、そのアプリがコンテンツに表示されます。 後から登録する場合は、アプリのアイテム ページの [設定] タブから行えます。 詳細については、以下の「開発者の認証情報を使用してアプリを追加し、登録する」セクションをご参照ください。
必要に応じてアイテムの詳細を構成してコードを添付し、共有権限がある場合はアプリを共有できます。
開発者の認証情報を使用してアプリを追加し、登録する
組織アカウントを持つ開発者は、アプリをプラットフォームに追加および登録してアプリケーション ID を生成できます。 使用に関する統計情報を収集する場合や、ユーザーが OAuth 2.0 (標準化された認証フレームワーク) を使用してプラットフォームにサイン インできるようにする場合は、アプリ内でアプリケーション ID を使用します。 OAuth 2.0 を利用する場合、アプリはプラットフォームが提供するログイン ページを使用して、ユーザーがプラットフォームにサイン インできるようにします。 また、アプリは組織に関連付けられたユーザー コンテンツや、他の ArcGIS Online 機能 (ジオコーディング、ルート検索、GeoEnrichment など) と連携することもできるようになります。 認証と OAuth 2.0 の詳細については、Esri Developer をご参照ください。
または、アプリの登録時にアプリに API キーを埋め込むこともできます。
アプリに含めることができる開発者の認証情報のタイプは、組織内での権限によって異なります。 デフォルト管理者ロールのメンバー、または API キーを生成する権限を持つカスタム ロールのメンバーの場合は、OAuth 2.0 または API キーのどちらの認証情報でもアプリで使用できます。それ以外の場合、アプリで使用できるのは OAuth 2.0 開発者の認証情報のみです。
注意:
ユーザー ログインの実装パターンは、Web ベースのアプリを使用しているか、またはネイティブのアプリを使用しているかによって若干異なります。Web ベースのアプリおよびネイティブ アプリの詳細とサンプル コードについては、Esri Developer ドキュメントをご参照ください。
OAuth 2.0 認証情報が埋め込まれたアプリの追加と登録
作成したアプリで OAuth 2.0 認証情報を使用すると、アプリにアクセスしたときにアクセス トークンが動的に生成されます。 アクセス トークンは最大 14 日間有効です。
ロールに API キーを作成する権限がない場合は、次の手順に従います。
- コンテンツを作成する権限を持つ組織アカウントでサイン インしていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
- [新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
- [OAuth 2.0 認証情報] オプションを選択し、[次へ] をクリックします。
- [リダイレクト URL] に、ユーザーが正常にサイン インした後にリダイレクトするために使用する Web ページまたはサーバーのエンドポイントの URL を入力します。 [追加] をクリックし、必要に応じてリダイレクト URL をさらに追加します。
認証時に指定されたリダイレクト URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
認証許可に対し、特別な値である urn:ietf:wg:oauth:2.0:oob も指定できます。 これにより、認証コードがポータル URL (/oauth2/approval) に配信されます。 この値は通常、コードを配信できる Web サーバーやカスタム URL スキーマのないアプリで使用されます。
サポートされるリダイレクト URL の形式の例を以下に示します。
- https://app.foo.com
- urn:ietf:wg:oauth:2.0:oob
- [参照元 URL] の下に、接続を許可する URL または IP アドレスを入力します。 [追加] をクリックし、必要に応じて参照元 URL または IP アドレスをさらに追加します。
- [アプリケーション環境] で、アプリのアプリケーション環境 ([複数]、[ネイティブ]、[ブラウザー]、または [サーバー]) を選択します。
- [URL] ボックスに、アプリの URL を https://<myServer>/myWebMapApp 形式で入力します。
- [次へ] をクリックします。
OAuth 2.0 アプリケーションに権限を割り当てる権限を持つロールのメンバーの場合、[次へ] をクリックすると、アプリに許可する動作を定義できるウィンドウが表示されます。 この権限がない場合は、手順 12 に進みます。
- 権限を割り当てることで、認証情報がアプリに許可するアクションを選択し、[次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。 アカウントが所有していない権限を付与することはできません。
- [アイテムの参照] をクリックし、埋め込まれた認証情報を使用してアクセスできるアイテムを選択し、[アイテムの追加] をクリックします。
代わりに、[スキップ] をクリックすることもできます。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
- 組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [次へ] をクリックします。
- 認証情報のサマリーを確認します。 設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。 認証情報の設定が正しい場合は、[作成] をクリックします。
アプリがコンテンツに追加され、アイテム ページが表示されます。 OAuth 2.0 認証情報がアプリで使用されていることを示すバッジ がアイテム ページに表示され、コンテンツ ページまたはアイテム プレビュー ウィンドウからアイテムを表示した場合にも表示されます。
アプリのアイテム詳細を構成できます。
アプリのアイテム ページの [設定] タブで、アプリ ID ([クライアント ID])、アプリ シークレット ([クライアント シークレット])、アプリケーション環境などの登録情報を確認できます。 データ ソースの URL やリダイレクト URL の更新、シークレットのリセット、アプリケーションの登録解除、一時的なアプリ トークンのコピーまたは更新を行うことができます。 アプリの権限を変更したり、アプリがアクセスできるレイヤーを変更したりすることもできます。
注意:
設定変更を行うたびに [保存] をクリックしてください。 各設定変更を保存する前に複数の設定を一度に変更すると、一部の設定が保存されなくなることがあります。
アプリ シークレットをリセットすると、そのアプリに対して発行された既存のユーザーとアプリのトークンがすべて無効化されます。ユーザーは、アプリに再びサイン インする必要があり、シークレットを使用して設定されたアプリの更新が必要になる場合があります。
[設定] タブの [使用状況の表示] をクリックすると、アプリにサイン インしたユーザーと、そのユーザーが消費したクレジット数に関する情報にアクセスできます。
注意:
[使用状況の表示] セクションは、ArcGIS Location Platform サブスクリプションでサイン インした場合、表示されません。
API キー認証情報が埋め込まれたアプリの追加と登録
API キー認証情報をアプリに埋め込む必要があり、そのキーの有効期限が 14 日以上必要な場合は、API キー認証情報を使用します。
次の手順に従って、アプリを追加し、アプリに埋め込んで認証目的で使用する API キーを作成します。
- 組織アカウントにサイン インしていることと、コンテンツの作成と API キーの作成を行う権限を持っていることを確認します。
- コンテンツ ページの [マイ コンテンツ] タブをクリックし、[新しいアイテム] をクリックします。
- [新しいアイテム] ウィンドウで [開発者の認証情報] をクリックします。
- [API キー認証情報] オプションを選択し、[次へ] をクリックします。
- カレンダーを使用して、認証情報の有効期限を指定します。
認証情報の有効期限は、翌日 (最短) から 365 日後 (最長) まで設定できます。 有効期限として選択した日の午後 11 時 59 分に有効期限が切れます。 アプリを追加し、認証情報を生成した時点でのブラウザーの時間に基づいて時間が格納されます。
- [参照元 URL] の下に、アプリへの接続を許可する URL または IP アドレスを入力します。[追加] をクリックし、必要な参照元 URL または IP アドレスをさらに追加します。
認証時に指定された URL は、登録済みの URL のいずれかと一致する必要があります。一致しなければ、認証は拒否されます。
サポートされる参照元 URL の形式の例を以下に示します。
- https://www.example.com/pages
- https://www.example.com/pages/index.html
- [次へ] をクリックします。
- 権限を割り当てることで、認証情報がアプリに許可するアクションを選択し、[次へ] をクリックします。
ArcGIS Location Platform サブスクリプションの有無や組織内での権限によって、使用できる権限のリストは異なります。 アカウントが所有していない権限を付与することはできません。
- [アイテムの参照] をクリックし、埋め込まれた認証情報を使用してアクセスできるアイテムを選択し、[アイテムの追加] をクリックします。
代わりに、[スキップ] をクリックすることもできます。
- タイトルを入力します。
- アイテムの保存先となる [マイ コンテンツ] 内のフォルダーを選択します。
- 組織がコンテンツのカテゴリを設定している場合、[カテゴリの割り当て] をクリックして、最大 20 のカテゴリを選択して、アイテムの検索に役立てることができます。
また、カテゴリ名の入力を開始して、カテゴリのリストを絞り込むこともできます。
- 必要に応じて、アイテムを説明するタグを入力します。
語句をカンマで区切ります (たとえば、「Federal land」は 1 つのタグと見なされますが、「Federal, land」は 2 つのタグと見なされます)。
入力する際、以前に追加したタグから生成された推奨タグが表示されますので、そこから選択することができます。
- 必要に応じて、アプリについて説明するサマリーを追加します。
- [次へ] をクリックします。
- 認証情報のサマリーを確認します。 設定を変更するには、アイテムを作成する前に [戻る] をクリックして変更を行います。 認証情報の設定が正しい場合は、[作成] をクリックします。
アプリがコンテンツに追加され、アイテム ページが表示されます。 API キーがアプリに埋め込まれていることを示すバッジ がアイテム ページに表示され、コンテンツ ページまたはアイテム プレビュー ウィンドウからアイテムを表示した場合にも表示されます。
アプリのアイテム詳細を構成できます。
アプリのアイテム ページの [設定] タブで、アプリ ID ([クライアント ID])、アプリ シークレット ([クライアント シークレット])、アプリケーション環境などの登録情報を確認できます。 参照元 URL の更新、シークレットのリセット、アプリケーションの登録解除、一時的なアプリ トークンのコピーまたは更新を行うことができます。 アプリの権限を変更したり、アプリがアクセスできるレイヤーを変更したりすることもできます。
注意:
設定変更を行うたびに [保存] をクリックしてください。 各設定変更を保存する前に複数の設定を一度に変更すると、一部の設定が保存されなくなることがあります。
クライアント シークレットをリセットすると、そのアプリに対して発行された既存のユーザーとアプリのトークンがすべて無効化されます。ユーザーは、アプリに再びサイン インする必要があり、シークレットを使用して設定されたアプリの更新が必要になる場合があります。
[設定] タブの [使用状況の表示] をクリックすると、アプリにサイン インしたユーザーと、そのユーザーが消費したクレジット数に関する情報にアクセスできます。
注意:
[使用状況の表示] セクションは、ArcGIS Location Platform サブスクリプションでサイン インした場合、表示されません。