本地调试控制台

（可选）要在开发计算机上查看本地调试控制台，可以转发控制台的端口SSH。但是，您必须先在核心设备的SSH配置文件中启用该AllowTcpForwarding选项。默认情况下，此选项处于启用状态。在开发计算机上运行以下命令，以在开发计算机localhost:1441上查看仪表板。

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

创建会话以使用本地调试控制台。创建会话时，会生成一个用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。如果您在组件配置中启用HTTPS，则本地调试控制台还会创建证书来保护连接。HTTPS默认情况下处于启用状态。

使用 Amazon IoT Greengrass CLI创建会话。此命令生成一个 43 个字符的随机密码，该密码将在 8 小时后过期。替换/greengrass/v2或 C:\greengrass\v2 包含 Amazon 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. 如果本地调试控制台显示错误提示 WebSocket 由于TLS握手失败而无法连接，则必须绕过对的自签名安全警告。 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

创建会话以使用本地调试控制台。创建会话时，会生成一个用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。

使用 Amazon IoT Greengrass CLI创建会话。此命令生成一个 43 个字符的随机密码，该密码将在 8 小时后过期。替换/greengrass/v2或 C:\greengrass\v2 包含 Amazon 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命令之前打印的用户名和密码登录网站。

本地调试控制台打开。