GSW ConnectBot Android Client  for use with SSH/Telnet and now includes the GSW Enterprise Browser

 

 

 

 

Text Box: GSW ConnectBot and 
Licensing and Deployment Server (LADS)
 

 

 

 

 

 

 

 

 

 


User’s Guide

 

 

Logo

Description automatically generated

 


 

 

 

 

 

 

THIS PAGE INTENTIONALLY LEFT BLANK


Georgia SoftWorks

Public Square

17 Hwy 9 South, PO Box 729

Dawsonville Georgia 30534

Telephone +1 706.265.1018 * Fax +1 706.265.1020

Visit Georgia SoftWorks web site

 

Copyright © Georgia SoftWorks, 2022 All Rights Reserved. Images and screenshots used in this document may not represent the latest version of GSW ConnectBot, or the version in use by the reader.

Google, Android, Google Play, ConnectBot, are trademarks of their respective companies.

GSW DOC UGECB002022022

THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

LICENSOR MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED, ORAL OR WRITTEN, REGARDING THE PROGRAM OR DOCUMENTATION AND HEREBY EXPRESSLY DISCLAIMS ALL OTHER EXPRESS OR IMPLIED WARRANTIES, INCLUDING MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. LICENSOR DOES NOT WARRANT THE PROGRAM WILL MEET YOUR REQUIREMENTS OR THAT ITS OPERATION WILL BE UNINTERRUPTED OR ERROR FREE.

IN NO EVENT WILL GEORGIA SOFTWORKS BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE SUCH PROGRAMS.

LICENSE:

YOU ARE LICENSED FOR AN INSTANCE OF THE GSW CONNECTBOT CLIENT SOFTWARE ON A SINGLE SPECIFIC DEVICE. ANY ATTEMPT TO DUPLICATE THE LICENSE IS IN VIOLATION OF THIS AGREEMENT.  THE GSW CONNECTBOT SOFTWARE MAY BE INSTALLED ON A SINGLE ANDROID DEVICE.


 

Table of Contents

Terms, Icons and Conventions. 3

Overview.. 5

Quick Start SSH Configuration. 6

Quick Start GSW Enterprise Browser Configuration. 7

Installation. 8

Installation from Google Play. 9

Installation from Download. 9

Example 1. Using a USB Connection. 9

Enable “Unknown Sources”. 10

Example: 11

Generalized terse messages that require enabling from unknown sources. 11

Copy and Install APK to Device - Sideloading. 14

Launching GSW ConnectBot 16

Registration of the GSW ConnectBot License. 17

Check the License Status. 17

Registration by GSW Licensing and Deployment Server (LADS) 24

Return License to License and Deployment Server (LADS) 26

Manual Registration. 27

Example: Create Product ID. 28

Apply Serial Number 32

Update the GSW ConnectBot software. 35

Updating Software by Licensing and Deployment Server (LADS) 36

Updating Software by manually obtaining gsw-connectbot.apk. 39

Updating Software by URL. 41

GSW ConnectBot Host Configuration and Connections. 44

Create new Host Connection Configuration. 45

Host Connection Operations. 48

Initiate Connection. 49

Session Menu. 49

2-Tap Screenshot 52

Host Connection Menu. 53

Disconnect 53

Edit Host 53

Edit Port Forward. 54

Edit auto response fields. 55

Delete Host Connection. 56

Security Information. 57

Global Settings. 58

Automatic provisioning. 60

Remember keys in memory. 60

Persist connections. 60

Keep Wi-Fi active. 60

Backup pubkeys. 60

Emulation mode. 60

Scrollback size. 60

Rotation mode. 60

Auto hide title bar 60

Full screen. 60

Page up/down gesture. 60

Volume keys change font size. 61

Keep Screen awake. 61

Fast updates. 61

Enable  WiFi alerts. 61

Enable Battery Alerts. 61

Collect Business Intelligence data. 61

Use GSW keyboards. 61

Use GSW keyboards for web. 61

Use GSW keyboard skins. 61

Special keys always visible. 61

Shift+num are F-keys. 61

Hide Soft Keyboard. 61

Ctrl+num are F-Keys. 61

Sticky modifiers. 61

Directory shortcuts. 62

Camera shortcut 62

Bumpy arrows. 62

Audible Bell 62

Bell Volume. 62

Vibrate on bell 62

Background notification. 62

Upload screenshots to GWS LADS. 62

Show screenshot message. 62

Full Screen. 62

Status bar style. 62

Log Level 62

Clear cache on Startup. 62

Accept cookies. 63

Accept file scheme cookies. 63

Using Answerback with the GSW SSH/Telnet Server 65

Answerback Example Configuration. 66

SSH Configuration. 68

Configure a Host Connection Example 1. 68

SSH with Password Authentication. 68

Save host connection configuration. 70

Connect to the new configured connection. 70

Configure a Host Connection Example 2. 71

SSH with Public/Private Key Authentication. 71

Creating a Public/Private key pair 72

Enter the configurable parameters for the Public/Private Keys. 72

Generate (using randomness) 74

Unlock the Key. 75

Transfer the key to the SSH Server 75

Create a Key Pair using PuTTY. 76

Installing Private Key to GSW ConnectBot Android Client 78

Configuring the Host (Public) key on a GSW UTS SSH Server 81

Telnet Configuration. 85

Configure a Telnet Host Connection. 85

Managing Host Configuration with the GSW LADS. 89

Uploading an Existing Configuration. 89

Downloading an existing configuration. 92

Client Lockdown. 94

Lockdown (Pinning the app) on Android 7.0+. 95

Create one or more hosts. 95

Enable Pin Window. 96

Enable “Ask for Pin before Unpinning”. 98

Pin the Window.. 99

Unpin the Window.. 99

Admin mode vs Work mode. 100

Device Telemetry Data Variables. 101

Macros. 101

Environment Variables. 102

GSW Browser 103

GSW Browser Configuration. 104

Protocol 105

Color category. 105

ITSMobile enhancements. 105

Inject Cordova. 107

Disallow Overscroll 107

Allow remote debugging. 107

Keep running. 107

Load URL timeout 107

Append to user agent 107

Accept third party cookies. 108

Allow zoom controls. 108

URL access list 108

Allow navigation list 108

Allow Intent list 108

GSW DOM Injection syntax. 109

Overview.. 109

Attributes. 109

Examples. 110

Apache Cordova. 112

Apache Cordova Plugins. 112

Barcode Scanner (Zxing plugin) 113

Battery-Status. 114

Camera. 115

Georgia SoftWorks Scanner (cordova-plugin-gswscanner) 117

Cordova-plugin-cert-authentication. 120

Dialogs. 122

ES6-Promise. 123

GSW Variables (Telemetry Data) 124

Write to File (File Storage plugin) 125

File Transfer 126

Geolocation. 127

Media. 129

Media Capture. 130

Network. 131

Screen Orientation. 132

Statusbar 133

Vibration. 134

Whitelist 134

Zebra Bluetooth Printing. 135

GSW Licensing and Deployment Server (GSW LADS) for Windows. 136

Installing the Georgia SoftWorks Licensing and Deployment Server 137

Registering the Georgia SoftWorks Licensing and Deployment Server 140

GSW LADS Operation. 144

GSW ConnectBot LADS XML Configuration File. 144

Example: 144

Example: 145

Example: 145

Example: 145

Automatic Provisioning (Auto Discovery) 145

Manage Licensing. 148

LADS Table Utility. 150

Manage Software Updates to GSW ConnectBot 151

Upload / Download GSW ConnectBot Configuration. 152

Zero Touch Configuration. 153

Rapid 2-Tap Screen Shot Upload to GSW LADS. 154

Public/Private Key Import/Export 155

Custom Keyboards. 155

Standard GSW Keyboards. 155

Business Intelligence (BI) 157

Understanding Business Intelligence (BI) Data. 158

GSW Business Intelligence Data Collection – Overview.. 159

Events.txt Format 160

eventHandler.ps1 Format 162

Message ID Codes. 163

GSW ConnectBot Events Overview.. 163

GSW Keyboard Events. 164

Message ID code:  1000 – Key code. 165

Message ID code:  1001 – Key Output text 166

Message ID code:  1100 – Keyboard Selected. 167

GSW Host Events. 168

ID code:  1200 Host Launched. 168

ID code:  1201   Connected to a TE Host 168

ID code:  1300 Web Page Loaded. 169

ID code:  1301 Web Request Not Allowed. 169

ID code:  1302 Top Level URL’s Not Allowed. 170

ID code:  5000 GSW Unified Scanner Interface Receives Scanned Data from Web Host 170

GSW ConnectBot Screen Recognition Events. 171

Message ID code:  1500 – Screen Recognition. 171

GSW ConnectBot General Events. 172

ID code:  2000   Battery Level 172

ID code:  2100 WIFI Level 172

Android Application States. 174

Message ID code:  3000   GSW ConnectBot application started. 175

Message ID code:  3002   GSW ConnectBot Activity Resumed. 176

GSW LADS Events. 177

ID code:  100000   Message License Count info. 177

ID code:  100001   Message License Obtained. 177

ID code:  100002   Message License Released. 178

ID code:  100100   Message Device Telemetry Data variable change. 178

PowerShell eventHandler.ps1. 179

Screen Recognition / Custom Keyboard association. 180

Understanding Screen Recognition. 181

GSW LADS Database. 181

Custom GSW Keyboards. 182

GSW Standard Keyboards. 184

Technical Support 195

 

 

 


 

Table of Figures

Figure 1: Host Connections / Host Configurations. 3

Figure 2: Overflow menu. 4

Figure 3: Where to obtain GSW ConnectBot 5

Figure 4: SSH Quick Start 6

Figure 5: GSW Enterprise Browser - Quick Start 7

Figure 6: First time installation Android 8+. 8

Figure 7: First time installation Android 7.x and lower 8

Figure 8: GSW ConnectBot Google Play. 9

Figure 9: Android device listed in Windows Explorer 10

Figure 10: Unknown Apps popup. 11

Figure 11: App specific Allow from Source Setting. 11

Figure 12: Enable App specific Allow from this source. 11

Figure 13: Terse Alert Message Writing to SDCard. 12

Figure 14: Locate GSW ConnectBot in the app Info. Opens GSW ConnectBot app settings. 12

Figure 15: Tap Advanced. 12

Figure 16: Tap Install unknown apps. 12

Figure 17: Tap Allow from this source. 12

Figure 18: Allow from this source is enabled. 12

Figure 19: Set Unknown Sources. 13

Figure 20: APK on device. 14

Figure 21: Install screen. 14

Figure 22: Installation progress bar 15

Figure 23: Installation complete. 15

Figure 24: Admin and Work Modes. 16

Figure 25: Hosts - More Options. 18

Figure 26: Hosts - Licensing. 18

Figure 27: Check License Info. 19

Figure 28: Tap Continue to see License Info. 19

Figure 29: Free Temporary Manual License Found. 20

Figure 30: Temporary Manual License Expired. 20

Figure 31:  Subscription Expired. 21

Figure 32: Permanent License - Manual Registration. 23

Figure 33: Permanent License Applied – GSW LADS. 23

Figure 34: Register Using GSW LADS. 24

Figure 35: Automatically Locate GSW LADS. 24

Figure 36: GSW LADS Server is Located. 25

Figure 37: Get License for GSW LADS. 25

Figure 38: Product License retrieved from GSW LADS. 25

Figure 39: Return GSW ConnectBot License from device. 26

Figure 40: Notification that the License was successfully released. 26

Figure 41: Permanent License – Serial Number 27

Figure 42: Permanent License - Continue. 27

Figure 43: Create Product ID. 28

Figure 44: Allow access if needed. 28

Figure 45: Close Dialog. 29

Figure 46:  Product ID created. 30

Figure 47: request.c2g placed in root/android/data/com.gsw.connectbot/files. 30

Figure 48: Request .c2g placed in root - v2.7.067 and lower 30

Figure 49: Copy serial.g2c to root folder described. 32

Figure 50: Apply Serial Number from file. 32

Figure 51: Locate the serial.g2c file. 33

Figure 52: Serial Number Applied Successfully. 33

Figure 53: All Done, Tap Continue. 33

Figure 54: Paste Serial Number 34

Figure 55: Tap APPLY after pasting serial number 34

Figure 56: Admin Mode - Update software. 35

Figure 57: Work Mode - Update Software. 35

Figure 58: Hosts - More Options - Update. 36

Figure 59: Tap Update. 36

Figure 60: Update TAP GSW LADS. 37

Figure 61: TAP Continue. 37

Figure 62: Check for Update. 37

Figure 63: Use GSW LADS Update Screen. 37

Figure 64: Locate GSW LADS. 37

Figure 65: GSW LADS - Update Found. 38

Figure 66: GSW LADS - running latest version. 38

Figure 67: Install Update. 39

Figure 68: May be prompted to allow access to photos. 39

Figure 69:  Update is downloading. 39

Figure 70: Install Update. 39

Figure 71: Tap Open to launch. 39

Figure 72: Select version to install 40

Figure 73: Tap install 40

Figure 74: Tap the overflow menu. 41

Figure 75: Tap Update. 41

Figure 76: Select Use URL. 41

Figure 77: Tap Continue. 42

Figure 78: Tap Check For Updates. 42

Figure 79: Update Found - Tap OK. 42

Figure 80: Install Update button highlighted. 43

Figure 81: You may a security prompt - tap Allow.. 43

Figure 82: Tap Install 43

Figure 83: Installed. 43

Figure 84: Creating a Host 44

Figure 85: Configuring a Host connection. 46

Figure 86: Host Connection Screen Display. 48

Figure 87: Session overflow menu. 49

Figure 88: Cordova Examples Home Page. 50

Figure 89: Industrial Browser Overflow Menu. 50

Figure 90: Tap 1 - Tap overflow menu. 52

Figure 91: Tap 2 - Tap Screenshot 52

Figure 92: Success. This prompt can be disabled in the Global Settings. 52

Figure 93: Telnet/SSH Host List - Long Press Menu. 53

Figure 94: Web Host List - Long Press Menu. 53

Figure 95: Create Auto-Response field. 55

Figure 96: Edit Auto Response Field. 55

Figure 97: Auto Response Field completed. 55

Figure 98:  Auto Response created. 56

Figure 99: Secure Algorithms. 57

Figure 100: Un-Secure Algorithms. 57

Figure 101: Menu to access Global configuration. 58

Figure 102: Accessing Settings. 58

Figure 103: Select Settings. 58

Figure 104: Global Settings Menu. 64

Figure 105: Answerback Settings. 65

Figure 106: Creating a Host 68

Figure 107: Enter Host Information. 69

Figure 108: Use pubkey authentication setting in Edit Host 71

Figure 109: If multiple keys are needed. 71

Figure 110: Select Use any unlocked key (Default) or choose specific key. 71

Figure 111: Saving the Connection Installing Private Key to GSW ConnectBot Android Client 72

Figure 112: Tap the Overflow Menu. 73

Figure 113: Tap Manage Pubkeys. 73

Figure 114: Tap "+". 74

Figure 115: Add Nickname (Password is optional) and check Load key on start 74

Figure 116: Tap Generate. 74

Figure 117: Generate Randomness for Keys. 75

Figure 118: Generate Randomness until 100%.. 75

Figure 119: Locked Key. 75

Figure 120: Enter password if added. 75

Figure 121: Unlocked Key. 75

Figure 122: Tap Copy public key. 76

Figure 123: Open PuTTYgen. 76

Figure 124: Generate Randomness. 77

Figure 125: Enter Passphrase. 77

Figure 126: GSW ConnectBot Admin Icon. 78

Figure 127: Tap overflow menu. 78

Figure 128: Tap Manage Pubkeys. 78

Figure 129: Tap folder icon. 78

Figure 130: Select Public Key. 79

Figure 131: Tap key to unlock. 80

Figure 132: Enter Password if prompted. 80

Figure 133: Key is unlocked. 80

Figure 134: Certificate Mapping Tool 81

Figure 135: Example of pubkeys.xml uploaded to GSW LADS from key generated on GSW ConnectBot 82

Figure 136: Example of public key generated by puTTYgen. 82

Figure 137: Example of public key generated on GSW ConnectBot to clipboard. 82

Figure 138: Installing Public Key. 83

Figure 139: Key Installed. 83

Figure 140: Restart SSH Service. 84

Figure 141: Creating a Host 85

Figure 142: Defining a Telnet Host 86

Figure 143: Enter Telnet Configuration Information. 87

Figure 144: Connection Settings. 88

Figure 145: Saving the Connection. 88

Figure 146: Tap Upload configuration from the overflow menu. 89

Figure 147: Locate GSW LADS. 89

Figure 148: Upload Configuration. 90

Figure 149: Upload Complete. 90

Figure 150: Copy upload configuration to download folder 90

Figure 151: GSW LADS Config File shortcut 91

Figure 152: Tap Download Configuration. 92

Figure 153: Select Configuration. 92

Figure 154: Tap download configuration. 93

Figure 155: Configuration download in progress. 93

Figure 156: Configuration download successful 93

Figure 157: Two Modes of Connection. 94

Figure 158: Create Host(s) 95

Figure 159: Settings Icon. 96

Figure 160: Tap Security Setting. 96

Figure 161: Pin Windows Option. 97

Figure 162: Ask for PIN before unpinning. 98

Figure 163: Pinning the Window.. 99

Figure 164: GSW ConnectBot - Admin Mode. 100

Figure 165: GSW ConnectBot Work Mode. 100

Figure 166: HTTPS Protocol Configuration Menu. 104

Figure 167: SAP ITS Mobile with GSW Enhancements Disabled. 105

Figure 168: SAP ITS Mobile with GSW Enhancements Enabled. 105

Figure 169: Enable ITSMobile Enhancements Shows Skin Menu. 106

Figure 170: Skin options menu. 106

Figure 171: ITSMobile Skin Options. 107

Figure 172: GSW Browser Barcode Scanner Plugin Example. 113

Figure 173: GSW Broswer Battery Status Plugin Example. 114

Figure 174: GSW Broswer Camera Plugin Example. 116

Figure 175: GSW Scanner Pluggin Example. 120

Figure 176: GSW Browser Device Variables Plugin. 121

Figure 177: GSW Browser Dialogs and Alerts Plugin Example. 122

Figure 178: GSW Variables / Device Plugin. 124

Figure 179: GSW Browser File Storage Plugin Example. 125

Figure 180: GSW Browser File Transfer Plugin Example. 126

Figure 181: GSW Browser Geo Location Plugin Example. 128

Figure 182: GSW Browser Media Player Plugin Example. 129

Figure 183: GSW Browser Media Capture Plugin Example. 130

Figure 184: Network Plugin Example. 131

Figure 185: GSW Browser Screen Orientation Plugin Example. 132

Figure 186: GSW Browser Status Bar Plugin Example. 133

Figure 187: GSW Broswer Vibration Plugin Example. 134

Figure 188: Zebra Bluetooth Printing Plugin Example. 135

Figure 189: LADS components. 136

Figure 190: GSW LADS setup program.. 137

Figure 191: User Account Control Dialog. 137

Figure 192: Setup progress bar 137

Figure 193: Welcome. 138

Figure 194: Installation Location. 138

Figure 195: Install folder 139

Figure 196: Setup Complete. 139

Figure 197: LADS Registration UAC dialog. 140

Figure 198: GSW LADS registration tool opens. 141

Figure 199: Registration Tool with completed information. 141

Figure 200: Registration Tool - Serial Number Entered. 143

Figure 201: Registration Successful 143

Figure 202: Retry Discovery. 146

Figure 203: Searching network for GSW LADS. 146

Figure 204: Enter GSW LADS IP Address manually. 146

Figure 205: Enter IP where GSW LADS is located. 146

Figure 206: I am not using GSW LADS, Disable GSW LADS. 147

Figure 207: Automatic Provisioning disabled in Global Settings. 147

Figure 208: Go to Hosts List screen to configure connection. 147

Figure 209: Taken to Hosts List screen not changes made. 147

Figure 210: GSW License Manager tool 148

Figure 211: Release License - Notice Available License Count 149

Figure 212: Enter Android ID, Click Release License. 149

Figure 213: License Released Confirmation. 149

Figure 214: Release License - Notice Available License Count Incremented. 149

Figure 215: LADSTble.exe folder 150

Figure 216: Output of LADSTbl.exe utility. 150

Figure 217: GSW LADS - Software Updates. 151

Figure 218: Apk and .json located in the GSW LADS files folder 151

Figure 219: GSW LADS Config Upload/Download folders. 152

Figure 220: Easy access to the Config Files via Windows Start Menu. 152

Figure 221: Hosts List - Select Upload Configuration. 153

Figure 222: Set Tag field to "Default". 153

Figure 223: Tap Upload Configuration. 153

Figure 224: Upload Progress bar 153

Figure 225: Uploaded Successfully. 153

Figure 226: GSW LADS Screen Shot storage location. 154

Figure 227: Examples of stored Screen shots. 154

Figure 228: pubkey.xml located on GSW LADS. 155

Figure 229: Swipe - Qwerty Customer Keyboard. 156

Figure 230: Swipe - Special Characters Customer Keyboard. 156

Figure 231: BI example charts. 157

Figure 232: More BI example charts.