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

ローカルデバッグコンソールを開くには

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

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

   注記

   デフォルトのポートは、1441および1442。詳細については、「」を参照してください。ローカルデバッグコンソールの設定。

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

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

   sudo /greengrass/v2/bin/greengrass-cli get-debug-password

   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 時間持続するセッションを作成します。その後、新しいパスワードを生成して、ローカルのデバッグコンソールを再度表示する必要があります。

3. ダッシュボードを開き、サインインします。Greengrass コアデバイス、または SSH 経由でポートを転送する場合は、開発用コンピューターでダッシュボードを表示します。次のいずれかを行ってください。

   • ローカルデバッグコンソールで HTTPS を有効にした場合 (デフォルト設定)、次の操作を行います。

     1. オープンhttps://localhost:1441、または SSH 経由でポートを転送した場合は、開発用コンピューターにインストールします。

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

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

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

           注記

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

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

     3. ユーザー名とパスワードを使用して Web サイトにサインインします。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. ユーザー名とパスワードを使用して Web サイトにサインインします。get-debug-passwordコマンドが以前に印刷されました。

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

ローカルデバッグコンソールを開くには

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

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

   注記

   デフォルトのポートは、1441および1442。詳細については、「」を参照してください。ローカルデバッグコンソールの設定。

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

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

   sudo /greengrass/v2/bin/greengrass-cli get-debug-password

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

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

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

3. オープンhttp://localhost:1441をインストールするか、SSH 経由でポートを転送した場合は、開発用コンピューターで開きます。

4. ユーザー名とパスワードを使用して Web サイトにサインインします。get-debug-passwordコマンドが以前に印刷されました。

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