PingAuthorize

Setting up Redis external attribute caching with dsconfig

Before you begin

When using the dsconfig set-policy-decision-service-prop command, the new configuration must still be compliant with the following:

  • The pdp-mode property must be set to embedded.

  • The deployment-package-source-type property must be set to store or static-file.

    • If the deployment-package-source-type property is set to store, the deployment-package-store property must resolve to a valid deployment package store.

    • If the deployment-package-source-type property is set to static-file, the deployment-package-store property must resolve to a valid deployment package.

About this task

Here are the configuration options available for creating Redis external caches using the dsconfig tool. When using the dsconfig create-external-attribute-cache command, the new configuration must still be compliant with the required attributes associated with the specified cache type:

Option Description

mode

Required. Specifies Redis mode. Accepted values: single_instance, replicated, elasticache, or sentinel.

nodeAddresses

Required, only when mode is single_instance, replicated, or sentinel. Defines node addresses. A comma-separated list of Redis nodes.

replicationGroupId

Required, only when mode is elasticache. Replication group ID.

masterName

Required, only when mode is sentinel. Specifies name of the master node.

database

Optional, only when mode is sentinel. Database index used for Redis connection. Default value is 0.

scanInterval

Optional, only when mode is sentinel. Redis cluster scan interval in milliseconds. Default value is 1000.

checkSentinelList

Optional, only when mode is sentinel. Enables Sentinels list check during startup. Default value is false.

username

Optional, only when AUTH token authentication is enabled in the Redis provider.

password

Optional, only when AUTH token authentication is enabled in the Redis provider.

Steps

  1. Create the external attribute cache using the dsconfig create-external-attribute-cache command. For example:

    Example:

    $ dsconfig create-external-attribute-cache \
      --cache-name 'Single Instance' \
      --type redis-single-instance \
      --set redis-node-addresses:redis://localhost:6379
  2. Assign the defined external attribute cache to the Policy Decision Service. For example:

    Example:

    $ dsconfig set-policy-decision-service-prop \
      --set 'external-attribute-cache:Single Instance'

Result

Your external attribute cache has been defined and attached to the Policy Decision Service. There is no need to restart the server.