OAuth トークン

注

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

トークン資格情報は、ベアラアクセストークンの OAuth 2.0 業界標準プロトコルに準拠しています。 HERE は、 REST への要求を認証する目的で、アプリケーションが最大 24 時間使用できる安全なアクセストークンを取得するための HERE platform API を提供します。

注

アクセストークンの要求に使用される API には、サービスの健全性を保護するための固定の制限があります。 1 時間あたりの上限 appId は、デフォルトで 15 分あたり 25,000 リクエストに設定されています。 さらに、 HERE サービスへのすべてのリクエストがこの API で検証され、決定チェックの結果がキャッシュされます。 決定キャッシュのミスのみが HERE アカウントにヒットし、クォータにカウントされます。

OAuth 2.0 トークンを使用するには

ステップ 1 ： アプリケーションを登録して資格情報を取得します

注

CLI などの HERE の SDK およびツールの多くは、ユーザーのトークンの取得と使用を管理します。 ほとんどの場合、手順 2 および 3 をスキップできます。

OAuth 2.0 トークンを使用するには、 HERE platform でアプリを登録する必要があります。 アプリを登録するには、次の手順を実行します。

  1. ローカル開発環境で .here 、ホームディレクトリにフォルダを作成します。
    • Mac/Linux ユーザーの場合、これはになります $HOME/.here
    • Windows ユーザーの場合、これは次のようになります C:\%HOMEPATH%\.here ( ホームディレクトリが C ドライブにある場合 )
  2. HERE platform にサインインします。
  3. ランチャから [アクセスマネージャ]を開きます。
  4. [アプリ] タブで 、 [新しいアプリを登録] をクリックし、要求された情報を入力します。
  5. [ 登録] をクリックするプラットフォームによって、一意のアプリ ID を持つ新しいアプリが作成されます。
  6. 資格情報 タブで 、 OAuth 2.0 を選択 し、 Create 資格情報をクリックします。
  7. 表示されたダイアログボックスで 、 [ ダウンロード ] をクリックしてアクセスキーの ID とシークレットを保存します。 この情報は、ユーザー ID 、アプリ ID ( 名前付き here.client.id) 、および OAuth 2.0 トークンエンドポイント URL に加え て、 [ 閉じる ] をクリックするとcredentials.propertiesという名前のファイルに作成され、アクセスキー ID およびアクセスキーシークレットにはアクセスできなくなります。

  8. credentials.properties.here 最初のステップで作成したフォルダにファイルをコピーします。

    credentials.properties ファイルにはプラットフォーム資格情報が含まれています。 プラットフォーム CLI ツールおよびライブラリは、このファイルにアクセスしてプラットフォームへのアクセスを管理します。 これらの OAuth 2.0 トークン資格情報を使用して、 HERE Location Services によって提供された API などの REST API を認証済みの呼び出しを行うこともできます。

    プラットフォーム CLI 情報の使用方法の詳細について は、『コマンド ライン インターフェース開発者ガイド』を参照してください。

注

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

ステップ 2 ： トークンを入手してください

アプリが登録されたので、 OAuth 2.0 トークンを取得してリクエストを認証できます。 HERE サービスへのリクエストごとに OAuth 2.0 トークンを取得するには、アプリケーションをコード化する必要があります。

注

セキュリティ上の理由から、 HERE アクセストークンのライフタイムは制限されています。 古いトークンで HERE API を呼び出しよう 401 Unauthorized とすると、エラーが発生します。

トークンを取得するには、複数の方法があります。

Postman を使用してトークンを取得するプロセスをテストできます。 詳細について は、「 Postman によるテスト」を参照してください。

CLI でトークンを入手できます

プラットフォーム CLI を使用すると、コマンド ラインからプラットフォームサービスにアクセスできます。 CLI を使用してトークンを取得するには api token get 、コマンドを使用します。

olp api token get

これにより、 HERE platform との安全かつ安全な通信を可能にする OAuth 2.0 トークンが返されます。

api token get このコマンドには、役立つ追加のパラメータがあります。 追加のパラメータの詳細について は、『 CLI Guide 』を参照してください。

たとえば、次のコマンドは、 HERE API の呼び出しに使用できるアクセス トークンを取得します。

olp api token get --json

上記のコマンドが返す結果の例を次に示します。

{
    "accessToken": "eyJhbGciOiJSUz...omKF5Mg-sBjryw",
    "expiresAt": "2019-02-19T16:17:26.388Z"
}

SDK または API でトークンを入手できます

AAA Java SDK または認証 API を使用してトークンを取得する方法について は、「 OAuth 2.0 トークン要求のコード化」を参照してください。

ステップ 3 ： トークンを使用します

上記のいずれかの方法を実行した後、 HERE API に対する REST リクエストの作成に使用するトークンを取得できました。

トークンリクエストの HTTP 承認ヘッダーに、ベアラー REST としてトークンを含めます。

Authorization: Bearer <token>

REST リクエストの例

GET /maptile/2.1/maptile/newest/normal.day/13/4400/2686/256/png8
Host: 1.base.maps.ls.hereapi.com
Authorization: Bearer eyJhbGceOyJSAMPLEiIsImN0eSISAMPLEt7VTFIllwIM0cKNCjN2WCCTqlwEEmk-t3gx1BpqUFoeBSAMPLEvhj8nl-RBGcyoljY...
Cache-Control: no-cache

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

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