ローカルデバッグコンソール

(オプション) 開発コンピュータでローカルデバッグコンソールを確認するには、コンソールのポートを SSH 経由で転送できます。ただし、最初にコアデバイスの SSH 設定ファイルに AllowTcpForwarding オプションを有効にする必要があります。デフォルトでは、このオプションは有効になっています。開発用コンピュータに次のコマンドを実行して、開発用コンピュータの localhost:1441 でダッシュボードを確認します。

ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address

セッションを作成してローカルデバッグコンソールを使用します。セッションを作成するとき、認証に使用するパスワードを生成します。このコンポーネントを使用して重要な情報を確認して、コアデバイスで操作を実行するため、ローカルデバッグコンソールはセキュリティを強化するためにパスワードが必要です。コンポーネント設定で HTTPS を有効にすると、ローカルデバッグ コンソールも接続を保護するための証明書を作成します。HTTPS はデフォルトで有効になっています。

AWS IoT Greengrass CLI を使用してセッションを作成します。このコマンドは、8 時間後に有効期限が切れるランダムな 43 文字のパスワードを生成します。/greengrass/v2 または C:\greengrass\v2 を AWS IoT Greengrass V2 ルートフォルダへのパスに置き換えます。

ローカルデバッグコンソールが HTTPS を使用するように設定した場合、コマンド出力は次の例のようになります。ローカルデバッグコンソールを開くとき、証明書フィンガープリントを使用して接続が安全であることを確認します。

Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password expires at: 2021-04-01T17:01:43.921999931-07:00
The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1

デバッグビューコンポーネントは 8 時間続くセッションを作成します。その後、ローカルデバッグコンソールを再度再度するには、新しいパスワードを生成する必要があります。

ダッシュボードを開いてサインインします。Greengrass コアデバイスでダッシュボードを確認します。または、 SSH 経由でポートを転送する場合、開発コンピュータで確認します。次のいずれかを行います。

• デフォルト設定であるローカルデバッグコンソールで HTTPS を有効にした場合、次の手順を実行します。

  1. コアデバイスで https://localhost:1441 を開きます。または、 SSH 経由でポートを転送した場合、開発コンピュータで開きます。

     ブラウザに、無効なセキュリティ証明書に関するセキュリティ警告が表示されることがあります。

  2. ブラウザにセキュリティ警告が表示された場合、証明書が正当であることを確認してセキュリティ警告をバイパスします。以下の操作を実行します。

     1. 証明書の SHA-256 または SHA-1 フィンガープリントを検索し、get-debug-password コマンドは以前に出力した SHA-256 または SHA-1 フィンガープリントと一致することを確認します。ブラウザは、一方または両方のフィンガープリントを提供することがあります。証明書とそのフィンガープリントを確認するには、ブラウザのマニュアルを参照してください。一部のブラウザでは、証明書のフィンガープリントはサムプリントと呼ばれます。

        注記

        証明書のフィンガープリントが一致しない場合、ステップ 2 に移動して新しいセッションを作成します。証明書のフィンガープリントがそれでも一致しない場合、接続が安全ではない可能性があります。

     2. 証明書のフィンガープリントが一致する場合、ブラウザのセキュリティ警告をバイパスして、ローカルデバッグコンソールを開きます。ブラウザのセキュリティ警告をバイパスするには、ブラウザのマニュアルを参照してください。

  3. get-debug-password コマンドが以前に出力したユーザー名とパスワードを使用して、ウェブサイトにサインインします。

     ローカルデバッグコンソールが開きます。

  4. TLS ハンドシェイクが失敗したことにより、ローカルデバッグコンソールが WebSocket に接続できないというエラーを表示した場合、WebSocket URL の自己署名セキュリティ警告をバイパスする必要があります。

     

     以下の操作を実行します。

     1. ローカルデバッグコンソールを開いたときと同じブラウザで https://localhost:1442 を開きます。

     2. 証明書を確認してセキュリティ警告をバイパスします。

        警告をバイパスすると、ブラウザに HTTP 404 ページが表示されることがあります。

     3. 再度 https://localhost:1441 を開きます。

        ローカルデバッグコンソールには、コアデバイスに関する情報が表示されます。

• ローカルデバッグコンソールで HTTPS を無効にした場合、次の手順を実行ます。

  1. コアデバイスで http://localhost:1441 を開きます。または、SSH 経由でポートを転送した場合、開発コンピュータで開きます。

  2. get-debug-password コマンドが以前に出力したユーザー名とパスワードを使用して、ウェブサイトにサインインします。

     ローカルデバッグコンソールが開きます。

(オプション) 開発コンピュータでローカルデバッグコンソールを確認するには、コンソールのポートを SSH 経由で転送できます。ただし、最初にコアデバイスの SSH 設定ファイルに AllowTcpForwarding オプションを有効にする必要があります。デフォルトでは、このオプションは有効になっています。開発用コンピュータに次のコマンドを実行して、開発用コンピュータの localhost:1441 でダッシュボードを確認します。

ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address

セッションを作成してローカルデバッグコンソールを使用します。セッションを作成するとき、認証に使用するパスワードを生成します。このコンポーネントを使用して重要な情報を確認して、コアデバイスで操作を実行するため、ローカルデバッグコンソールはセキュリティを強化するためにパスワードが必要です。

AWS IoT Greengrass CLI を使用してセッションを作成します。このコマンドは、8 時間後に有効期限が切れるランダムな 43 文字のパスワードを生成します。/greengrass/v2 または C:\greengrass\v2 を AWS IoT Greengrass V2 ルートフォルダへのパスに置き換えます。

コマンド出力は、次の例のようになります。

Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password will expire at: 2021-04-01T17:01:43.921999931-07:00

デバッグビューコンポーネントは 4 時間続くセッションを作成し、さらにローカルデバッグコンソールを再度確認するため、新しいパスワードを生成する必要があります。

コアデバイスで http://localhost:1441 を開きます。または、SSH 経由でポートを転送した場合、開発コンピュータで開きます。

get-debug-password コマンドが以前に出力したユーザー名とパスワードを使用して、ウェブサイトにサインインします。

ローカルデバッグコンソールが開きます。