SignerStatusReportWorker

Fully qualified class name: org.signserver.module.signerstatusreport.SignerStatusReportWorker

Overview

The SignerStatusReportWorker is a worker that returns a status report for a configured set of workers. The information includes each workers crypto token status ACTIVE/OFFLINE and if available also the numbers of signatures that has been performed with the key currently associated with the worker. If the worker has a configured limit of number of signatures, this value is also included. This worker returns the report in the same format as defined for the SignerStatusReportTimedService.

Worker Properties

Property

Description

WORKERS

Comma-separated list of worker names (signers) that should be monitored.

Output Format

workerName=WORKERNAME1, status=STATUS1, KEY3=VALUE3, KEY4=VALUE4, ...
workerName=WORKERNAME2, status=STATUS2, KEY3=VALUE3, KEY4=VALUE4, ...
workerName=WORKERNAME3, status=STATUS3, KEY3=VALUE3, KEY4=VALUE4, ...
...

Rules

  • Each line contains a set of properties for one worker.

  • Lines are separated by a system dependent newline character (CR, LF or CRLF).

  • Properties are of form KEY=VALUE and are separated by a comma and a space (", ").

  • The properties workerName and status are mandatory.

  • The property workerName is always the first property.

Properties

Property

Desrciption

workerName

Name of the worker. Example: "sod71" or "sod72"

status

Sstatus of the worker's crypto token and key. Either "ACTIVE" or "OFFLINE".

validityNotBefore

The first date the signer is allowed to sign. The format is java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss z").

validityNotAfter

The last date the signer is allowed to sign.

signings

The number of signatures that has been performed with the key used by this worker.

signLimit

The maximum number of signatures this worker is allowed to perform, or -1 if there is no limit.

Examples

workerName=Sod71, status=ACTIVE, validityNotBefore=2010-07-05 17:32:36 CEST, validityNotAfter=2010-09-08 17:32:36 EEST, signings=132, signLimit=100000,

Explanation: Sod71 has done 132 signings and is ACTIVE and validityNotAfter indicates that it can continue to sign until 8th September if not the sign limit is reached before

workerName=Sod72, status=OFFLINE, validityNotBefore=2010-07-05 17:32:33 CEST, validityNotAfter=2010-09-08 17:32:33 EEST, signings=100000, signLimit=100000,

Explanation: Sod72 has performed all of its 100000 signings and can not sign until it gets a new key and certificate.

workerName=Sod73, status=OFFLINE, validityNotBefore=2010-07-05 17:32:33 CEST, validityNotAfter=2010-09-08 17:32:33 EEST, signings=0, signLimit=100000,

Explanation: Sod73 has not reached its limit and is still in validity time, but is OFFLINE for some other reason.

workerName=Sod74, status=OFFLINE,

Explanation: Sod74 is OFFLINE and has no certificate configured.