Directory Server Documentation Index
Configuration Reference Home

Policy Configuration Key

Note: this component stores cluster-wide configuration data and is mirrored across all servers in the topology within the the same cluster.

Note: changes to cluster-wide configuration objects are immediately and automatically mirrored across all servers within the same cluster, so offline changes are not supported.

Policy Configuration Keys can be used to store arbitrary policy keys in the configuration that will store its corresponding value in obscured form. Policy Configuration Keys are decrypted to plaintext when viewing in user interfaces. This may be particularly useful when creating policies that may need to store credentials used to access external systems or other sensitive information.

Name represents as the key property that must be unique from other Policy Configuration Keys. Value represents as the stored encrypted value. Value doesn't not have to be unique and is encrypted when stored.

Relations to This Component
Properties
dsconfig Usage

Properties

The properties supported by this managed object are as follows:


Basic Properties: Advanced Properties:
↓ description  None
↓ policy-configuration-value

Basic Properties

description

Description
A description for this Policy Configuration Key
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
No
Admin Action Required
None. Modification requires no further action

policy-configuration-value

Description
Policy Configuration value
Default Value
None
Allowed Values
A string
Multi-Valued
No
Required
Yes
Admin Action Required
The Directory Server must be restarted for changes to this setting to take effect. Changes to this property will not take effect immediately until the server is restarted.


dsconfig Usage

To list the configured Policy Configuration Keys:

dsconfig list-policy-configuration-keys
     [--property {propertyName}] ...

To view the configuration for an existing Policy Configuration Key:

dsconfig get-policy-configuration-key-prop
     --key-name {name}
     [--tab-delimited]
     [--script-friendly]
     [--property {propertyName}] ...

To update the configuration for an existing Policy Configuration Key:

dsconfig set-policy-configuration-key-prop
     --key-name {name}
     (--set|--add|--remove) {propertyName}:{propertyValue}
     [(--set|--add|--remove) {propertyName}:{propertyValue}] ...

To create a new Policy Configuration Key:

dsconfig create-policy-configuration-key
     --key-name {name}
     --set policy-configuration-value:{propertyValue}
     [--set {propertyName}:{propertyValue}] ...

To delete an existing Policy Configuration Key:

dsconfig delete-policy-configuration-key
     --key-name {name}