資格情報の取得
HERE platform のすべてのユーザーが、認証と承認の資格情報を取得する必要があります。
HERE platform でアプリケーションを認証するには、次の方法があります。
- プラットフォームポータルから入手できるプラットフォーム資格情報をデータ クライアント ライブラリ資格情報管理システムと組み合わせて使用する ( 開発に推奨 )
- 暗号化されたプラットフォーム資格情報を使用し、これらの資格情報をデータ クライアント ライブラリ資格情報管理システムにプログラムによって提供します
- プラットフォーム資格情報のアクセスキー ID とアクセスキーシークレットを使用して、 HERE トークンを取得するための独自の認証および承認クライアントを作成します。このクライアントは、データ クライアント ライブラリ資格情報管理システムに提供できます。 詳細について は、『 Identity & Access Management Guide 』を参照してください。
プラットフォーム資格情報を取得するに は、 https://platform.here.com/profile/access-credentials ページから新しいアプリケーションを作成します。 アプリケーションを作成したら 、 [ キーの作成 ] をクリックして、これらの資格情報をダウンロードします。
上記のいずれかのオプションを使用している場合 $HOME/.here/credentials.properties
は、資格情報をに配置します。
資格情報オプション
以下のスニペットは、データ クライアント ライブラリをプラットフォーム資格情報に提供するさまざまな方法を示しています。
引数として資格情報を指定せずに新しいサービスクライアントを初期化すると、データ クライアント ライブラリはデフォルトの資格情報プロバイダチェーンを使用してプラットフォーム資格情報の検索を試みます。 JVM クラスパス内のプラットフォーム資格情報ファイル、デフォルトの場所であるプラットフォーム資格情報のダウンロード場所 ()~/.here/credentials.properties
、および Java のシステムプロパティが、この順序でダウンロードされます。
以下のスニペットでは、 HERE platform 請求タグの使用方法についても説明します。このタグは、後でこれらのリクエストの請求にリクエストを関連付けるために、プラットフォームへのリクエストで使用できます。
アプリケーションの設定ファイルを使用して資格情報を設定します
プラットフォーム資格情報の値に基づいて application.conf
、ファイルに次のパラメータを含めます。
here.platform.data-client.request-signer {
billing-tag = "example_billing_tag"
credentials {
here-account {
here-token-endpoint-url = "https://account.api.here.com/oauth2/token"
here-client-id = "example-client-id"
here-access-key-id = "example-access-key-id"
here-access-key-secret = "example-access-key-secret"
}
}
}
here.platform.data-client.request-signer {
billing-tag = "example_billing_tag"
credentials {
here-token = "example-token"
}
}
資格情報ファイルで資格情報を設定します
データ クライアント ライブラリは、 HERE アクセスキーを読み取り credentials.properties
、ファイルからシークレットデータにアクセスできます。
- クライアントは
credentials.properties
、 Java 仮想マシン (JVM) のクラスパスでファイルを探します。 - プラットフォーム資格情報を検索する代替の場所がにあります
~/.here/credentials.properties
- または
application.conf
、ファイル内の別の資格情報ファイルの場所を指定することもできます。
here.platform.data-client.request-signer {
billing-tag = "example_billing_tag"
credentials {
file-path = "/path/credentials.properties"
}
}
資格情報プロパティファイルの例 :
here.user.id = example-here-user-id
here.client.id=example-client-id
here.access.key.id=example-access-key-id
here.access.key.secret=example-access-key-secret
here.token.endpoint.url="https://account.api.here.com/oauth2/token"
注 : 以前に生成したトークンを使用して
以前に生成された HERE トークンは、プラットフォーム資格情報ファイル形式ではサポートされていません。
Java の [ システムのプロパティ ] で資格情報を設定します
Java システムのプロパティを使用して資格情報を設定するには、次の項目を定義します。
-Dhere.platform.data-client.request-signer.credentials.here-account.here-token-endpoint-url="https://account.api.here.com/oauth2/token"
-Dhere.platform.data-client.request-signer.credentials.here-account.here-client-id="example-client-id"
-Dhere.platform.data-client.request-signer.credentials.here-account.here-access-key-id="example-access-key-id"
-Dhere.platform.data-client.request-signer.credentials.here-account.here-access-key-secret="example-access-key-secret"
-Dhere.platform.data-client.request-signer.credentials.here-token="example-token"