How to control passcache from the command line

Overview

The command line tool "VISULOX passcache" allows to control VISULOX passcache entries.

Passcache works for RDP and SSH.
(NOT TELNET! If needed, please request implementation).

Usage

The following subcommands are available:

Command	Description
list	List and print passcache entries.
edit	Edit/create a passcache entry.
fields	Modify fields of a passcache entry.
delete	Remove a passcache entry.

passcache entry elements (edit)

Element	Description
-resource <>	Resource <>*
-object <>	Mask or unique distinguished owner <>
-starttime <>	Start time of the resource: now or timestring. Default: <now>
-endtime <>	Resource expiration: endless or timestring. Default: <endless>**
-resuser <>	Resource user <> (%USER% variable can be used)
-reskey <>	Resource keys <>
-respass <>	Resource password (- from stdin) <> (Environment variable VLX_SECRET can be used)
-comment <>	Resource comment. Default <CLI>
-grant <>	Set granted user in database record <>

*A resource is limited to 15 characters, alphanumeric only.
**If expiration time is reached, the entry will be deleted.

-object <owner>: A resource for the user is created and will be addressed with [%OWNER%].

-resource <suffix> -object <owner>: A resource for the user is created and will be addressed with [<suffix>(%OWNER%)].

For Command Connect / Command Guard the resource is either

-resource <resourcename> for all hosts, which have no explicit user name.

or

-hosts ssh://[<resourcename>]@<host> , a user in brackets is treated as a resource in password cache.

Examples

List current available passcache entries

CODE

visulox passcache list

    -------------------------------------------------------------------------
    | basicname | keystatus |       resuser | endtime |           starttime |
    -------------------------------------------------------------------------
    |  winadmin |           | Administrator | endless | 2019-10-07 10:17:23 |
    -------------------------------------------------------------------------

Create passcache entry

CODE

visulox passcache edit -resource WinAdmin -resuser Administrator -respass 
/opt/visulox/bin/apps/vlxshell.tcl -client freerdp -resource winadmin -- off-wts

Creating a resource [WIN:owner]

CODE

visulox passcache edit -resource win -object test -resuser tbsol\\test1 -respass  
/opt/visulox/bin/apps/vlxshell.tcl -client freerdp -resource win%OWNER% -- off-wts

Remove an entry

CODE

visulox passcache delete -resource WinAdmin