Changes for page Remote Access Gateway
Last modified by Kilight Cao on 2022/07/25 10:47
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,12 +1,11 @@ 1 - ** Table ofContents:**1 + **Contents:** 2 2 3 3 {{toc/}} 4 4 5 5 6 6 7 -= **1. 7 += **1. Use Remote.it service** = 8 8 9 - 10 10 Remote.it for remote access is available in the latest Dragino firmware for gateway. For security concern, the remote.it only available base on end user demand. 11 11 12 12 (% style="color:red" %)**Important Notice:** ... ... @@ -17,9 +17,8 @@ 17 17 For how to use remoteit, please see : [[Remoteit user instruction for Dragino Gateway>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/&file=Dragino-Remoteit_User_Manual.pdf]]. 18 18 19 19 20 -= **2. 19 += **2. RSSH Introduction** = 21 21 22 - 23 23 Reverse SSH for remote access is available in the latest Dragino firmware for gateway. For security concern, the RSSH only available base on end user demand. 24 24 25 25 (% style="color:red" %)**Important Notice:** ... ... @@ -38,12 +38,10 @@ 38 38 * MS14 series if installed with the same firmware. 39 39 40 40 41 -== **2.1 39 +== **2.1 For Firmware Version lower than lgw~-~-build-v5.4.1616478814-20210323-1355** == 42 42 41 +=== **2.1.1 End User Guide to use SSH access** === 43 43 44 -=== **2.1.1 End User Guide to use SSH access** === 45 - 46 - 47 47 Go to this the Reverse SSH page as below: 48 48 49 49 [[image:image-20220527102348-1.png]] ... ... @@ -55,11 +55,11 @@ 55 55 56 56 Connection OK. 57 57 58 -* (% style="color:#4f81bd" %)**Login ID**(%%): 59 -* (% style="color:#4f81bd" %)**Host Address**(%%): 60 -* (% style="color:#4f81bd" %)**Host Port**(%%): 54 +* (% style="color:#4f81bd" %)**Login ID**(%%): Input (% style="color:#4f81bd" %)**sshuser** 55 +* (% style="color:#4f81bd" %)**Host Address**(%%): Input** (% style="color:#4f81bd" %)support.dragino.com(%%)** 56 +* (% style="color:#4f81bd" %)**Host Port**(%%): Please email to support @ dragino.com to get a valid host port. 61 61 * (% style="color:#4f81bd" %)**Connect at Startupt**(%%): Choose to enable connect once device is powered. 62 -* (% style="color:#4f81bd" %)**Network Keys: 58 +* (% style="color:#4f81bd" %)**Network Keys:**(%%)Click the Generate keys to generate the keys and download / mail it to Dragino support so Dragino can prepare the remote access to 63 63 64 64 ((( 65 65 After doing above, please download and mail the public keys to Dragino support and wait for our mail for the valid host port. Input the valid host port got from our support and click connect so we can remote access to your gateway. ... ... @@ -66,10 +66,8 @@ 66 66 ))) 67 67 68 68 65 +=== **2.1.2 How to Ser up a Reverse SSH access** === 69 69 70 -=== **2.1.2 How to Ser up a Reverse SSH access** === 71 - 72 - 73 73 Advance administrator can config a SSH server to provide support their end user themselves. Instruction is as below: 74 74 75 75 1. Prepare a Linux server with public IP. The gateways need to be able to create SSH connection to this server. We recommend to use a server that performs no other function than to support the RSSH access, and to have no additional accounts active, and no access from the Internet that uses ID/password authentication. ... ... @@ -88,9 +88,8 @@ 88 88 ))) 89 89 90 90 85 +==== **2.1.2.1 Note for set up RSSH server** ==== 91 91 92 -==== **2.1.2.1 Note for set up RSSH server** ==== 93 - 94 94 If gateway reboot or the connection is incidentely close by end node. The port in SSH server will still be occupy for a long time. Administrator can use below commands to release the port. 95 95 96 96 (% class="box" %) ... ... @@ -104,7 +104,7 @@ 104 104 ))) 105 105 106 106 107 -== **2.2 100 +== **2.2 For Firmware Version higher than lgw~-~-build-v5.4.1618196981-20210412-1111** == 108 108 109 109 Below gateway support reverse SSH access: 110 110 ... ... @@ -119,23 +119,20 @@ 119 119 ))) 120 120 121 121 122 -=== **2.2.1 115 +=== **2.2.1 End User Guide to use SSH access** === 123 123 117 +==== **2.2.1.1 Install the SSH service for server** ==== 124 124 125 -==== **2.2.1.1 Installthe SSH servicefor server** ====119 +===== **2.2.1.1.1 Step 1 : Download the SSH service code** ===== 126 126 121 +1).git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server 127 127 128 -===== (% style="color:blue" %)**Step 1 : Download the SSH service code**(%%) ===== 129 - 130 - 131 -**1). **git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server 132 - 133 133 [[image:image-20220527105447-1.png]] 134 134 135 135 git clone rssh-server 136 136 137 137 138 - **2).**cd rssh-server; sudo make ~-~--> to Generate the execute file:rssh_serv128 +2).cd rssh-server; sudo make ~-~--> to Generate the execute file:rssh_serv 139 139 140 140 [[image:image-20220527105511-2.png]] 141 141 ... ... @@ -171,30 +171,24 @@ 171 171 lack of sqlite3 172 172 173 173 174 - (% style="color:blue" %)**How to install Sqlit3:**164 +How to install Sqlit3 175 175 176 176 (% class="box" %) 177 177 ((( 178 - **Step1:**Download the SQLit3 installation package168 +Step1: Download the SQLit3 installation package 179 179 sudo wget [[https:~~/~~/www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz>>url:https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz]] 180 - 181 -**Step2:** tar the SQLit3 installation package 170 +Step2: tar the SQLit3 installation package 182 182 sudo tar -zxvf sqlite-autoconf-3350300.tar.gz 183 - 184 -**Step3:** Generate the makefile 172 +Step3: Generate the makefile 185 185 cd sqlite-autoconf-3350300/;./configure 186 - 187 -**Step4:** Compile makefile 174 +Step4: Compile makefile 188 188 sudo make 189 - 190 -**Step5: **Install makefile 176 +Step5: Install makefile 191 191 sudo make install 192 - 193 -**Check:** 178 +Check: 194 194 cd /usr/local/bin;ls -al ~-~-> Check to see if there is a file for sqlite3 195 195 cd sqlite-autoconf-3350300/;./sqlite3 test.db ~-~-> Test whether the sqlite3 was installed successfully 196 - 197 -**debug:** 181 +debug: 198 198 If you get the imformation that is SQLite header and source version mismatch, when you execute./sqlite3 test.db. 199 199 Please execute the command /sbin/ldconfig. 200 200 After that execute the command ./sqlite3 test.db again. ... ... @@ -201,12 +201,10 @@ 201 201 ))) 202 202 203 203 188 +===== **2.2.1.1.2 Step 2 : Install and run the RSS service** ===== 204 204 205 - =====(% style="color:blue"%)**Step2 :Installand run theRSS service**(%%)=====190 +1): intall database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721) 206 206 207 - 208 -**1):** intall database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721) 209 - 210 210 user must enter the root account and run the following commands 211 211 212 212 (% class="box" %) ... ... @@ -220,7 +220,6 @@ 220 220 221 221 intall database and server development port 222 222 223 - 224 224 **Debug:** 225 225 226 226 (% class="box" %) ... ... @@ -236,10 +236,8 @@ 236 236 ))) 237 237 238 238 220 +===== **2.2.1.1.3 Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)** ===== 239 239 240 -===== (% style="color:blue" %)**Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ===== 241 - 242 - 243 243 **1): (% style="color:#4f81bd" %)sudo useradd XXXXX(%%)** (custom user name) 244 244 245 245 **2):** (% style="color:#4f81bd" %)**sudo passwd xxxxxx** ... ... @@ -252,28 +252,22 @@ 252 252 253 253 **6):** (% style="color:#4f81bd" %)**sudo nano /home/xxxxx/.bash_profile**(%%) **empty it,and input export PATH=$HOME/bin** 254 254 234 +**Now user "XXXXX" is the user with limited permissions of the current system** 255 255 256 -(% style="color:red" %)**Now user "XXXXX" is the user with limited permissions of the current system** 257 257 237 +=== **2.2.2 How does user get the gateway to connect to a user's private server** === 258 258 239 +===== **2.2.2.1 Step 1 : Come bace the gateway web UI for get the gateway Public key** ===== 259 259 260 - ===**2.2.2How does user getthegatewayo connecttoa user'sprivate server**===241 +1) in the system ~-~-> (% style="color:#4f81bd" %)**Remote Mgmt/span>** 261 261 262 - 263 -===== (% style="color:blue" %)**Step 1 : Come bace the gateway web UI for get the gateway Public key**(%%) ===== 264 - 265 - 266 -**1) **in the system ~-~-> (% style="color:#4f81bd" %)**Remote Mgmt** 267 - 268 268 [[image:image-20220527110531-7.png]] 269 269 270 270 Remote Mgmt 271 271 272 272 248 +===== **2.2.2.2 Step 2 : Authorization server** ===== 273 273 274 -===== (% style="color:blue" %)**Step 2 : Authorization server**(%%) ===== 275 - 276 - 277 277 copy the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file. 278 278 279 279 [[image:image-20220527110625-8.png]] ... ... @@ -281,10 +281,8 @@ 281 281 Publickey 282 282 283 283 257 +===== **2.2.2.3 Step 3 : connecte private server** ===== 284 284 285 -===== (% style="color:blue" %)**Step 3 : connecte private server**(%%) ===== 286 - 287 - 288 288 in the gateway web UI 289 289 290 290 [[image:image-20220527110700-9.png]] ... ... @@ -291,22 +291,19 @@ 291 291 292 292 gateway web UI 293 293 294 - 295 295 (% class="box" %) 296 296 ((( 297 -(% style="color:#4f81bd" %)**Connection Type **(%%) :298 - (% style="color:red" %)**Note:(%%)299 -(% style="color:#4f81bd" %)**Login ID**(%%) :300 -(% style="color:#4f81bd" %)**Host Address**(%%) : 301 -(% style="color:#4f81bd" %)**Connect at Startupt**(%%): 267 +(% style="color:#4f81bd" %)**Connection Type **(%%) : If user's least privileged user with private server uses a password, select (% style="color:#4f81bd" %)**Public Key**(%%) 268 +**Note:if user's least privileged user no uses a password,choose from both is fine** 269 +(% style="color:#4f81bd" %)**Login ID**(%%) : Input user name "eg : "XXXXX" 270 +(% style="color:#4f81bd" %)**Host Address**(%%) : Input user's private server address 271 +(% style="color:#4f81bd" %)**Connect at Startupt**(%%): Choose to enable connect once device is powered. 302 302 Click Save and then Connect 303 303 ))) 304 304 305 305 276 +===== **2.2.2.4 Step 4 : Cheak is fine** ===== 306 306 307 -===== (% style="color:blue" %)**Step 4 : Cheak is fine**(%%) ===== 308 - 309 - 310 310 Rssh Host connection Ok 311 311 312 312 [[image:image-20220527111009-10.png]] ... ... @@ -321,38 +321,32 @@ 321 321 Check the gateway 322 322 323 323 292 +===== **2.2.2.5 Step 5 : Create an authorization key file** ===== 324 324 325 - ===== (%style="color:blue"%)**Step5:Create an authorizationkeyfile**(%%) =====294 +1):sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey 326 326 327 - 328 -**1):** sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey 329 - 330 330 **Debug:** 331 331 332 332 (% class="box" %) 333 333 ((( 334 - **~check: sudo ls /home/xxxxx/.ssh/authorizedkey**300 + check: sudo ls /home/xxxxx/.ssh/authorizedkey 335 335 ))) 336 336 337 337 338 -=== **2.2.3 304 +=== **2.2.3 How to Ser up a Reverse SSH access** === 339 339 306 +==== **2.2.3.1 Step 1 : Log into the server system** ==== 340 340 341 -==== (% style="color:blue" %)**Step 1 : Log into the server system**(%%) ==== 342 - 343 - 344 344 [[image:image-20220527111145-12.png]] 345 345 346 346 Loging server 347 347 348 348 313 +==== **2.2.3.2 Step 2 : access the gateway** ==== 349 349 350 -==== (% style="color:blue" %)**Step 2 : access the gateway**(%%) ==== 351 - 352 - 353 353 (% class="box" %) 354 354 ((( 355 - **$ cd rssh-server/**317 +$ cd rssh-server/ 356 356 ))) 357 357 358 358 Check the gateway linking to the server $ ./connect-gw.sh -l ... ... @@ -362,11 +362,8 @@ 362 362 Check the gateway linking to the server 363 363 364 364 365 - 366 366 access the gateway $ ./connect-gw.sh <GWID> 367 367 368 368 [[image:image-20220527111300-14.png]] 369 369 370 370 reverse ssh access the gateway 371 - 372 -