Keys¶
The key value store of Consul administrates the SEAL Print Client server configuration.
The keys are set during the installation.
Values with time specifications are specified in the following time units:
-
seconds(s,sec) -
minutes(m,min) -
hours(h,hr) -
days(d) -
weeks(w,wk) -
months -
years(y,yr)
Example - with time units
<time_interval>=2h30m<time_interval>=4m2s
ACTION_EXECUTOR¶
ACTION_EXECUTOR specifies the backend system.
The key is available for the seal-operator-p4, seal-operator-dpf and the seal-operator-p5 services.
Available values: String
-
P4PLOSSYS netdome system
-
DPFDigital Paper Factory
-
P5PLOSSYS 5 system
-
MOCKOnly simulation
Default: MOCK
API_BASE_URL¶
API_BASE_URL specifies the URL of the server API.
The key is available for the seal-print-client service.
Available values: String
https://api:<port_number>
Default: https://api:3008
API_VERSION¶
API_VERSION specifies the version of the server API.
The key is available for the seal-print-client service.
Available values: String
<v1>
Default: v1
APW_URL¶
APW_URL specifies the URL of the APW Rest server.
The key is available for the seal-operator-p4 service.
Available values: String
https://<server_name>:8433
Default: https://localhost:8443
AUTH_CLIENT_ID¶
AUTH_CLIENT_ID specifies the client name configured in the ID Provider for retrieving the access token.
The key is available for all services.
The following OAuth Flows are needed:
-
Code Flow
OAuth Flow for interactive login (service name:
seal-operator-ui) -
Client Credential Flow
OAuth Flow for internal communication between the services (service name: e.g.
seal-operator-server,seal-operator-p4,seal-operator-p5)
Available values: String
<service_name>
Default:
seal-print-clientfor the user interfaceoperatorfor all other services
AUTH_CLIENT_SECRET¶
AUTH_CLIENT_SECRET specifies the client secret for retrieving the ID provider's access token.
The key is available for all services.
The following OAuth Flows are needed:
-
Code Flow
OAuth Flow for interactive login (service name:
seal-operator-ui) -
Client Credential Flow
OAuth Flow for internal communication between the services (service name: e.g.
seal-operator-server,seal-operator-p4,seal-operator-p5
Available values: String
<secret>
Default: not revealed
AUTH_CLOCK_TOLERANCE¶
AUTH_CLOCK_TOLERANCE specifies the maximum number of seconds of allowed time skew between the OAuth provider and client.
The key is available for the seal-print-client service.
Available values: String
<number>
Default: 5
AUTH_DEFAULT_SESSION_DURATION¶
AUTH_DEFAULT_SESSION_DURATION specifies the duration of the default session in seconds if the OAuth provider does not expose the refresh_expires_in parameter in the token. Keycloak provides this parameter.
The key is available for the seal-print-client service.
Avaialble values: String
<number>
Default: 180
AUTH_ISSUER_URL¶
AUTH_ISSUER_URL specifies the OpenID Connect issuer URL. This URL is configured in Keycloak.
The key is available for the seal-print-client service.
Availale values: String
https://<localhost>:<32769>/auth/realms/<SEAL>
Default: https://localhost:32769/auth/realms/SEAL
AUTH_REFRESH_TOLERANCE¶
AUTH_REFRESH_TOLERANCE specifies the time in seconds a token is automtically refreshed when it is about to expire.
The key is available for the seal-print-client service.
Available values: String
<number>
Default: 5
AUTH_TOKEN_ENDPOINT¶
AUTH_TOKEN_ENDPOINT specifies the URL of the token endpoint.
The key is available for the seal-operator-p5, the seal-operator-p4 and the seal-operator-dpf services.
Available values: String
https://<server_name/auth/token>:
Default: The default is automatically evaluated by the OpenID configuration path.
CONSUL_TOKEN¶
CONSUL_TOKEN specifies the ACL token with which the SEAL Print Client services authenticate themselves to Consul.
The key is available for all services.
Available values: String
INSECURE_ACL_MASTER_TOKEN
Default: none
CONSUL_URL¶
CONSUL_URL specifies the address of the Consul server to which the SEAL Print Client services log on.
The key is available for all services.
Available values: String
https://<server_name>:8500
Default: https://localhost:8500
CS_TYPE¶
CS_TYPE specifies the used credential store type.
The key is available for the seal-operator-server service.
Available values: String
-
noneNo credential store.
-
mockOnly simulation.
-
mongoStore credentials encrypted in mongodb.
-
vaultStore credentials in vault.
Default: mongo
DEFAULT_DPF_SCHEMA¶
DEFAULT_DPF_SCHEMA specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the DPF connector.
The key is available for the seal-operator-dpf service.
Available values: String
<path_name>
Default: <dpf_connector_install_dir>/lib/defaultConfig/schema.json
DEFAULT_FILEUPLOAD_PANEL¶
DEFAULT_FILEUPLOAD_PANEL specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the panel.
The key is available for the seal-operator-fileupload service.
Available values: String
<path_name>
Default: <fileupload_connector_install_dir>/lib/defaultConfig/panel.json
DEFAULT_FILEUPLOAD_SCHEMA¶
DEFAULT_FILEUPLOAD_SCHEMA specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the My Documents connector.
The key is available for the seal-operator-fileupload service.
Available values: String
<path_name>
Default: <fileupload_connector_install_dir>/lib/defaultConfig/schema.json
DEFAULT_P4_SCHEMA¶
DEFAULT_P4_SCHEMA specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the PLOSSYS netdome connector.
The key is available for the seal-operator-p4 service.
Available values: String
<path_name>
Default: <p4_connector_install_dir>/lib/defaultConfig/schema.json
DEFAULT_P5_SCHEMA¶
DEFAULT_P5_SCHEMA specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the PLOSSYS 5 connector.
The key is available for the seal-operator-p5 service.
Available values: String
<path_name>
Default: <p5_connector_install_dir>/lib/defaultConfig/schema.json
DEFAULT_SAP_SCHEMA¶
DEFAULT_SAP_SCHEMA specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the SAP connector.
The key is available for the seal-operator-sap service.
Available values: String
<path_name>
Default: <sap_connector_install_dir>/lib/defaultConfig/schema.json
DEFAULT_P4_PANEL¶
DEFAULT_P4_PANEL specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the panel.
The key is available for the seal-operator-p4 service.
Available values: String
<path_name>
Default: <p4_connector_install_dir>/lib/defaultConfig/panel.json
DEFAULT_P5_PANEL¶
DEFAULT_P5_PANEL specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the panel.
The key is available for the seal-operator-p5 service.
Available values: String
<path_name>
Default: <p5_connector_install_dir>/lib/defaultConfig/panel.json
DEFAULT_SAP_PANEL¶
DEFAULT_SAP_PANEL specifies the path to the JSON scheme file. The JSON scheme file contains the configuration settings for the panel.
The key is available for the seal-operator-sap service.
Available values: String
<path_name>
Default: <sap_connector_install_dir>/lib/defaultConfig/panel.json
DISABLE_MY_LISTS_ACCESS¶
DISABLE_MY_LISTS_ACCESS specifes whether the menue item My List at the left menu is disabled.
The key is available for the seal-print-client service.
Available values: Boolean
-
true -
false
Default: false
DPF_URL¶
DPF_URL specifies the URL for the REST calls.
The key is available for the seal-operator-dpf service.
Available values: String
https://<server_name>:<port>/rest/dpf/v1
Default: https://localhost:9126/rest/dpf/v1
ID_PROVIDER_CERT¶
ID_PROVIDER_CERT specifies the path and the file name of the certificate generated by the identity provider.
The key is available for all services.
The key is mandatory.
Available values: String
<path_name>
Default: none
ID_PROVIDER_NAME¶
ID_PROVIDER_NAME specifies the name of the identity provider.
The key is available for all services.
The key is mandatory.
Available values: String
<id_provider_name>(Keycloak: For example, here it is a complete URL:https://<hostname>:32769/auth/realms/SEAL)
Default: none
JWT_USERNAME¶
JWT_USERNAME specifies the user name set in the JSON Web Token (JWT). JWT_USERNAME specifies the user name in the current output job.
The key is available for the seal-operator-p4 and the seal-operator-p5 services.
Available values: String
<user_name>
Default: sub
LISTITEM_NAME¶
LISTITEM_NAME specifies the name of the property that is used as a list item name.
The key is available for the seal-print-client service.
Avaialable values: String
<metadata.name>
Default: metadata.name
LOG_LEVEL¶
LOG_LEVEL specifies the log level for the correspondent service. Messages that correspond to this log level or a higher one are written to the log file.
The key is available for all services.
Available values: Enumeration (value in ascending order)
-
debugDebug messages are written to the log file of the service.
-
infoInformation messages are written to the log file of the service.
-
warnWarnings are written to the log file of the service.
-
errorError messages are written to the log file of the service.
-
fatalMessages about serious error are written to the log file of the service.
Default: info
Example - log level error
Messages of the log levels error and fatal are written to the log file.
Example - log level info
Messages of the log levels info, warn, error andfatal are written to the log file.
MESSAGE_TIMOUT¶
MESSAGE_TIMOUT specifies the time interval after that the messages will be deleted.
The key is available for the seal-operator-server service.
Available values: String
<time_interval>
Default: 1h
MESSAGE_TTL¶
MESSAGE_TTL specifies how long the messages will be stored.
The key is available for the seal-operator-server service.
Available values: String
<time_interval>
Default: 24h
MONGO_CONNECT_RETRIES¶
MONGO_CONNECT_RETRIES specifies how often the service attempts to connect to the database.
The key is available for the seal-operator-server service.
Available values: Integer
<retries>
Default: 10
MONGO_FILEUPLOAD_URL¶
MONGO_FILEUPLOAD_URL specifies the URL of the MongoDB for file uploads into My Documents.
The key is available for the seal-operator-fileupload service.
Available values: String
mongodb://<localhost>:27017/operator-fileupload
Default: mongodb://localhost:27017/operator-fileupload
MONGO_SERVER_URL¶
MONGO_SERVER_URL specifies the URL of the MongoDB.
The key is available for the seal-operator-server service.
Available values: String
mongodb://<localhost>:27017/operator-server
Default: mongodb://localhost:27017/operator-server
MONGO_TOKEN¶
MONGO_TOKEN specifies the key for credential encryption and decryption.
The key is available for the seal-operator-server service.
MONGO_TOKEN is only used for CS_TYPE=mongo.
Available values: String
ThisIsMySecretEncryptionToken
ONLINE_DOCS_URL¶
ONLINE_DOCS_URL specifies the URI pointing to the external online documentation.
The key is available for the seal-print-client service.
Available values: String
<URI_path>
Default: ``
OPERATOR_SERVER_SERVICE¶
OPERATOR_SERVER_SERVICE specifies the name of the operator-server service as it is registered in Consul.
The key is available for the seal-operator-p4 and the seal-operator-p5 services.
Available values: String
<operator_name>
Default: operator-server
OPERATOR_SERVER_URL¶
OPERATOR_SERVER_URL specifies the URL of the operator-server service unless the name of the server service is known.
The key is available for the seal-operator-p4 and the seal-operator-p5 services.
Available values: String
<operator_name>
Default: none
PLOSSYS_IPP_URL¶
PLOSSYS_IPP_URL specifies the URL of the checkin service of the PLOSSYS 5 system.
The key is available for the seal-operator-p5 service.
Available values: String
ipp://<server_name>:631
Default: ipp://localhost:631
PLOSSYS_TIMEOUT¶
PLOSSYS_TIMEOUT specifies the timeout connecting and retrieving data from a PLOSSYS netdome system. The minimum value is two seconds.
The key is available for the seal-operator-p4 service.
Available values: String
4s
Default: 10s
PLOSSYS_URL¶
PLOSSYS_URL specifies the URL of the PLOSSYS netdome system to which SEAL Print Client has to connect.
The key is available for the seal-operator-p4 service.
Available values: String
https://<plossys_server_name>:3011
Default: https://localhost:3011
SAP_URL¶
SAP_URL specifies the URL for the SAP system.
The key is available for the seal-operator-sap service.
Available values: String
<protocol>://<server_name>:<port>
Default: none
SERVICE_URL¶
SERVICE_URL specifies how a service can be accessed.
The key is available for all services.
Available values: String
<protocol>://<server_name>:<port>
Default: https://localhost:<service_port>
Hint - port list
Default: The server name is determined when a service is started and the default port is used. The correspondent assignment is described in Used Ports.
TLS_DIR¶
TLS_DIR specifies the directory for storing the files necessary for the secure transfer between clients and servers and within SEAL Print Client.
The key is available for all services.
Available values: String
<dir_name>
The directory contains the following files:
-
key.pemFile with the private key
-
cert.pemFile with the certificate
-
ca.pemFile with the CA certificate
Default: The pre-installed self-signed certificate is used.
Caution - security gap
Using the pre-installed self-signed certificate in a productive system is a serious security gap!
TRUSTED_CLIENT¶
TRUSTED_CLIENT specifies the client name configured in the ID Provider for granting access via access token.
The key is available for the seal-operator-fileupload and the seal-operator-server services.
Available values: String
<client_name>
Default: operator
VAULT_URL¶
VAULT_URL specifies the URL of the vault service.
The key is available for the seal-operator-server service.
VAULT_URL is only used for CS_TYPE=vault.
Available values: String
https://<server_name>:8200
Default: https://localhost:8200
VAULT_TOKEN_PATH¶
VAULT_TOKEN_PATH specifies the directory for vault tokens.
The key is available for the seal-operator-server service.
VAULT_TOKEN_PATH is only used for CS_TYPE=vault.
Available values: String
<os_specific_path>
Default:
-
Linux:
/opt/seal/infrastructure/etc -
Windows:
C:\ProgramData\SEAL Systems\infrastructure\config
VAULT_TOKEN¶
VAULT_TOKEN specifies the root token of the vault service.
The key is available for the seal-operator-server service.
VAULT_TOKEN is only used for CS_TYPE= vault and if no valid token can be found in VAULT_TOKEN_PATH.
Available values: String
<INSECURE_ROOT_TOKEN>
Default: INSECURE_ROOT_TOKEN