+

Search Tips   |   Advanced Search

Key set groups settings

Use this page to create new key set groups. To view this console page, click Security > SSL certificate and key management. Under Configuration settings, clickManage endpoint security configurations > {Inbound | Outbound} > ssl_configuration. Under Related items, click Key set groups > New.


Key set group name

Name of key set group used. This name can be referenced using the com.ibm.websphere.crypto.KeySetHelper API to retrieve the managed keys from an application.

Information Value
Data type: Text


Management scope

Scope where this SSL configuration is visible. For example, if you choose a specific node, then the configuration is only visible on that node and any servers that are part of that node.

Information Value
Data type List
Range: Applicable scopes


Key sets

Specifies a set of key instances of the same type for use in cryptographic operations.

This setting has the following options:

Add

Specifies to add the selected key set part of this key set group.

Remove

Specifies to remove the selection from the Key sets list.


Automatically generate keys

The keys are generated automatically on a schedule. When a new key is generated, the security.xml is updated and saved by the runtime to track the key reference version. This can cause save conflicts when updating the same file from admin applications.

Avoid trouble: Starting with Versions 6.1.0.23 and 7.0.0.3, the default value for this property is Disabled.gotcha

If we try to enable this property, and automatic synchronization is off in any node, the following console message displays:

Information Value
Default for Versions 7.0, and 7.0.0.1: Enabled
Default for Versions 7.0.0.3 and higher: Disabled


Scheduled time for generation

Scheduled time when the system generates selected key set group or groups. We can specify the scheduled time in hours and minutes; specify either A.M. or P.M., or specify 24-hour. We can also specify the day of the week we want the scheduled event to occur. IBM recommends set this event to occur during a low peak time, especially for keys used by runtime for token validation.

Information Value
Data type Integer
Default: 8, 0 A.M.
Range: 1-12, with a A.M. or P.M. setting

0-59, with a 24-hour setting


Generate on a specific day

Whether to have the generation occur on a specific day of the week. It is best to auto-generate keys during a low peak day.

This setting has the following options:

Weekday

Day of the week on which the expiration monitor will run if the Check on a specific day option is selected.

Information Value
Default: Sunday
Range: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

Repeat interval

Period of time, in weeks, between each schedule time to check for expired certificates or the interval between schedule checks.

Information Value
Default: 4 weeks


Generate at an interval

Specifies to generate keys at the specified frequency regardless of the day of the week on which generation occurs.

Information Value
Default: Disabled

This setting has the following options:

Repeat interval

Period of time, in days, between each schedule time to check for expired certificates or the interval between schedule checks.

Information Value
Default: 7 days


Next start date

Date for the next scheduled check. This allows the deployment manager to be stopped and restarted without resetting the date.


Related

Keystores and certificates collection

Key set groups collection