Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

A number of JITL Job Templates require credentials, e.g. to access a database.

  • Security Considerations
    • Sensitive information in jobs should not be hard-coded, should not be used from parameters and should not be disclosed, e.g. written to log files.
    • Instead, a run-time interface is offered that allows to retrieve sensitive information from a Credential Store. References to Credential Store entries can safely be stored specified with parameter argument values.
  • Credential Store
  • Solution Outline

...

  • file - required 
    • the path to the Credential Store file. This file can be located anywhere in the file system.
  • 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 full syntax is used when the complete URI is specified with an argument: 

Name

Purpose

Example

db_url

JDBC connection string

cs://jobs/oracle/minos.sos@url?file=./config/jobs.kdbx

db_user

User name for database access

cs://jobs/oracle/minos.sos@user?file=./config/jobs.kdbx

db_password

Password for database access

cs://jobs/oracle/minos.sos@password?file=./config/jobs.kdbx

Explanation:

  • The jobs/oracle/minos.sos 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.

...

The short syntax can be used if arguments are specified with references to the Credential Store location:

Name

Required

Purpose

Example

db_url

yes

JDBC connection string

cs://jobs/oracle/minos.sos@url

db_user

yes

User name for database access

cs://jobs/oracle/minos.sos@user

db_password

yes

Password for database access

cs://jobs/oracle/minos.sos@password
credential_store_fileyesLocation of
a
the Credential Store database file (*.kdbx)./config/jobs.kdbx
credential_store_keynoLocation of
a
the Credential Store key file (*.key)./config/jobs.key
credential_store_passwordnoPassword of the Credential Store
file
secret
credential_store_entry_pathno

Folder hierarchy and entry name in the

Credentials Store file

Credential Store 

/jobs/oracle

Use with JITL SAP Jobs

Status
colourYellow
titleTODO

...