Key set groups settings

Use this page to create new key set groups.

To view this administrative console page, click Security > SSL certificate and key management > Manage endpoint security configurations > {Inbound | Outbound} > ssl_configuration . Under Related items, click Key set groups > New.

Configuration tab

Key set group name

Specifies the 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.

Data type: Text

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

Specifies that 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 [Fix Pack 23 or later] Avoid trouble: Starting with Version 6.1.0.23, the default value for this property is Disabled.gotcha
[Fix Pack 23 or later] If you try to enable this property, and automatic synchronization is off in any node, the following administrative console message displays:
Warning: At least one node in the cell was unreachable or is not configured to automatically synchronize. 
It is strongly recommended that you verify your node settings, and do not enable automatic 
generation of LTPA keys while automatic syncronization is disabled on any node.
Default for Versions 6.0.x through 6.1.0.21 Enabled
Default for Versions 6.1.0.23 and higher: Disabled

Scheduled time for generation

Specifies the scheduled time when the system generates selected key set group or groups. You can specify the scheduled time in hours and minutes; specify either A.M. or P.M., or specify 24-hour. You can also specify the day of the week you want the scheduled event to occur. It is recommended that you set this event to occur during a low peak time, especially for keys that are used by runtime for token validation.

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

Specifies 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
Specifies the day of the week on which the expiration monitor will run if the Check on a specific day option is selected.
Default: Sunday
Range: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Repeat interval
Specifies the period of time, in weeks, between each schedule time to check for expired certificates or the interval between schedule checks.
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.

Default: Disabled
This setting has the following options:
Repeat interval
Specifies the period of time, in days, between each schedule time to check for expired certificates or the interval between schedule checks.
Default: 7 Days

Next start date

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




Related tasks
Creating a Secure Sockets Layer configuration
Related reference
Key stores and certificates collection
Key set groups collection
Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 12:02:36 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-zos&topic=usec_sslnewkeysetgrp
File name: usec_sslnewkeysetgrp.html