Managing populations - PingOne Cloud Platform - PingOne

PingOne Cloud Platform

bundle
pingone
ft:publication_title
PingOne Cloud Platform
Product_Version_ce
PingOne Cloud Platform
PingOne
category
Administratorguide
ContentType
Guide
Product
Productdocumentation
p1
p1cloudplatform
ContentType_ce
Product documentation
Guide > Administrator Guide
Guide

PingOne allows you to organize users into populations to simplify user and policy management.

Click the appropriate tab for instructions on:

  • Viewing your existing populations and their details
  • Adding a new population
  • Making changes to a population
  • Deleting an unused population

Viewing populations

Use the Populations page to view populations in PingOne.

  1. Go to Directory > Populations.
  2. Locate and select the population you want to view. You can browse or search for populations.

    The population details page shows the following:

    • Name: A label for the population.
    • Description: (Optional) A brief characterization of the population.
    • Population ID: A unique identifier for the population.

      Click the Copy button to copy the population ID to the clipboard.

    • Identity Provider: (Optional) The default identity provider for the population.
    • Password Policy: The password policy assigned to the population. Click the tile to go to the Password policy page.
    • All Users: The number of users currently in the population. Click the tile to go to the Users page.
    • All Groups: The number of groups in the population. Click the tile to go to the Groups page.

    To edit a population, click the pencil icon. For more information, see Editing a population.

Adding a population

To use the Populations page to add a population to PingOne:

  1. Go to Directory > Populations.
  2. Click the + icon to add a population.
  3. Enter the following:
    • Name: A unique label for the population.
    • Description (Optional): A brief characterization of the population.
    • Identity Provider (Optional): The default identity provider for the population.
      Note:

      This setting is used at runtime for users in the population who do not have Authoritative Identity Provider configured in their user profile, and only for as long as they remain in the population. If Authoritative Identity Provider is set on the user profile, that setting is used. The user profile setting is not updated or changed by the setting on the population.

      You must have the Identity Data Admin role to configure this setting.

      See Users for more information.

    • Password Policy (Optional): The password policy enforced for users in the population.
      Note:

      If no policy is selected, PingOne uses the default policy.

    • Make default population: Specify the current population as the default population. Users created without a specified population are added to the default population.
      Note:

      If you are changing the default population, PingOne shows a confirmation message. Click the Switch button to confirm.

  4. Click Save.

Editing a population

Use the Populations page to edit an existing population.

  1. Go to Directory > Populations.
  2. Locate the population you want to edit. You can browse or search for populations.
  3. Click the population entry to open the details panel, and then click the pencil icon.
  4. Enter or edit the following:
    • Name: A unique label for the population.
    • Description: (Optional) A brief characterization of the population.
    • Password Policy: (Optional) The password policy enforced for users in the population.
      Note:

      If no policy is selected, the default policy is used.

    • Identity Provider (Optional): The default identity provider for the population.
      Note:

      This setting is used at runtime for users in the population who do not have Authoritative Identity Provider configured in their user profile, and only for as long as they remain in the population. If Authoritative Identity Provider is set on the user profile, that setting is used. The user profile setting is not updated or changed by the setting on the population.

      You must have the Identity Data Admin role to configure this setting.

      See Users for more information.

    • Make default population: Specify the current population as the default population. Users created without a specified population will be added to the default population.
      Note:

      If you are changing the default population, PingOne will show a confirmation message. Click the Switch button to confirm.

  5. Click Save.

Deleting a population

  • To delete a population, you must have the Environment Admin role.
  • Before you can delete a population, you must remove all identities from it.

To use the Populations page to remove populations that you no longer need:

  1. Go to Directory > Populations.
  2. Locate the population that you want to delete. You can browse or search for populations.
  3. Click the population entry to open the details panel.
  4. Click the three dots options menu, and then click Delete.
  5. Click Delete to confirm.