Console de depuração local

(Opcional) Para visualizar o console de depuração local em seu computador de desenvolvimento, você pode encaminhar a porta do console via SSH. No entanto, você deve primeiro ativar a opção AllowTcpForwarding no arquivo de configuração SSH do seu dispositivo principal. Essa opção é habilitada por padrão. Execute o comando a seguir em seu computador de desenvolvimento para visualizar o painel em localhost:1441 no computador de desenvolvimento.

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

Crie uma sessão para usar o console de depuração local. Ao criar uma sessão, você gera uma senha que usa para autenticar. O console de depuração local exige uma senha para aumentar a segurança, pois você pode usar esse componente para visualizar informações importantes e realizar operações no dispositivo principal. O console de depuração local também cria um certificado para proteger a conexão se você habilitar HTTPS na configuração do componente. O HTTPS está habilitado por padrão.

Use a AWS IoT Greengrass CLI para criar a sessão. Esse comando gera uma senha aleatória de 43 caracteres que expira após 8 horas. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass V2 raiz.

A saída do comando se parece com o exemplo a seguir se você tiver configurado o console de depuração local para usar HTTPS. Você usa as impressões digitais do certificado para verificar se a conexão é segura ao abrir o console de depuração local.

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

O componente de visualização de depuração cria uma sessão que dura 8 horas. Depois disso, você deverá gerar uma nova senha para visualizar o console de depuração local novamente.

Abra e faça login no painel. Visualize o painel em seu dispositivo principal do Greengrass ou em seu computador de desenvolvimento se você encaminhar a porta por SSH. Execute um destes procedimentos:

• Se você habilitou o HTTPS no console de depuração local, que é a configuração padrão, faça o seguinte:

  1. Abra https://localhost:1441 em seu dispositivo principal ou em seu computador de desenvolvimento se você encaminhou a porta por SSH.

     Seu navegador pode mostrar um aviso de segurança sobre um certificado de segurança inválido.

  2. Se seu navegador mostrar um aviso de segurança, verifique se o certificado é legítimo e ignore o aviso de segurança. Faça o seguinte:

     1. Encontre a impressão digital SHA-256 ou SHA-1 do certificado e verifique se ela corresponde à impressão digital SHA-256 ou SHA-1 que o comando get-debug-password imprimiu anteriormente. Seu navegador pode fornecer uma ou ambas as impressões digitais. Consulte a documentação do seu navegador para ver o certificado e suas impressões digitais. Em alguns navegadores, a impressão digital do certificado é chamada de impressão digital.

        nota

        Se a impressão digital do certificado não corresponder, acesse Passo 2 para criar uma nova sessão. Se a impressão digital do certificado ainda não corresponder, sua conexão pode estar insegura.

     2. Se a impressão digital do certificado corresponder, ignore o aviso de segurança do seu navegador para abrir o console de depuração local. Consulte a documentação do seu navegador para ignorar o aviso de segurança do navegador.

  3. Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.

     Abra o console de depuração local.

  4. Se o console de depuração local mostrar um erro informando que não é possível se conectar ao WebSocket devido a uma falha no handshake de TLS, você deverá ignorar o aviso de segurança autoassinado do URL. WebSocket

     

     Faça o seguinte:

     1. Abra https://localhost:1442 no mesmo navegador em que você abriu o console de depuração local.

     2. Verifique o certificado e ignore o aviso de segurança.

        Seu navegador pode mostrar uma página HTTP 404 depois que você ignorar o aviso.

     3. Abra https://localhost:1441 novamente.

        O console de depuração local mostra informações sobre o dispositivo principal.

• Se você desabilitou o HTTPS no console de depuração local, faça o seguinte:

  1. Abra http://localhost:1441 em seu dispositivo principal ou abra-o no computador de desenvolvimento se você encaminhou a porta por SSH.

  2. Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.

     Abra o console de depuração local.

(Opcional) Para visualizar o console de depuração local em seu computador de desenvolvimento, você pode encaminhar a porta do console via SSH. No entanto, você deve primeiro ativar a opção AllowTcpForwarding no arquivo de configuração SSH do seu dispositivo principal. Essa opção é habilitada por padrão. Execute o comando a seguir em seu computador de desenvolvimento para visualizar o painel em localhost:1441 no computador de desenvolvimento.

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

Crie uma sessão para usar o console de depuração local. Ao criar uma sessão, você gera uma senha que usa para autenticar. O console de depuração local exige uma senha para aumentar a segurança, pois você pode usar esse componente para visualizar informações importantes e realizar operações no dispositivo principal.

Use a AWS IoT Greengrass CLI para criar a sessão. Esse comando gera uma senha aleatória de 43 caracteres que expira após 8 horas. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass V2 raiz.

A saída do comando se parece com o exemplo a seguir.

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

O componente de visualização de depuração cria uma sessão que dura 4 horas e, em seguida, você deve gerar uma nova senha para visualizar novamente o console de depuração local.

Abra http://localhost:1441 em seu dispositivo principal ou abra-o no computador de desenvolvimento se você encaminhou a porta por SSH.

Faça login no site usando o nome de usuário e a senha que o comando get-debug-password imprimiu anteriormente.

Abra o console de depuração local.