Page History
...
file
- required- the path to the Credential Store file. This file can be located anywhere in the file system.
- A relative path can be used that is calculated from the Agent's working directory:
- By default this is the Agent's configuration directory, for example
/home/sos/js7/agent/var_<http-port>
for UnixC:\ProgramData\sos-berlin.com\js7\agent
for Windows
- Example
- a relative path
./config/secret.kdbx
maps toC:\ProgramData\sos-berlin.com\js7\agent\config\secret.kdbx
- a relative path
- By default this is the Agent's configuration directory, for example
password
- optionalthe password for access to the Credential Store file.
It is recommended not to use this parameter and instead to use a
key_file
to access the Credential Store.
key_file
- optional, default: the path and name of the Credential Store file using the extension .key, for example, by default./config/jobs.key
is assumed if the Credential Store file ./config/jobs.kdbx
is specified.
Anchor | ||||
---|---|---|---|---|
|
JITL Database Jobs can access a Credential Store in the following ways:
...
Name | Required | Purpose | Example |
---|---|---|---|
| yes | JDBC connection string |
|
| yes | User name for database access | cs://jobs/oracle/minos.sos@user |
| yes | Password for database access | cs://jobs/oracle/minos.sos@password |
credential_store_file | yes | Location of the Credential Store database file (*.kdbx) | ./config/jobs.kdbx |
credential_store_key_file | no | Location of the Credential Store key file (*.key) | ./config/jobs.key |
credential_store_password | no | Password of the Credential Store | secret |
credential_store_entry_path | no | Folder hierarchy and entry name in the Credential Store | /jobs/oracle |
Anchor | ||||
---|---|---|---|---|
|
Use with Arguments
References to a Credential Store can be directly specified from arguments. This applies to the following JITL Mail Jobs:
...
Name | Required | Purpose | Example |
---|---|---|---|
| yes | SMTP hostname or IP address |
|
| yes | User account for SMTP authentication | cs://jobs/mail/mail.sos-berlin.com@user |
| yes | Password for SMTP authentication | cs://jobs/mail/mail.sos-berlin.com@password |
credential_store_file | yes | Location of the Credential Store database file (*.kdbx) | ./config/jobs.kdbx |
credential_store_key_file | no | Location of the Credential Store key file (*.key) | ./config/jobs.key |
credential_store_password | no | Password of the Credential Store | secret |
credential_store_entry_path | no | Folder hierarchy and entry name in the Credential Store | /jobs/mail |
Use with JITL SAP Jobs
...
Anchor | ||||
---|---|---|---|---|
|
...
Use with Arguments
References to a Credential Store can be directly specified from arguments. This applies to the following JITL SSH Jobs:
References to a Credential Store
References to a credential store can be directly specified from arguments.
Full Syntax
The full syntax is used when the complete URI is specified with an argument, for example:
Name | Purpose | Example |
---|---|---|
| This argument specifies the user account to be used when connecting to the SSH server. |
|
| This argument specifies the user account's password for authentication by the SSH server and has to be specified if the password authentication method is specified with the | cs://jobs/ssh/ssh.sos-berlin.com@password?file=./config/jobs.kdbx |
| This argument specifies the path and name of a private key file used for authentication with an SSH server. This argument has to be specified if the publickey authentication method is specified with the |
|
proxy_user | The value of this argument specifies the user account for authentication with the proxy server that is used to connect to the SSH server. | cs://jobs/ssh/ssh-proxy.sos-berlin.com@user?file=./config/jobs.kdbx |
proxy_password | This argument specifies the password for the proxy server user account if a proxy is used to connect to the SSH server. | cs://jobs/ssh/ssh-proxy.sos-berlin.com@password?file=./config/jobs.kdbx |
Explanation:
- The
jobs/mail/ssh.sos-berlin.com x
value is an example for a path to an entry in the KeePass database that holds the credentials. - The
./config/jobs.kdbx
value is an example for a relative path to the KeePass database that holds the Credential Store.
Short Syntax
The short syntax can be used if arguments are specified with references to the Credential Store location, for example:
Name | Example |
---|---|
|
|
| cs://jobs/ssh/ssh.sos-berlin.com@password |
| cs://jobs/ssh/ssh.sos-berlin.com@attachment |
credential_store_file | ./config/jobs.kdbx |
credential_store_key_file | ./config/jobs.key |
credential_store_password | secret |
credential_store_entry_path | /jobs/ssh |
...