PingOne Advanced Identity Cloud

Custom attributes for user objects

When an administrator creates a custom attribute for the user identity object, the attribute is available in Advanced Reporting (custom reports) and filters.

Any new custom attributes for the user identity object are specific to the realm to which it was added.

Custom attribute example

  1. Add a custom attribute:

    1. In the Advanced Identity Cloud admin console, go to Identities > Configure.

    2. On the Managed Object Types page, select Alpha realm - User.

    3. Click the Properties tab, and then click add Add a Property.

    4. Select the String property type, and then click Next.

    5. In the New String Property modal, enter the following:

      • Property Key: enter department.

        For user managed object types, custom properties are automatically prefixed with custom_. For example, entering department creates the attribute as custom_department. Learn more about custom attributes in Create custom properties.

      • Display Label (optional): enter Custom department.

      • Select Required if the property is required.

        The required policy is assessed only during object creation, not when an object is updated. You can effectively bypass the policy by updating the object and supplying an empty value for that property. To prevent this inconsistency, select Required in the admin console and add a not-empty policy using the REST API.

    6. Click Save.

  2. Next, create a custom report using the Advanced Reporting feature:

    1. In the Advanced Identity Cloud admin console, go to Reports.

    2. Click add New Report.

    3. On the New Report modal, enter the following:

      • Name: Enter a descriptive name for the new report.

      • Description (optional): Enter a general description for the report.

      • Who can run: Select Users.

    4. Click Next.

    5. Click add Data Source.

    6. On the Add a Data Source modal, select Users and click Next.

    7. On the draft report page, select the properties in the right column that you want to appear in the report. For example:

      • Username

      • First Name

      • Common Name

      • Custom Department

        You can rearrange the columns by dragging and dropping them in the desired order.

    8. Click Save.

  3. On the Reports page, locate your custom report and click Run.

    1. On your report page, click Run Now.

    2. After your report has generated, click View Report.

    3. Review your report if you are satisfied with the results, click > Publish to activate it.

      An example of a generated custom report using a custom attribute.