VShell Server for UNIX

man pages

VPKA

Section: User Commands (1)
Updated: Version 7.0

 

NAME

vpka - VanDyke Software Secure Shell public-key assistant program  

SYNOPSIS

vpka [options] source [source ...] destination  

DESCRIPTION

vpka is a public-key assistant program which allows a user with no public key file on the server to upload a public key for use in authentication. File sources and destinations specified when using the -a, -d, or -f options may contain a user, host and port specification, in the following format:
   [user@]host[#port] The following conditions apply:
 
* The user@ argument is optional. If it is not specified, your network username will be used.
* The host argument is optional. If it is not specified, your current host is used.
* The #port argument is optional. If it is not specified, the default port 22 will be used.  

OPTIONS

Command-line options are described below.
-a key file

The key file to add or upload to the public-key directory on the remote machine; multiple instances of this option are allowed.
--accepthostkeys

Instructs vpka to automatically accept host keys.
   Note: This option should be used with caution. 
   If a host key has changed, it will invalidate 
   the ability to detect a man-in-the-middle 
   attack.
--auth authentication list

The authentication methods to be used in a comma separated list. Valid methods are keyboard-interactive, publickey, password, and gssapi.
-c cipher

The cipher that the SSH2 server will use. Protocol strings or display strings are permitted.
-d key file

The key file to delete from the remote machine. The specified key file must exist on the local machine for this option to work. If the file does not exist on the local machine, you must use the -f option to remove the key. Multiple instances of the -d option are allowed.
-f fingerprint key

The fingerprint key file to delete from the remote machine. This option can be used instead of the -d option when a key file does not exist on the local machine but the fingerprint is available. To view all the keys on the remote machine, use the -s option. Multiple instances of the -f option are allowed.
--help

Displays usage.
-i file

The identity file to use for public-key authentication or a PKCS#12 file to use for X.509 authentication. If no file is specified, vpka will attempt to use all public keys in the $HOME/.vshell/publickey directory.
--kex KEX

Specifies which key exchange algorithm to use. Valid algorithms are diffie-hellman, diffie-hellman-group, Kerberos, and any OID (in dotted number format) supported by the GSSAPI provider.
-l username

Specifies the remote username.
-m MAC

The MAC that the SSH2 server will use.
--noprompt

Fails if prompted for user input.
-p port

Specifies the port to be used during connection.
--passphrase passphrase

The passphrase for your private key.
--pw password

Your user password.
-s

Show all remote keys.
--socks4 server[:port]

Specifies the Socks version 4 server to be used during connection.
--socks5 server[:port]

Specifies the Socks version 5 server to be used during connection.
--spn hostname

Allows you to manually specify the SPN (Server Principal Name). The SPN is almost always of the form host@<server canonical name>. An example of a valid string is "host@mail.mydomain.com". If the server is in a different Kerberos realm, the realm name may need to be appended (e.g., host@mail.mydomain.com@KRBS.MYDOMAIN.COM.
-v

Displays verbose connection debug information.
-z n

The compression level (0-9). By default, the compression level is set to 5. Setting the level to 0 turns off compression. When compression is on, vpka attempts to use zlib@openssh.com, zlib, and no compression, in that order, when making a connection.
 

FILES

The following are the locations of data files.
Host key files
The directory of these files is the same directory as the public key directory, which can be specified in the vshelld_config file. By default, the location is $HOME/.vshell/known_hosts.
Public key files
The directory of these files is specified in the vshelld_config file. By default, the location is $HOME/.vshell/publickey.
 

SEE ALSO

vcp(1), vkeygen(1), vsftp(1), vsh(1), vshelld(8), vshelld_config(5)

 

COPYRIGHT

Copyright (C) 1995 - VanDyke Software, Inc.

VanDyke Software and VShell are trademarks of VanDyke Software, Inc. All other products and services mentioned are trademarks or registered trademarks of their respective companies.
 


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
SEE ALSO
COPYRIGHT