[skip ci] update nabto manual

pull/634/head
cronyx 2023-02-04 13:22:01 +03:00
parent 2ad030ec31
commit f9b2506cbb
2 changed files with 38 additions and 4 deletions

View File

@ -4,16 +4,27 @@ The package includes the tcp_tunnel_device assembly from sdk. The example shows
###### Registration ###### Registration
To configure the camera, you will need to register in the [Nabto Cloud Console](https://console.cloud.nabto.com) and get the `Product-ID` (pr-xxxxxxxxx) and `Deviсe-ID` (de-xxxxxxxxx). To configure the camera, you will need to register in the [Nabto Cloud Console](https://console.cloud.nabto.com) and get the `Product-ID` (pr-xxxxxxxx) and `Deviсe-ID` (de-xxxxxxxx).
for each device to be connected, the `fingerprint` for completion will be received only after the camera has been configured. for each device to be connected, the `fingerprint` for completion will be received only after the camera has been configured.
###### Camera setup ###### Camera setup
Start `tcp_tunnel_device` with key `--demo-init` and enter data (pr-xxxxxxxxxx & de-xxxxxxxxxx) obtained during registration in [Nabto Cloud Console](https://console.cloud.nabto.com) and creation of device. Start `tcp_tunnel_device` with key `--demo-init` and enter data (pr-xxxxxxxx & de-xxxxxxxx) obtained during registration in [Nabto Cloud Console](https://console.cloud.nabto.com) and creation of device.
Then select the proxied service, in this case `rtsp` and specify endpoint `/stream=0`: Then select the proxied service, in this case `rtsp` and specify endpoint `/stream=0`:
``` ```
root@openipc-t31:# tcp_tunnel_device --demo-init
No device configuration found. Creating configuration: /home/user/.nabto/edge/config/device.json.
The device configuration requires a Product ID and a Device ID, created in the Nabto Cloud Console.
Product Id: pr-ydk3xhyn
Device Id: de-orruyc4n
Demo initialization will make a simple IAM setup, be aware that this is not what you want in production.
'Local Open Pairing' and 'Password Open Pairing' are enabled. Newly paired users get the 'Administrator' role.
Next step is to add TCP tunnel services. Next step is to add TCP tunnel services.
What type of service do you want to add? What type of service do you want to add?
[0]: continue [0]: continue
@ -28,6 +39,12 @@ Added rtsp service on localhost port 554 with metadata rtsp-path => /stream=0
When finished, a `fingerprint` will be issued, which must be saved in the device settings in the cloud. When finished, a `fingerprint` will be issued, which must be saved in the device settings in the cloud.
```
The configuration and state has been initialized
The Fingerprint must be configured for this device in the Nabto Cloud Console before it will be allowed to attach to the Basestation. If you want to reuse an already configured fingerprint, you can copy the corresponding private key to /home/user/.nabto/edge/keys/device.key
The device Fingerprint is: 3de2ec6ded2cc975bf87ed63b2303e02b8051fb7359b19a3d950ed0158bb3813
```
###### Launch ###### Launch
``` ```
@ -72,7 +89,7 @@ There are 2 ways of "pairing" - `Local Open` and `Password Open`. The first mode
As a universal example, we will use the variant with a remote device. As a universal example, we will use the variant with a remote device.
Run `edge_tunnel_client` with the key `--pair-string` and a string with the necessary device credentials `p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe`. Run `edge_tunnel_client` with the key `--pair-string` and a string with the necessary device credentials `p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe`.
The string is already present in the output of the camera connected to the cloud, so just copy it from the previous step of the camera setup and select `(0) Open Password`, when asked for username we specify `admin`: The string is already present in the output of the camera connected to the cloud, so just copy it from the previous step of the camera setup and select `0` - Password Open, when asked for New username we specify `admin`:
``` ```
$./edge_tunnel_client --pair-string p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe $./edge_tunnel_client --pair-string p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe

View File

@ -15,6 +15,17 @@
Далее выбрать проксируемый сервис, в данном случае `rtsp` и указать endpoint `/stream=0`: Далее выбрать проксируемый сервис, в данном случае `rtsp` и указать endpoint `/stream=0`:
``` ```
root@openipc-t31:# tcp_tunnel_device --demo-init
No device configuration found. Creating configuration: /home/user/.nabto/edge/config/device.json.
The device configuration requires a Product ID and a Device ID, created in the Nabto Cloud Console.
Product Id: pr-ydk3xhyn
Device Id: de-orruyc4n
Demo initialization will make a simple IAM setup, be aware that this is not what you want in production.
'Local Open Pairing' and 'Password Open Pairing' are enabled. Newly paired users get the 'Administrator' role.
Next step is to add TCP tunnel services. Next step is to add TCP tunnel services.
What type of service do you want to add? What type of service do you want to add?
[0]: continue [0]: continue
@ -29,6 +40,12 @@ Added rtsp service on localhost port 554 with metadata rtsp-path => /stream=0
По окончании будет выдан `fingerprint`, который необходимо сохранить в настройках устройства в облаке. По окончании будет выдан `fingerprint`, который необходимо сохранить в настройках устройства в облаке.
```
The configuration and state has been initialized
The Fingerprint must be configured for this device in the Nabto Cloud Console before it will be allowed to attach to the Basestation. If you want to reuse an already configured fingerprint, you can copy the corresponding private key to /home/user/.nabto/edge/keys/device.key
The device Fingerprint is: 3de2ec6ded2cc975bf87ed63b2303e02b8051fb7359b19a3d950ed0158bb3813
```
###### Запуск ###### Запуск
``` ```
tcp_tunnel_device tcp_tunnel_device
@ -71,7 +88,7 @@ Attached to the basestation
В качестве универсального примера используем вариант с удаленным устройством. В качестве универсального примера используем вариант с удаленным устройством.
Запускаем `edge_tunnel_client` с ключом `--pair-string` и строкой с необходимыми учетными данными устройства `p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe`. Запускаем `edge_tunnel_client` с ключом `--pair-string` и строкой с необходимыми учетными данными устройства `p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe`.
Строка в готовом виде присутствует в выводе подключенной к облаку камеры, потому просто копируем ее из предыдущего шага настройки камеры и выбираем `(0) Open Password`, при запросе username укажем `admin`: Строка в готовом виде присутствует в выводе подключенной к облаку камеры, потому просто копируем ее из предыдущего шага настройки камеры и выбираем `0` - Password Open, при запросе New username укажем `admin`:
``` ```
$./edge_tunnel_client --pair-string p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe $./edge_tunnel_client --pair-string p=pr-ydk3xhyn,d=de-orruyc4n,pwd=X9NphkArpzLU,sct=9jLgbUb4FWhe