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, 2021 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 UGECB0011152021

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. 2

Overview.. 5

Quick Start SSH Configuration. 6

Quick Start GSW Enterprise Browser Configuration. 7

Installation. 8

Installation from Google Play. 8

Installation from Download. 9

Example 1. Using a USB Connection. 9

Enable “Unknown Sources”. 10

Example: 10

Generalized terse messages that require enabling from unknown sources. 11

Copy and Install APK to Device - Sideloading. 13

Launching GSW ConnectBot 14

Registration of the GSW ConnectBot License. 15

Check the License Status. 16

Registration by GSW Licensing and Deployment Server (LADS) 21

Return License to License and Deployment Server (LADS) 23

Manual Registration. 25

Example: Create Product ID. 26

Apply Serial Number 30

Update the GSW ConnectBot software. 33

Updating Software by Licensing and Deployment Server (LADS) 34

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

Updating Software by URL. 39

GSW ConnectBot Host Configuration and Connections. 42

Create new Host Connection Configuration. 43

Host Connection Operations. 46

Initiate Connection. 47

Session Menu. 47

2-Tap Screenshot 50

Host Connection Menu. 51

Disconnect 51

Edit Host 51

Edit Port Forward. 52

Edit auto response fields. 53

Delete Host Connection. 54

Security Information. 55

Global Settings. 56

Automatic provisioning. 58

Remember keys in memory. 58

Persist connections. 58

Keep Wi-Fi active. 58

Backup pubkeys. 58

Emulation mode. 58

Scrollback size. 58

Rotation mode. 58

Auto hide title bar 58

Full screen. 58

Page up/down gesture. 58

Volume keys change font size. 59

Keep Screen awake. 59

Fast updates. 59

Collect Business Intelligence data. 59

Use GSW keyboards. 59

Use GSW keyboards for web. 59

Use GSW keyboard skins. 59

Special keys always visible. 59

Shift+num are F-keys. 59

Hide Soft Keyboard. 59

Ctrl+num are F-Keys. 59

Sticky modifiers. 59

Directory shortcuts. 59

Camera shortcut 60

Bumpy arrows. 60

Audible Bell 60

Bell Volume. 60

Vibrate on bell 60

Background notification. 60

Upload screenshots to GWS LADS. 60

Show screenshot message. 60

Full Screen. 60

Status bar style. 60

Log Level 60

Clear cache on Startup. 60

Accept cookies. 60

Accept file scheme cookies. 61

Enable  WiFi alerts. 61

Using Answerback with the GSW SSH/Telnet Server 63

Answerback Example Configuration. 64

SSH Configuration. 66

Configure a Host Connection Example 1. 66

SSH with Password Authentication. 66

Save host connection configuration. 68

Connect to the new configured connection. 68

Configure a Host Connection Example 2. 69

SSH with Public/Private Key Authentication. 69

Creating a Public/Private key pair 70

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

Generate (using randomness) 72

Unlock the Key. 72

Transfer the key to the SSH Server 73

Create a Key Pair using PuTTY. 74

Installing Private Key to GSW ConnectBot Android Client 75

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

Telnet Configuration. 83

Configure a Telnet Host Connection. 83

Managing Host Configuration with the GSW LADS. 87

Uploading an Existing Configuration. 87

Downloading an existing configuration. 90

Client Lockdown. 92

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

Create one or more hosts. 93

Enable Pin Window. 94

Enable “Ask for Pin before Unpinning”. 96

Pin the Window.. 97

Unpin the Window.. 97

Admin mode vs Work mode. 98

Device Telemetry Data Variables. 99

Macros. 99

Environment Variables. 100

GSW Browser 101

GSW Browser Configuration. 102

Protocol 103

Color category. 103

ITSMobile enhancements. 103

Inject Cordova. 105

Disallow Overscroll 105

Allow remote debugging. 105

Keep running. 105

Load URL timeout 105

Append to user agent 105

Accept third party cookies. 106

Allow zoom controls. 106

URL access list 106

Allow navigation list 106

Allow Intent list 106

GSW DOM Injection syntax. 107

Overview.. 107

Attributes. 107

Examples. 108

Apache Cordova. 110

Apache Cordova Plugins. 110

Barcode Scanner (Zxing plugin) 111

Battery-Status. 112

Camera. 113

Georgia SoftWorks Scanner (cordova-plugin-gswscanner) 115

Cordova-plugin-cert-authentication. 118

Dialogs. 120

ES6-Promise. 121

GSW Variables (Telemetry Data) 122

Write to File (File Storage plugin) 123

File Transfer 124

Geolocation. 125

Media. 127

Media Capture. 128

Network. 129

Screen Orientation. 130

Statusbar 131

Vibration. 132

Whitelist 132

Zebra Bluetooth Printing. 133

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

Installing the Georgia SoftWorks Licensing and Deployment Server 135

Registering the Georgia SoftWorks Licensing and Deployment Server 138

GSW LADS Operation. 141

GSW ConnectBot LADS XML Configuration File. 141

Example: 141

Example: 142

Example: 142

Example: 142

Manage Licensing. 143

LADS Table Utility. 145

Manage Software Updates to GSW ConnectBot 146

Upload / Download GSW ConnectBot Configuration. 147

Zero Touch Configuration. 148

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

Public/Private Key Import/Export 150

Custom Keyboards. 150

Standard GSW Keyboards. 150

Business Intelligence (BI) 152

Understanding Business Intelligence (BI) Data. 153

GSW Business Intelligence Data Collection – Overview.. 154

Events.txt Format 155

eventHandler.ps1 Format 157

Message ID Codes. 158

GSW ConnectBot Events Overview.. 158

GSW Keyboard Events. 159

Message ID code:  1000 – Key code. 160

Message ID code:  1001 – Key Output text 161

Message ID code:  1100 – Keyboard Selected. 162

GSW Host Events. 162

ID code:  1200 Host Launched. 163

ID code:  1201   Connected to a TE Host 163

ID code:  1300 Web Page Loaded. 163

ID code:  1301 Web Request Not Allowed. 164

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

GSW ConnectBot Screen Recognition Events. 166

Message ID code:  1500 – Screen Recognition. 166

The field in red “MFAChoice” is the name of the screen assigned in the screens table in the hosts.db on GSW LADS. 166

GSW ConnectBot General Events. 167

ID code:  2000   Battery Level 167

ID code:  2100 WIFI Level 167

Android Application States. 169

Message ID code:  3000   GSW ConnectBot application started. 170

Message ID code:  3002   GSW ConnectBot Activity Resumed. 171

GSW LADS Events. 172

PowerShell eventHandler.ps1. 172

Screen Recognition / Custom Keyboard association. 173

Understanding Screen Recognition. 174

GSW LADS Database. 174

Custom GSW Keyboards. 175

GSW Standard Keyboards. 177

Technical Support 188

 

 

 


 

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: Android device listed in Windows Explorer 9

Figure 9: Unknown Apps popup. 10

Figure 10: App specific Allow from Source Setting. 10

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

Figure 12: Terse Alert Message Writing to SDCard. 11

Figure 13: Locate GSW ConnectBot in the app Info. Opens GSW ConnectBot app settings. 11

Figure 14: Tap Advanced. 11

Figure 15: Tap Install unknown apps. 11

Figure 16: Tap Allow from this source. 11

Figure 17: Allow from this source is enabled. 11

Figure 18: Set Unknown Sources. 12

Figure 19: APK on device. 13

Figure 20: Install screen. 13

Figure 21: Installation progress bar 14

Figure 22: Installation complete. 14

Figure 23: Admin and Work Modes. 15

Figure 24: Hosts - More Options. 16

Figure 25: Hosts - Licensing. 16

Figure 26: Check License Info. 17

Figure 27: Tap Continue to see License Info. 17

Figure 28: Free Trial License Found. 18

Figure 29: Trial License Expired. 18

Figure 30:  Subscription Expired. 19

Figure 31: Permanent License - Manual Registration. 20

Figure 32: Temporary License Applied. 20

Figure 33: Register Using GSW LADS. 21

Figure 34: Automatically Locate GSW LADS. 21

Figure 35: GSW LADS Server is Located. 22

Figure 36: Get License for GSW LADS. 22

Figure 37: Product License retrieved from GSW LADS. 23

Figure 38: Return GSW ConnectBot License from device. 24

Figure 39: Notification that the License was successfully released. 24

Figure 40: Permanent License – Serial Number 25

Figure 41: Permanent License - Continue. 25

Figure 42: Create Product ID. 26

Figure 43: Allow access if needed. 26

Figure 44: Close Dialog. 27

Figure 45:  Product ID created. 28

Figure 46: request.c2g placed in root/android/data/com.gsw.connectbot/files. 28

Figure 47: Request .c2g placed in root - v2.7.067 and lower 28

Figure 48: Copy serial.g2c to root folder described. 30

Figure 49: Apply Serial Number from file. 30

Figure 50: Locate the serial.g2c file. 31

Figure 51: Serial Number Applied Successfully. 31

Figure 52: All Done, Tap Continue. 31

Figure 53: Paste Serial Number 32

Figure 54: Tap APPLY after pasting serial number 32

Figure 55: Admin Mode - Update software. 33

Figure 56: Work Mode - Update Software. 33

Figure 57: Hosts - More Options - Update. 34

Figure 58: Tap Update. 34

Figure 59: Update TAP GSW LADS. 35

Figure 60: TAP Continue. 35

Figure 61: Check for Update. 35

Figure 62: Use GSW LADS Update Screen. 35

Figure 63: Locate GSW LADS. 35

Figure 64: GSW LADS - Update Found. 36

Figure 65: GSW LADS - running latest version. 36

Figure 66: Install Update. 37

Figure 67: May be prompted to allow access to photos. 37

Figure 68:  Update is downloading. 37

Figure 69: Install Update. 37

Figure 70: Tap Open to launch. 37

Figure 71: Select version to install 38

Figure 72: Tap install 38

Figure 73: Tap the overflow menu. 39

Figure 74: Tap Update. 39

Figure 75: Select Use URL. 39

Figure 76: Tap Continue. 40

Figure 77: Tap Check For Updates. 40

Figure 78: Update Found - Tap OK. 40

Figure 79: Install Update button highlighted. 41

Figure 80: You may a security prompt - tap Allow.. 41

Figure 81: Tap Install 41

Figure 82: Installed. 41

Figure 83: Creating a Host 42

Figure 84: Configuring a Host connection. 44

Figure 85: Host Connection Screen Display. 46

Figure 86: Session overflow menu. 47

Figure 87: Cordova Examples Home Page. 48

Figure 88: Industrial Browser Overflow Menu. 48

Figure 89: Tap 1 - Tap overflow menu. 50

Figure 90: Tap 2 - Tap Screenshot 50

Figure 91: Success. This prompt can be disabled in the Global Settings. 50

Figure 92: Telnet/SSH Host List - Long Press Menu. 51

Figure 93: Web Host List - Long Press Menu. 51

Figure 94: Create Auto-Response field. 53

Figure 95: Edit Auto Response Field. 53

Figure 96: Auto Response Field completed. 53

Figure 97:  Auto Response created. 54

Figure 98: Secure Algorithms. 55

Figure 99: Un-Secure Algorithms. 55

Figure 100: Menu to access Global configuration. 56

Figure 101: Accessing Settings. 56

Figure 102: Select Settings. 56

Figure 103: Global Settings Menu. 62

Figure 104: Answerback Settings. 63

Figure 105: Creating a Host 66

Figure 106: Enter Host Information. 67

Figure 107: Use pubkey authentication setting in Edit Host 69

Figure 108: If multiple keys are needed. 69

Figure 109: Select Use any unlocked key (Default) or choose specific key. 69

Figure 110: Saving the Connection Installing Private Key to GSW ConnectBot Android Client 70

Figure 111: Tap the Overflow Menu. 71

Figure 112: Tap Manage Pubkeys. 71

Figure 113: Tap "+". 72

Figure 114: Add Nickname (Password is optional) and check Load key on start 72

Figure 115: Tap Generate. 72

Figure 116: Generate Randomness for Keys. 72

Figure 117: Generate Randomness until 100%.. 72

Figure 118: Locked Key. 73

Figure 119: Enter password if added. 73

Figure 120: Unlocked Key. 73

Figure 121: Tap Copy public key. 73

Figure 122: Open PuTTYgen. 74

Figure 123: Generate Randomness. 74

Figure 124: Enter Passphrase. 75

Figure 125: GSW ConnectBot Admin Icon. 75

Figure 126: Tap overflow menu. 76

Figure 127: Tap Manage Pubkeys. 76

Figure 128: Tap folder icon. 76

Figure 129: Select Public Key. 77

Figure 130: Tap key to unlock. 78

Figure 131: Enter Password if prompted. 78

Figure 132: Key is unlocked. 78

Figure 133: Certificate Mapping Tool 79

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

Figure 135: Example of public key generated by puTTYgen. 80

Figure 136: Example of public key generated on GSW ConnectBot to clipboard. 80

Figure 137: Installing Public Key. 81

Figure 138: Key Installed. 81

Figure 139: Restart SSH Service. 82

Figure 140: Creating a Host 83

Figure 141: Defining a Telnet Host 84

Figure 142: Enter Telnet Configuration Information. 85

Figure 143: Connection Settings. 86

Figure 144: Saving the Connection. 86

Figure 145: Tap Upload configuration from the overflow menu. 87

Figure 146: Locate GSW LADS. 87

Figure 147: Upload Configuration. 88

Figure 148: Upload Complete. 88

Figure 149: Copy upload configuration to download folder 88

Figure 150: GSW LADS Config File shortcut 89

Figure 151: Tap Download Configuration. 90

Figure 152: Select Configuration. 90

Figure 153: Tap download configuration. 91

Figure 154: Configuration download in progress. 91

Figure 155: Configuration download successful 91

Figure 156: Two Modes of Connection. 92

Figure 157: Create Host(s) 93

Figure 158: Settings Icon. 94

Figure 159: Tap Security Setting. 94

Figure 160: Pin Windows Option. 95

Figure 161: Ask for PIN before unpinning. 96

Figure 162: Pinning the Window.. 97

Figure 163: GSW ConnectBot - Admin Mode. 98

Figure 164: GSW ConnectBot Work Mode. 98

Figure 165: HTTPS Protocol Configuration Menu. 102

Figure 166: SAP ITS Mobile with GSW Enhancements Disabled. 103

Figure 167: SAP ITS Mobile with GSW Enhancements Enabled. 103

Figure 168: Enable ITSMobile Enhancements Shows Skin Menu. 104

Figure 169: Skin options menu. 104

Figure 170: ITSMobile Skin Options. 105

Figure 171: GSW Browser Barcode Scanner Plugin Example. 111

Figure 172: GSW Broswer Battery Status Plugin Example. 112

Figure 173: GSW Broswer Camera Plugin Example. 114

Figure 174: GSW Scanner Pluggin Example. 118

Figure 175: GSW Browser Device Variables Plugin. 119

Figure 176: GSW Browser Dialogs and Alerts Plugin Example. 120

Figure 177: GSW Variables / Device Plugin. 122

Figure 178: GSW Browser File Storage Plugin Example. 123

Figure 179: GSW Browser File Transfer Plugin Example. 124

Figure 180: GSW Browser Geo Location Plugin Example. 126

Figure 181: GSW Browser Media Player Plugin Example. 127

Figure 182: GSW Browser Media Capture Plugin Example. 128

Figure 183: Network Plugin Example. 129

Figure 184: GSW Browser Screen Orientation Plugin Example. 130

Figure 185: GSW Browser Status Bar Plugin Example. 131

Figure 186: GSW Broswer Vibration Plugin Example. 132

Figure 187: Zebra Bluetooth Printing Plugin Example. 133

Figure 188: LADS components. 134

Figure 189: GSW LADS setup program.. 135

Figure 190: User Account Control Dialog. 135

Figure 191: Setup progress bar 135

Figure 192: Welcome. 136

Figure 193: Installation Location. 136

Figure 194: Install folder 137

Figure 195: Setup Complete. 137

Figure 196: LADS Registration UAC dialog. 138

Figure 197: GSW LADS registration tool opens. 138

Figure 198: Registration Tool with completed information. 139

Figure 199: Registration Tool - Serial Number Entered. 140

Figure 200: Registration Successful 140

Figure 201: GSW License Manager tool 143

Figure 202: Release License - Notice Available License Count 144

Figure 203: Enter Android ID, Click Release License. 144

Figure 204: License Released Confirmation. 144

Figure 205: Release License - Notice Available License Count Incremented. 144

Figure 206: LADSTble.exe folder 145

Figure 207: Output of LADSTbl.exe utility. 145

Figure 208: GSW LADS - Software Updates. 146

Figure 209: Apk and .json located in the GSW LADS files folder 146

Figure 210: GSW LADS Config Upload/Download folders. 147

Figure 211: Easy access to the Config Files via Windows Start Menu. 147

Figure 212: Hosts List - Select Upload Configuration. 148

Figure 213: Set Tag field to "Default". 148

Figure 214: Tap Upload Configuration. 148

Figure 215: Upload Progress bar 148

Figure 216: Uploaded Successfully. 148

Figure 217: GSW LADS Screen Shot storage location. 149

Figure 218: Examples of stored Screen shots. 149

Figure 219: pubkey.xml located on GSW LADS. 150

Figure 220: Swipe - Qwerty Customer Keyboard. 151

Figure 221: Swipe - Special Characters Customer Keyboard. 151

Figure 222: BI example charts. 152

Figure 223: More BI example charts. 152

Figure 224: Business Intelligence Data Flow.. 153

Figure 225: Android Lifecycle diagram.. 169

Figure 226: Screen Recognition/Custom Keyboards. 173

Figure 227: Screen Recognition Fundamentals. 174

Figure 228: Numeric Only Keys - Customer Keyboard. 175

Figure 229: Five Key Only - Custom Keyboard. 176

Figure 230: GSW Keyboard Special Key Definition. 177

Figure 231: 3 dot, overflow menu for show keyboard. 178

Figure 232: Select Show Keyboard. 178

Figure 233: Qwerty keyboard – Black-Green skin. 179

Figure 234: Special Keys keyboard – Stone Skin. 179

Figure 235: Numeric keyboard - Stone skin. 179

Figure 236: Landscape Symbols/Numeric Keyboard Anchored to Right Edge. 180

Figure 237: Landscape – Alpha Numeric keyboard – Yellow – Black skin. 181

Figure 238: Landscape Special Keys keyboard – Stone Skin. 182

Figure 239: Landscape Symbols/Numeric keyboard - Stone skin.