Console di debug locale

(Facoltativo) Per visualizzare la console di debug locale sul computer di sviluppo, puoi inoltrare la porta della console tramite SSH. Tuttavia, devi prima abilitare l'AllowTcpForwardingopzione nel file di configurazione SSH del tuo dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il seguente comando sul tuo computer di sviluppo per visualizzare il dashboard localhost:1441 sul tuo computer di sviluppo.

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

Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale. La console di debug locale crea inoltre un certificato per proteggere la connessione se si abilita HTTPS nella configurazione del componente. HTTPS è abilitato per impostazione predefinita.

Usa la AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella principale AWS IoT Greengrass V2 .

L'output del comando è simile all'esempio seguente se la console di debug locale è stata configurata per utilizzare HTTPS. Le impronte digitali del certificato vengono utilizzate per verificare che la connessione sia sicura quando si apre la console di debug locale.

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

Il componente di visualizzazione debug crea una sessione della durata di 8 ore. Dopodiché, è necessario generare una nuova password per visualizzare nuovamente la console di debug locale.

Apri e accedi alla dashboard. Visualizza la dashboard sul tuo dispositivo principale Greengrass o sul tuo computer di sviluppo se inoltri la porta tramite SSH. Esegui una delle seguenti operazioni:

• Se hai abilitato HTTPS nella console di debug locale, che è l'impostazione predefinita, procedi come segue:

  1. Apri https://localhost:1441 sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

     Il tuo browser potrebbe mostrare un avviso di sicurezza relativo a un certificato di sicurezza non valido.

  2. Se il browser mostra un avviso di sicurezza, verifica che il certificato sia legittimo e ignora l'avviso di sicurezza. Esegui questa operazione:

     1. Individua l' SHA-1 impronta digitale SHA-256 o del certificato e verifica che corrisponda all' SHA-1 impronta digitale SHA-256 o stampata in precedenza dal get-debug-password comando. Il browser potrebbe fornire una o entrambe le impronte digitali. Consulta la documentazione del browser per visualizzare il certificato e le relative impronte digitali. In alcuni browser, l'impronta digitale del certificato è denominata impronta digitale.

        Nota

        Se l'impronta digitale del certificato non corrisponde, accedi Passo 2 a Crea una nuova sessione. Se l'impronta digitale del certificato continua a non corrispondere, la connessione potrebbe non essere sicura.

     2. Se l'impronta digitale del certificato corrisponde, ignora l'avviso di sicurezza del browser per aprire la console di debug locale. Consulta la documentazione del tuo browser per aggirare l'avviso di sicurezza del browser.

  3. Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza dal get-debug-password comando.

     Si apre la console di debug locale.

  4. Se la console di debug locale mostra un errore che indica che non può connettersi a WebSocket causa di un handshake TLS fallito, devi ignorare l'avviso di sicurezza autofirmato per l'URL. WebSocket

     

     Esegui questa operazione:

     1. Apri https://localhost:1442 nello stesso browser in cui hai aperto la console di debug locale.

     2. Verifica il certificato e ignora l'avviso di sicurezza.

        Il tuo browser potrebbe mostrare una pagina HTTP 404 dopo aver ignorato l'avviso.

     3. Apri di https://localhost:1441 nuovo.

        La console di debug locale mostra le informazioni sul dispositivo principale.

• Se hai disabilitato HTTPS nella console di debug locale, procedi come segue:

  1. Apri http://localhost:1441 sul tuo dispositivo principale o aprilo sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

  2. Accedi al sito Web utilizzando il nome utente e la password precedentemente stampati con il get-debug-password comando.

     Si apre la console di debug locale.

(Facoltativo) Per visualizzare la console di debug locale sul computer di sviluppo, puoi inoltrare la porta della console tramite SSH. Tuttavia, devi prima abilitare l'AllowTcpForwardingopzione nel file di configurazione SSH del tuo dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il seguente comando sul tuo computer di sviluppo per visualizzare la dashboard localhost:1441 sul tuo computer di sviluppo.

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

Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale.

Usa la AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella principale AWS IoT Greengrass V2 .

L'output del comando è simile all'esempio seguente.

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

Il componente di visualizzazione debug crea una sessione della durata di 4 ore, quindi è necessario generare una nuova password per visualizzare nuovamente la console di debug locale.

Aprilo http://localhost:1441 sul tuo dispositivo principale o aprilo sul tuo computer di sviluppo se hai inoltrato la porta tramite SSH.

Accedi al sito Web utilizzando il nome utente e la password precedentemente stampati con il get-debug-password comando.

Si apre la console di debug locale.