Tectia® Client 6.6

User Manual

SSH Communications Security Corporation

This software and documentation are protected by international copyright laws and treaties. All rights reserved.

ssh® and Tectia® are registered trademarks of SSH Communications Security Corporation in the United States and in certain other jurisdictions.

SSH and Tectia logos and names of products and services are trademarks of SSH Communications Security Corporation. Logos and names of products may be registered in certain jurisdictions.

All other names and marks are property of their respective owners.

No part of this publication may be reproduced, published, stored in an electronic database, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, for any purpose, without the prior written permission of SSH Communications Security Corporation.


For Open Source Software acknowledgements, see appendix Open Source Software License Acknowledgements in the User Manual.

20 December 2023

Table of Contents

1. About This Document
Documentation Conventions
Operating System Names
Directory Paths
Customer Support
Component Terminology
2. Installing Tectia Client
Preparing for Installation
System Requirements
Hardware and Disk Space Requirements
Installation Packages
Upgrading Previously Installed Tectia Client Software
Downloading Tectia Releases
Installing the Tectia Client Software
Installing on AIX
Installing on HP-UX
Installing on Linux (RPM)
Installing on Linux (DEB)
Installing on Solaris
Installing on Windows
Removing the Tectia Client Software
Removing from AIX
Removing from HP-UX
Removing from Linux (RPM)
Removing from Linux (DEB)
Removing from Solaris
Removing from Windows
Files Related to Tectia Client
File Locations on Unix
File Locations on Windows
Registry Keys on Windows
Symlinks between ssh/scp/sftp and sshg3/scpg3/sftpg3 (on Unix)
3. Getting Started with Tectia Client
Product Components
First Login to a Remote Host
Logging in with Tectia SSH Terminal GUI (on Windows)
Logging in with Command-Line sshg3
Using Public-Key Authentication
Configuring Tectia Client
Connection Broker Configuration
Connection Broker Configuration Files
Command-Line Tools
Creating Connection Profiles
Defining Connection Profile Settings
Enabling FIPS 140-2 Mode
Enabling FIPS Mode Using Configuration GUI
Enabling FIPS Mode Using Configuration File
FIPS-Certified Cryptographic Library
4. Authentication
Supported User Authentication Methods
Compatibility with OpenSSH Keys
Server Authentication with Public Keys
Host Key Storage Formats
Using the System-Wide Host Key Storage
Resolving Hashed Host Keys
Using the OpenSSH known_hosts File
Server Authentication with Certificates
Managing CA Certificates with the Configuration File (Unix)
Managing CA Certificates with the GUI
User Authentication with Passwords
Defining Password Authentication with the Configuration File (Unix)
Using Stored Passwords in Connection Profiles
Managing Authentication Methods with the GUI
User Authentication with Public Keys
Creating Keys with ssh-keygen-g3
Uploading Public Keys Manually
Creating Keys with the Public-Key Authentication Wizard
Using Keys Generated with OpenSSH
Special Considerations with Windows Servers
User Authentication with Certificates
Using the Configuration File (Unix)
Configuring User Authentication with Certificates on Windows
Importing PKCS Certificates with Tectia Connections Configuration GUI
Host-Based User Authentication (Unix)
User Authentication with Keyboard-Interactive
Defining Keyboard-Interactive Method with the Configuration File (Unix)
Defining Keyboard-Interactive Method with the GUI
User Authentication with GSSAPI
Defining GSSAPI Method with the Configuration File (Unix)
Defining GSSAPI Method with the GUI
5. Transferring Files
Secure File Transfer with scpg3 and sftpg3 Commands
Using scpg3
Using sftpg3
Enhanced File Transfer Functions
Secure File Transfer GUI (Windows)
Defining Secure File Transfer GUI Settings
Downloading Files with Tectia Secure File Transfer GUI
Uploading Files with Tectia Secure File Transfer GUI
Transfer and Queue Tabs
Defining File Properties
Differences from Windows Explorer
Controlling File Transfer
Site Command
6. Secure Shell Tunneling
Local Tunnels
Non-Transparent TCP Tunneling
Non-Transparent FTP Tunneling
SOCKS Tunneling
Remote Tunnels
X11 Forwarding
Agent Forwarding
7. Troubleshooting Tectia Client
Gathering Basic Troubleshooting Information
Collecting System Information for Troubleshooting
Setting Connection Broker to Debug Mode
Answers to Common Problems
A. Connection Broker Configuration Tools
Tectia Connections Configuration GUI
Opening the GUI
Defining General Settings
Defining Connection Profiles
Defining User Authentication
Defining Server Authentication
Defining Automatic Tunnels
Configuration File for the Connection Broker
Backup of Configuration Files
Connection Broker Configuration File Quick Reference
Broker Configuration File Syntax
Tectia Shortcut Menu (Windows and Linux)
Tectia Connections Status GUI
B. Configuring Tectia SSH Terminal GUI and Tectia Secure File Transfer GUI (Windows)
Defining Global Settings
Defining the Appearance
Selecting the Font and Terminal Window Size
Selecting Colors
Defining Messages
Defining File Transfer Settings
Defining Advanced File Transfer Options
Defining File Transfer Mode
Defining Local Favorites
Defining Security Settings
Using Command-Line Options
Customizing the User Interface
Saving Settings
Loading Settings
Logging a Session
C. Command-Line Tools and Man Pages
ssh-broker-g3 — Tectia Connection Broker - Generation 3
ssh-broker-ctl — Tectia Connection Broker control utility
ssh-troubleshoot — tool for collecting system information
sshg3 — Secure Shell terminal client - Generation 3
scpg3 — Secure Shell file copy client - Generation 3
sftpg3 — Secure Shell file transfer client - Generation 3
ssh-translation-table — Secure Shell Translation Table
ssh-keygen-g3 — authentication key pair generator
ssh-keyfetch — Host key tool for the Secure Shell client
ssh-cmpclient-g3 — CMP enrollment client
ssh-scepclient-g3 — SCEP enrollment client
ssh-certview-g3 — certificate viewer
ssh-ekview-g3 — external key viewer
D. Egrep Syntax
Egrep Patterns
Escaped Tokens for Regex Syntax Egrep
Character Sets For Egrep
E. Audit Messages
F. Default and Supported SSH Algorithms
Key-Exchange Algorithms
Message-Authentication Codes
Host-Key and Public Key Signature Algorithms
G. Removing OpenSSL from Tectia Client
Background Information
Should I Remove the OpenSSL Library?
What Happens If I Remove the OpenSSL Library?
Removing the OpenSSL Cryptographic Library
Linux and Solaris
H. Open Source Software License Acknowledgements