Konsol debug lokal

(Opsional) Untuk melihat konsol debug lokal pada komputer pengembangan Anda, Anda dapat meneruskan port konsol melalui SSH. Namun, Anda harus mengaktifkan opsi AllowTcpForwarding di file konfigurasi SSH perangkat inti Anda. Opsi ini diatur secara default. Jalankan perintah berikut pada komputer pengembangan Anda untuk melihat dasbor di localhost:1441 pada komputer pengembangan Anda.

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

Buat sesi untuk menggunakan konsol debug lokal. Ketika Anda membuat sesi, Anda membuat kata sandi yang Anda gunakan untuk mengautentikasi. Konsol debug lokal memerlukan kata sandi untuk meningkatkan keamanan, karena Anda dapat menggunakan komponen ini untuk melihat informasi penting dan melakukan operasi pada perangkat inti. Konsol debug lokal juga menciptakan sertifikat untuk mengamankan sambungan jika Anda mengaktifkan HTTPS dalam konfigurasi komponen. HTTPS tidak diaktifkan secara default.

Gunakan AWS IoT Greengrass CLI untuk membuat sesi. Perintah ini menghasilkan kata sandi 43 karakter acak yang akan kedaluwarsa setelah 8 jam. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass V2 root.

Perintah output terlihat seperti contoh berikut jika Anda telah mengonfigurasi konsol debug lokal untuk menggunakan HTTPS. Anda menggunakan sidik jari sertifikat untuk memverifikasi bahwa sambungan aman ketika Anda membuka konsol debug lokal.

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

Komponen tampilan debug menciptakan sesi yang berlangsung selama 8 jam. Setelah itu, Anda harus menghasilkan kata sandi baru untuk melihat konsol debug lokal lagi.

Buka dan masuk ke dasbor. Lihat dasbor pada perangkat inti Greengrass Anda, atau pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH. Lakukan salah satu hal berikut:

• Jika Anda mengaktifkan HTTPS di konsol debug lokal, yang merupakan pengaturan default, lakukan hal berikut:

  1. Buka https://localhost:1441 pada perangkat inti Greengrass Anda, atau pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH.

     Peramban Anda mungkin akan menampilkan peringatan keamanan tentang sertifikat keamanan yang tidak valid.

  2. Jika peramban Anda menampilkan peringatan keamanan, verifikasi bahwa sertifikat itu sah dan lewati peringatan keamanan. Lakukan hal-hal berikut:

     1. Temukan sidik jari SHA-256 atau SHA-1 untuk sertifikat itu, dan verifikasi bahwa ia cocok dengan sidik jari SHA-256 atau SHA-1 yang dicetak oleh perintah get-debug-password sebelumnya. Peramban Anda mungkin akan menyediakan satu atau kedua sidik jari itu. Lihat dokumentasi peramban Anda untuk melihat sertifikat dan sidik jarinya. Di beberapa peramban, sidik jari sertifikat disebut sidik jari.

        catatan

        Jika sidik jari sertifikat tidak cocok, buka Tahap 2 untuk membuat sesi baru. Jika sidik jari sertifikat masih tidak cocok, koneksi Anda mungkin tidak aman.

     2. Jika sidik jari sertifikat cocok, lewati peringatan keamanan peramban Anda untuk membuka konsol debug lokal. Lihat dokumentasi peramban Anda untuk melewati peringatan keamanan peramban.

  3. Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah get-debug-password sebelumnya.

     Konsol debug lokal terbuka.

  4. Jika konsol debug lokal menunjukkan kesalahan yang mengatakan tidak dapat terhubung ke konsol WebSocket karena jabat tangan TLS gagal, Anda harus melewati peringatan keamanan yang ditandatangani sendiri untuk URL tersebut. WebSocket

     

     Lakukan hal-hal berikut:

     1. Buka https://localhost:1442 di peramban yang sama di mana Anda membuka konsol debug lokal.

     2. Verifikasi sertifikat dan lewati peringatan keamanan.

        Peramban Anda mungkin akan menampilkan halaman HTTP 404 setelah Anda melewati peringatan.

     3. Buka https://localhost:1441 lagi.

        Konsol debug lokal menunjukkan informasi tentang perangkat inti.

• Jika Anda menonaktifkan HTTPS di konsol debug lokal, lakukan hal berikut:

  1. Buka http://localhost:1441 pada perangkat inti, atau buka pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH.

  2. Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah get-debug-password sebelumnya.

     Konsol debug lokal terbuka.

(Opsional) Untuk melihat konsol debug lokal pada komputer pengembangan Anda, Anda dapat meneruskan port konsol melalui SSH. Namun, Anda harus mengaktifkan opsi AllowTcpForwarding di file konfigurasi SSH perangkat inti Anda. Opsi ini diatur secara default. Jalankan perintah berikut pada komputer pengembangan Anda untuk melihat dasbor di localhost:1441 pada komputer pengembangan Anda.

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

Buat sesi untuk menggunakan konsol debug lokal. Ketika Anda membuat sesi, Anda membuat kata sandi yang Anda gunakan untuk mengautentikasi. Konsol debug lokal memerlukan kata sandi untuk meningkatkan keamanan, karena Anda dapat menggunakan komponen ini untuk melihat informasi penting dan melakukan operasi pada perangkat inti.

Gunakan AWS IoT Greengrass CLI untuk membuat sesi. Perintah ini menghasilkan kata sandi 43 karakter acak yang akan kedaluwarsa setelah 8 jam. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass V2 root.

Perintah output terlihat seperti contoh berikut.

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

Komponen tampilan debug menciptakan sesi yang berlangsung selama 4 jam, dan kemudian Anda harus menghasilkan kata sandi baru untuk melihat konsol debug lokal lagi.

Buka http://localhost:1441 pada perangkat inti, atau buka pada komputer pengembangan Anda jika Anda meneruskan port melalui SSH.

Masuk ke situs web dengan menggunakan nama pengguna dan kata sandi yang dicetak oleh perintah get-debug-password sebelumnya.

Konsol debug lokal terbuka.