Send Docs Feedback

Configure rules used to auto generate Edge UI passwords

Edge for Private Cloud v. 4.17.01

These properties are available in Edge version 4.17.01.01 and later.

The Edge UI auto generates user passwords for new users. Users are typically then sent an email that allows them to change the auto generated password.

By default, the Edge UI auto generates passwords that are compatible with the default password rules defined on the Edge Management Server. These rules specify that passwords are at least eight characters long and include at least one special character and one upper-case character. See Resetting Edge Passwords for information on how to configure Edge password rules.

You can change the password rules on the Management Server to make passwords more strict. For example, you can increase the minimum length to 10 characters, require multiple special characters, etc. If you change the rules on the Management Server, you also have to change the Edge UI to auto generate passwords compatible with the new rules.

The Edge UI define four properties that you use to set the rules for auto generating password: 

conf_apigee-base_apigee.forgotPassword.underscore.minimum="1"
conf_apigee-base_apigee.forgotPassword.specialchars.minimum="1"
conf_apigee-base_apigee.forgotPassword.lowecase.minimum="1"
conf_apigee-base_apigee.forgotPassword.uppercase.minimum="1"

There is no property to set the minimum password length. The Edge UI auto generates very long passwords that exceed any minimum password length that you set on the Management Server. 

To set these properties:

  1. Open the ui.properties file in an editor. If the file does not exist, create it::
    > vi /opt/apigee/customer/application/ui.properties
  2. Set the properties:
    conf_apigee-base_apigee.forgotPassword.underscore.minimum="2"
    conf_apigee-base_apigee.forgotPassword.specialchars.minimum="3"
    conf_apigee-base_apigee.forgotPassword.lowecase.minimum="2"
    conf_apigee-base_apigee.forgotPassword.uppercase.minimum="2"
  3. Save your changes.
  4. Make sure the properties file is owned by the 'apigee' user:
    > chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. Restart the Edge UI:
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
 

Help or comments?