API キー

この項では、 HERE platform で API キーを使用する方法について説明します。 HERE Developer ポータルで API キーを使用する手順については 、「 API キー」を参照してください。

HERE API キーは、アプリケーションのシンプルで安全な認証を提供します。 API キー の資格情報キーローテーション機能を使用して、時間の経過に伴うアプリケーションの継続的なセキュリティを確保します。 これを行うには、アプリケーション用に 2 つ目の API キー を作成し、不要になった元のキーを削除します。 各アプリケーションには、一度に最大 2 つの API キーを使用できます。

すでにアプリを作成している場合、または既存のグループアプリで作業している場合は、ステップ 1 をスキップします。 アプリを登録します。

ステップ 1 : アプリを登録します

  1. HERE アカウントをまだお持ちでない 場合は、「 HERE アカウントを取得する」を参照してください。
  2. HERE platform にサインインします。
  3. ランチャから [アクセスマネージャ]を開きます。
  4. [アプリ] タブで 、 [新しいアプリを登録] をクリックし、要求された情報を入力します。
  5. [ 登録] をクリックするプラットフォームによって、一意のアプリ ID を持つ新しいアプリが作成されます。
  6. [資格情報]タブで 、[API Keys]を選択 し、[API キーを生成]をクリック して、アプリケーション認証資格情報用に 最大 2 つのAPI キーを生成します。API キー が作成され、表示されます。

アプリケーションおよび関連付けられている認証資格情報は、アプリに固有のものであり、ユーザー権限またはグループメンバーシップを継承しません。 アプリの管理を参照してください。

ステップ 2 : API キー を入手してください

  1. HERE platform にサインインします。
  2. ランチャから [アクセスマネージャ]を開きます。
  3. [ アプリ ] タブで、手順 1 で作成したアプリ、または API キー を生成する既存のアプリをクリックします。
  4. 資格情報 タブで 、 API Keys を選択 し、 Create API キー をクリックします。 アプリには、最大 2 つの API キーを生成できます。 API キー が作成され、表示されます。

以前に作成したアプリを使用していて、資格情報タブが表示されない場合、またはグレー表示されている場合は、このアプリに対する管理者権限がない可能性があります。

ステップ 3 : API キー を使用します

リクエストで API キー を使用するには apiKey 、リクエストのパラメーターでキーを指定します。

https://geocode.search.hereapi.com/v1/geocode
?q=240+Washington+St.%2C+Boston
&limit=4
&apiKey={YOUR_API_KEY}

信頼できるドメイン

API キー の資格情報保証

信頼できるドメインを使用すると、 API キー の資格情報の使用を指定したサイトに制限できます。 既定では、任意の Web サイトが、 API キー を使用してサブスクライブ済みの HERE サービスに対するリクエストを作成できます。 API キー の資格情報で API 呼び出しを行うサイトごとにドメインを追加します。 追加する各サイトは、有効な URI で、ドメイン名または IPv4 アドレスを含む必要があります。 提供されたすべてのプロトコル (http/https) およびポートも検証時に使用されます。

許容可能なエントリの例

https://production.example.com:1080
example.com
93.184.216.34
http://www.example.com

信頼できるドメインを設定する手順

  1. HERE platform にサインインします。
  2. ランチャから [アクセスマネージャ]を開きます。
  3. [ アプリ ] タブで、手順 1 で作成したアプリ、または信頼できるドメインを設定する既存のアプリをクリックします。
  4. [ 信頼できるドメイン ] タブで、 API キー 資格情報に信頼するドメインを 20 個まで指定して追加します。 20 を超えるドメインを指定する必要がある場合 は、プラットフォーム CLI でリストを管理してください。
  5. 信頼できるドメインの一覧表を確認したら 、 [ 信頼できるドメインを有効にする ] をオンにします。

ドメインが定義されていないときに信頼できるドメインを有効にすると、アプリを使用できなくなります。

これで、アプリで定義されている API キーを使用するように設定されているサービスは、指定した信頼できるドメインのみに制限されます。 " 信頼できるドメインを有効にする " をオフにするだけで、信頼できるドメインを無効にできます。

信頼できるドメインに対する設定の変更が有効になるまでに、最大 30 分かかることがあります。 たとえば、この期間内に実行されたテストでは、予期した結果が返されない可能性があります。

」に一致する結果は 件です

    」に一致する結果はありません