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

 

 

 

 

 

 

 

 

 

 

 

 

 

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, 2023 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 UGECB012052023

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

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

Demo Mode. 18

Check the License Status. 19

Registration by GSW Licensing and Deployment Server (LADS). 25

Return License to License and Deployment Server (LADS). 26

Manual Registration. 28

Example: Create Product ID.. 29

Apply Serial Number. 33

Update the GSW ConnectBot software. 36

Updating Software by Licensing and Deployment Server (LADS). 37

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

Updating Software by URL. 42

GSW ConnectBot Host Configuration and Connections. 45

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

Delete Host Connection. 55

Security Information. 56

Global Settings. 57

Automatic provisioning. 59

Use location information. 59

Enable HTTPD.. 59

Remember keys in memory. 59

Persist connections. 59

Keep Wi-Fi active. 59

Backup pubkeys. 59

Emulation mode. 59

Scrollback size. 59

Rotation mode. 60

Auto hide title bar. 60

Full screen. 60

Page up/down gesture. 60

Volume keys change font size. 60

Keep Screen awake. 60

Fast updates. 60

Enable WI-FI alerts. 60

Enable Battery Alerts. 60

Collect Business Intelligence data. 60

Track TE Scans. 60

Track Web Scans. 60

Use GSW keyboards. 60

Use GSW keyboards for web. 61

Opacity control 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. 61

Camera shortcut. 61

Bumpy arrows. 61

Audible Bell 61

Bell Volume. 61

Vibrate on bell 61

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

Accept file scheme cookies. 62

Using Answerback with the GSW SSH/Telnet Server. 64

Answerback Example Configuration. 65

SSH Configuration. 67

Configure a Host Connection Example 1. 67

SSH with Password Authentication. 67

Save host connection configuration. 69

Connect to the new configured connection. 69

Configure a Host Connection Example 2. 70

SSH with Public/Private Key Authentication. 70

Creating a Public/Private key pair. 71

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

Generate (using randomness). 73

Unlock the Key. 74

Transfer the key to the SSH Server. 74

Create a Key Pair using PuTTY. 75

Installing Private Key to GSW ConnectBot Android Client. 77

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

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

SAPGui for HTML Enhancements. 106

Inject Cordova. 108

Disallow Overscroll 108

Allow remote debugging. 108

Keep running. 108

Load URL timeout. 108

Append to user agent. 108

Accept third party cookies. 109

Enable home button. 109

Log all keys. 109

Allow zoom controls. 109

URL access list. 109

Allow navigation list. 109

Allow Intent list. 110

GSW Browser Full Screen. 110

GSW Browser Telephone Keyboard. 111

GSW DOM Injection syntax. 111

Overview.. 111

Attributes. 112

Examples. 113

Apache Cordova. 114

Apache Cordova Plugins. 114

Barcode Scanner (Zxing plugin). 115

Battery-Status. 116

Camera. 117

Georgia SoftWorks Scanner (cordova-plugin-gswscanner). 119

Cordova-plugin-cert-authentication. 122

Dialogs. 124

ES6-Promise. 125

GSW Variables (Telemetry Data). 126

Write to File (File Storage plugin). 127

File Transfer. 128

Geolocation. 129

Media. 131

Media Capture. 132

Network. 133

Screen Orientation. 134

Statusbar. 135

Vibration. 136

Whitelist. 136

Zebra Bluetooth Printing. 137

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

Installing the Georgia SoftWorks Licensing and Deployment Server. 139

Registering the Georgia SoftWorks Licensing and Deployment Server. 142

GSW LADS Operation. 146

GSW ConnectBot LADS XML Configuration File. 146

Example: 146

Example: 147

Example: 147

Example: 147

Automatic Provisioning (Auto Discovery). 147

LADS Port Descriptions. 147

Manage Licensing. 150

LADS Table Utility. 152

Manage Software Updates to GSW ConnectBot. 153

Upload / Download GSW ConnectBot Configuration. 154

Zero Touch Configuration. 155

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

Public/Private Key Import/Export. 157

Business Intelligence (BI). 157

Understanding Business Intelligence (BI) Data. 159

GSW Business Intelligence Data Collection – Overview.. 160

Events.txt Format. 161

eventHandler.ps1 Format. 164

Message ID Codes. 165

GSW ConnectBot Events Overview.. 165

GSW Keyboard Events. 167

Message ID code:  1000 – Key code. 167

Message ID code:  1001 – Key Output text. 169

Message ID code:  1100 – Keyboard Selected. 170

GSW Host Events. 171

ID code:  1200 Host Launched. 171

ID code:  1201   Connected to a TE Host. 171

ID code:  1202   Disconnected from a TE Host. 172

ID code:  1300 Web Page Loaded. 172

ID code:  1301 Web Request Not Allowed. 173

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

ID code:  1400 Key Event from Telnet or SSH Connections. 174

ID code:  1401 Scan Events from Telnet and SSH connections. 174

ID code:  1402 Key Event from Web Connections. 174

ID code: 1410 TE Scan Tracking. 175

ID code: 1411 Web Scan Tracking. 175

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

GSW ConnectBot Screen Recognition Events. 176

Message ID code:  1500 – Screen Recognition. 176

GSW ConnectBot General Events. 178

ID code:  2000   Battery Level 178

ID code:  2100 WIFI Level 178

ID code:  4000 Duplicate License Removed. 179

Android Application States. 180

Message ID code:  3000   GSW ConnectBot application started. 181

Message ID code:  3002   GSW ConnectBot Activity Resumed. 181

Message ID code: 3003 GSW ConnecBot Activity Destroyed. 182

GSW LADS Events. 183

ID code:  100000   Message License Count info. 183

ID code:  100001   Message License Obtained. 183

ID code:  100002   Message License Released. 184

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

ID code:  100101 GSW LADS Instance ID.. 185

PowerShell eventHandler.ps1. 185

Zebra Link-OS Printing. 186

Telnet/SSH Connections. 186

Discover Zebra Link-OS printer. 186

Add Link-OS Printer. 188

Use Link-OS Printer. 189

GSW Enterprise Browser. 190

Screen Recognition / Custom Keyboard association. 191

Understanding Screen Recognition. 192

GSW LADS Database. 192

Custom GSW Keyboards 193

GSW Standard Keyboards. 196

Technical Support. 209

 

Table of Figures

Figure 1: Host Connections / Host Configurations. 3

Figure 2: Overflow menu. 3

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 pop-up. 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: Pre-configured Dashalytics Chat Host. 17

Figure 26: When launching a host and unlicensed software detected. 18

Figure 27: Selected Demo - prompt to continue in Demo Mode. 18

Figure 28: Selected License Options - Description on how to obtain license. 18

Figure 29: Prompt after 30-minute demo has expired. 18

Figure 30: Hosts - More Options. 19

Figure 31: Hosts - Licensing. 19

Figure 32: Check License Info. 20

Figure 33: Tap Continue to see License Info. 20

Figure 34: Free Temporary Manual License Found. 21

Figure 35: Temporary Manual License Expired. 21

Figure 36:  Subscription Expired. 22

Figure 37: Permanent License - Manual Registration. 24

Figure 38: Permanent License Applied – GSW LADS. 24

Figure 39: Register Using GSW LADS. 25

Figure 40: Automatically Locate GSW LADS. 25

Figure 41:Product License retrieved from GSW LADS. 26

Figure 42: Get License for GSW LADS. 26

Figure 43: Return GSW ConnectBot License from device. 27

Figure 44: Notification that the License was successfully released. 27

Figure 45: Permanent License – Serial Number. 28

Figure 46: Permanent License - Continue. 28

Figure 47: Create Product ID.. 29

Figure 48: Allow access if needed. 29

Figure 49: Close Dialog. 30

Figure 50:  Product ID created. 31

Figure 51: request.c2g placed in root/android/data/com.gsw.connectbot/files. 31

Figure 52: Request .c2g placed in root - v2.7.067 and lower. 31

Figure 53: Copy serial.g2c to root folder described. 33

Figure 54: Apply Serial Number from file. 33

Figure 55: Locate the serial.g2c file. 34

Figure 56: Serial Number Applied Successfully. 34

Figure 57: All Done, Tap Continue. 34

Figure 58: Paste Serial Number. 35

Figure 59: Tap APPLY after pasting serial number. 35

Figure 60: Admin Mode - Update software. 36

Figure 61: Work Mode - Update Software. 36

Figure 62: Hosts - More Options - Update. 37

Figure 63: Tap Update. 37

Figure 64: Update TAP GSW LADS. 38

Figure 65: TAP Continue. 38

Figure 66: Check for Update. 38

Figure 67: Use GSW LADS Update Screen. 38

Figure 68: Locate GSW LADS. 38

Figure 69: GSW LADS - Update Found. 39

Figure 70: GSW LADS - running latest version. 39

Figure 71: Install Update. 40

Figure 72: May be prompted to allow access to photos. 40

Figure 73:  Update is downloading. 40

Figure 74: Install Update. 40

Figure 75: Tap Open to launch. 40

Figure 76: Select version to install 41

Figure 77: Tap install 41

Figure 78: Tap the overflow menu. 42

Figure 79: Tap Update. 42

Figure 80: Select Use URL. 42

Figure 81: Tap Continue. 43

Figure 82: Tap Check For Updates. 43

Figure 83: Update Found - Tap OK. 43

Figure 84: Install Update button highlighted. 44

Figure 85: You may a security prompt - tap Allow.. 44

Figure 86: Tap Install 44

Figure 87: Installed. 44

Figure 88: Creating a Host. 45

Figure 89: Configuring a Host connection. 46

Figure 90: Host Connection Screen Display. 48

Figure 91: Session overflow menu. 49

Figure 92: Cordova Examples Home Page. 50

Figure 93: Industrial Browser Overflow Menu. 50

Figure 94: Tap 1 - Tap overflow menu. 52

Figure 95: Tap 2 - Tap Screenshot. 52

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

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

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

Figure 99: Create Auto-Response field. 55

Figure 100: Edit Auto Response Field. 55

Figure 101: Auto Response Field completed. 55

Figure 102:  Auto Response created. 55

Figure 103: Secure Algorithms. 56

Figure 104: Un-Secure Algorithms. 56

Figure 105: Menu to access Global configuration. 57

Figure 106: Accessing Settings. 57

Figure 107: Select Settings. 57

Figure 108: Global Settings Menu. 63

Figure 109: Global Settings Menu Continued. 63

Figure 110: Answerback Settings. 64

Figure 111: Creating a Host. 67

Figure 112: Enter Host Information. 68

Figure 113: Use pubkey authentication setting in Edit Host. 70

Figure 114: If multiple keys are needed. 70

Figure 115: Select Use any unlocked key (Default) or choose specific key. 70

Figure 116: Saving the Connection Installing Private Key to GSW ConnectBot Android Client. 71

Figure 117: Tap the Overflow Menu. 72

Figure 118: Tap Manage Pubkeys. 72

Figure 119: Tap "+". 73

Figure 120: Add Nickname (Password is optional) and check Load key on start. 73

Figure 121: Tap Generate. 73

Figure 122: Generate Randomness for Keys. 74

Figure 123: Generate Randomness until 100%.. 74

Figure 124: Locked Key. 74

Figure 125: Enter password if added. 74

Figure 126: Unlocked Key. 74

Figure 127: Tap Copy public key. 75

Figure 128: Open PuTTYgen. 75

Figure 129: Generate Randomness. 76

Figure 130: Enter Passphrase. 76

Figure 131: GSW ConnectBot Admin Icon. 77

Figure 132: Tap overflow menu. 77