HERE platform を認証します

アクセス トークンを使用して HERE platform に対する認証を行い、 HERE Data SDK for TypeScript の操作を開始できます。 既定のトークンプロバイダ、ローカル承認、またはプロジェクト認証を使用して受信できます。

アクセス トークンを取得するには :

1. アプリを作成して API キー を取得します。

   手順については、『 Identity & Access Management 開発者ガイド』の「 Manage apps 」セクションを参照してください。

2. プラットフォーム資格情報を入手してください。

   手順については、『 Identity & Access Management 開発者ガイド』の「アプリケーションの登録」セクションを参照してください。

   credentials.properties ファイルが取得されます。

3. 次のいずれかの方法で資格情報を設定します。

   • (Node.js の場合のみ ) loadCredentialsFromFile ヘルパーメソッドを使用して、ファイルから資格情報を取得します。

     const credentials = loadCredentialsFromFile("Path");
     

   • （ブラウザおよび Node.js の場合） credentials.properties ファイルの HERE .access.key.travel d および here.access.key.secret を使用して、資格情報を手動で設定します。

     const credentials = {
       accessKeyId: "replace-with-your-access-key-id",
       accessKeySecret: "replace-with-your-access-key-secret",
     };
     

4. requestToken モジュール UserAuth からメソッドとモジュールをインポート olp-sdk-authentication します。

   import { UserAuth, requestToken } from "@here/olp-sdk-authentication";
   

5. UserAuth インスタンスを作成し、必要に応じてトークンの有効期限を次のいずれかの方法で指定します。

   注

   トークンの有効期限のパラメータは任意です。 デフォルト値は 24 時間です。 変更する場合は、新しい時間を秒単位で指定します。 トークンの有効期限は 0 以上にする必要があります。 アクセス トークンエンドポイントでサポートされているデフォルトの有効期限が 0 以上の場合は無視されます。

   • トークン認証の tokenRequester 場合は、方式、資格情報、およびトークンの有効期限を指定します。

     const userAuth = new UserAuth({
       tokenRequester: requestToken,
       credentials: credentials,
       expiresIn?: number;
     });
     

   • ローカル承認で認証するに tokenRequester は、作業する環境、資格情報、方式、およびトークンの有効期限を指定します。

     注

     使用する環境に応じ envcustomUrlて、またはのいずれかのパラメータを指定します。

     const userAuth = new UserAuth({
       env: "here | here-dev | here-cn | here-cn-dev",
       customUrl: "http://YourCustomEnvironment",
       credentials: credentials,
       tokenRequester: requestToken,
       expiresIn?: number;
     });
     

   • プロジェクトの認証で tokenRequester は、メソッド、プロジェクト名、資格情報、およびトークンの有効期限を指定します。

      const userAuth = new UserAuth({
        tokenRequester: requestToken,
        scope: "your-project-name".
        credentials: credentials,
        expiresIn?: number;
      });
     

6. getToken メソッドを使用して、 HERE platform から OAuth 2.0 トークンを取得します。

   const token: string = await userAuth.getToken();
   

アクセス トークンを使用して OlpClientSettings オブジェクトを作成し、レイヤーで作業できるようになりました。 手順については 、関連 するセクションを参照してください。