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.
...
The short syntax can be used if the Hibernate configuration file includes explicit references to the credential storeCredential Store:
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <hibernate-configuration> <session-factory> ... <property name="hibernate.connection.username">cs://@user</property> <property name="hibernate.connection.password">cs://@password</property> <property name="hibernate.connection.url">cs://@url</property> ... <property name="hibernate.sos.credential_store_file">./config/secret.kdbx</property> <property name="hibernate.sos.credential_store_key_file">./config/secret.key</property> <property name="hibernate.sos.credential_store_password">secret</property> <property name="hibernate.sos.credential_store_entry_path">/secret/database/reporting</property> ... </session-factory> </hibernate-configuration |
...
<property name="hibernate.sos.credential_store_file">
=> path to the Credential Store database file<property name="hibernate.sos.credential_store_key_file">
=> path of to the key file for the Credential Store<property name="hibernate.sos.credential_store_password">
=> password of the Credential Store database file<property name="hibernate.sos.credential_store_entry_path">
=> folder hierarchy and entry name in the Credentials Store database file
Example for Hibernate Configuration File
...
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 | 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 |
Use with JITL Notification Jobs
Use with Arguments
References to a Credential Store can be directly specified from arguments. This applies to the following JITL Notification 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:
Name | Purpose | Example |
---|---|---|
| SMTP hostname or IP address |
|
| User account for SMTP authentication | cs://jobs/mail/mail.sos-berlin.com@user?file=./config/jobs.kdbx |
| Password for SMTP authentication |
|
Explanation:
- The
jobs/mail/mail.sos-berlin.com
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:
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 | 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
Status | ||||
---|---|---|---|---|
|
Use with JITL SSH Jobs
Status | ||||
---|---|---|---|---|
|
...