VISULOX 4 Documentation

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


visulox passcache list

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


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


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


visulox passcache delete -resource WinAdmin