---
title: Random Password Generator
description: The Random Password Generator creates random passwords based on fixed-length strings built from one or more character sets.
component: pingds
version: 8.1
page_id: pingds:configref:objects-random-password-generator
canonical_url: https://docs.pingidentity.com/pingds/8.1/configref/objects-random-password-generator.html
section_ids:
  parent: Parent
  random_password_generator_properties: Random Password Generator properties
  basic_properties: Basic properties
  enabled: enabled
  password-character-set: password-character-set
  password-format: password-format
  advanced_properties: Advanced properties
  java-class: java-class
---

# Random Password Generator

The Random Password Generator creates random passwords based on fixed-length strings built from one or more character sets.

## Parent

The Random Password Generator object inherits from [Password Generator](objects-password-generator.html).

## Random Password Generator properties

You can use configuration expressions to set property values at startup time. For details, see [Property value substitution](expressions.html).

| Basic Properties                                                                                          | Advanced Properties       |
| --------------------------------------------------------------------------------------------------------- | ------------------------- |
| [enabled](#enabled) [password-character-set](#password-character-set) [password-format](#password-format) | [java-class](#java-class) |

### Basic properties

Use the `--advanced` option to access advanced properties.

### enabled

|                         |                                                              |
| ----------------------- | ------------------------------------------------------------ |
| *Synopsis*              | Indicates whether the Password Generator is enabled for use. |
| *Default value*         | None                                                         |
| *Allowed values*        | truefalse                                                    |
| *Multi-valued*          | No                                                           |
| *Required*              | Yes                                                          |
| *Admin action required* | None                                                         |
| *Advanced*              | No                                                           |
| *Read-only*             | No                                                           |

### password-character-set

|                         |                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Synopsis*              | Specifies one or more named character sets.                                                                                                                                                                                                                                                                                                                            |
| *Description*           | This is a multi-valued property, with each value defining a different character set. The format of the character set is the name of the set followed by a colon and the characters that are in that set. For example, the value "alpha:abcdefghijklmnopqrstuvwxyz" defines a character set named "alpha" containing all of the lower-case ASCII alphabetic characters. |
| *Default value*         | None                                                                                                                                                                                                                                                                                                                                                                   |
| *Allowed values*        | A character set name (consisting of ASCII letters) followed by a colon and the set of characters that are included in that character set.                                                                                                                                                                                                                              |
| *Multi-valued*          | Yes                                                                                                                                                                                                                                                                                                                                                                    |
| *Required*              | Yes                                                                                                                                                                                                                                                                                                                                                                    |
| *Admin action required* | None                                                                                                                                                                                                                                                                                                                                                                   |
| *Advanced*              | No                                                                                                                                                                                                                                                                                                                                                                     |
| *Read-only*             | No                                                                                                                                                                                                                                                                                                                                                                     |

### password-format

|                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Synopsis*              | Specifies the format to use for the generated password.                                                                                                                                                                                                                                                                                                                                                                                                                                |
| *Description*           | The value is a comma-delimited list of elements in which each of those elements is comprised of the name of a character set defined in the password-character-set property, a colon, and the number of characters to include from that set. For example, a value of "alpha:3,numeric:2,alpha:3" generates an 8-character password in which the first three characters are from the "alpha" set, the next two are from the "numeric" set, and the final three are from the "alpha" set. |
| *Default value*         | None                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| *Allowed values*        | A comma-delimited list whose elements comprise a valid character set name, a colon, and a positive integer indicating the number of characters from that set to be included.                                                                                                                                                                                                                                                                                                           |
| *Multi-valued*          | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| *Required*              | Yes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| *Admin action required* | None                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| *Advanced*              | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| *Read-only*             | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

## Advanced properties

Use the `--advanced` option to access advanced properties.

### java-class

|                         |                                                                                                                  |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
| *Synopsis*              | Specifies the fully-qualified name of the Java class that provides the Random Password Generator implementation. |
| *Default value*         | org.opends.server.extensions.RandomPasswordGenerator                                                             |
| *Allowed values*        | A Java class that extends or implements:- org.opends.server.api.PasswordGenerator                                |
| *Multi-valued*          | No                                                                                                               |
| *Required*              | Yes                                                                                                              |
| *Admin action required* | None                                                                                                             |
| *Advanced*              | Yes                                                                                                              |
| *Read-only*             | No                                                                                                               |