...

• JS7 - JITL Database Jobs
  • JS7 - JITL SQLExecutorJob
  • JS7 - JITL PLSQLJob
  • JS7 - JITL SQLPLUSJob
• JS7 - JITL Mail Jobs
  • JS7 - JITL MailJob
• JS7 - JITL SAP Jobs
  • JS7 - JITL SAPS4HANAJob
• JS7 - JITL SSH Jobs
  • JS7 - JITL SSHJob

...

• 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 Unix
      • C:\ProgramData\sos-berlin.com\js7\agent for Windows
    • Example
      • a relative path ./config/secret.kdbx maps to C:\ProgramData\sos-berlin.com\js7\agent\config\secret.kdbx

• password - optional 

  • the 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:

<?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

...

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:

• JS7 - JITL MailJob

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: 

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:

Use with JITL SAP Jobs

Use with JITL SSH Jobs

...