18.2.5. The configuration file

The Identity Portlets use some metadata which can be easily changed in the main configuration file, which is located at jboss-portal.sar/portal-identity.sar/conf/identity-ui-configuration.xml as shown here:
<identity-ui-configuration>

    <subscription-mode>automatic</subscription-mode>
    <admin-subscription-mode>automatic</admin-subscription-mode>
    <overwrite-workflow>false</overwrite-workflow>
    <email-domain>jboss.org</email-domain>
    <email-from>no-reply@jboss.com</email-from>
    <password-generation-characters>a...Z</password-generation-characters>
    <default-roles>
        <role>User</role>
    </default-roles>

    <!-- user interface components -->
    <ui-components>
        <ui-component name="givenname">
            <property-ref>user.name.given</property-ref>
        </ui-component>
        <ui-component name="familyname">
            <property-ref>user.name.family</property-ref>
        </ui-component>
        ...
</identity-ui-configuration>
  • subscription-mode: defines the User Portlet registration process
    • automatic: no validation nor approval (default)
    • jbp_identity_validation_workflow: e-mail validation, no approval
    • jbp_identity_validation_approval_workflow: e-mail validation and approval
    • custom: Take a look at Customizing the workflow
  • admin-subscription-mode: jBPM process used in the User Management Portlet for creating users
    • automatic: no validation nor approval (default)
    • jbp_identity_validation_workflow: e-mail validation, no approval
    • jbp_identity_validation_approval_workflow: e-mail validation and approval
    • custom: Take a look at Customizing the workflow
  • overwrite-workflow: if set to 'true' the workflow will be overwritten during the next startup (default: false)
  • email-domain: e-mail domain used in the validation e-mail by the template (can be anything)
  • email-from: e-mail fro field used by the validation e-mail
  • password-generation-characters: characters to use to generate a random password
  • default-roles: one or more default roles
    • available element: role
  • ui-components: Defines the available user interface components. Take a look at the next section for further details.
Due to the differentiation between subscription-mode and admin-subscription-mode it is possible to require e-mail validation and approval for new registrations and e-mail validation only when a user is created in the user management portlet.