17.12 Downloading and Importing Business Roles and Approval Policies

You can download business roles, approval policies and other referenced objects and import them later into an Identity Governance environment. The download will either generate a single JSON file or a zip file depending on the options you select during download, such as associated applications and assigned categories. In addition to downloading the business role or approval policy definitions, you can download the list of objects as a CSV file.

To download or import business roles and business role definitions:

  1. Log in to Identity Governance as a Customer, Global, or Business Roles Administrator.

  2. Under Policy, select Business Roles.

  3. To download:

    • A list of business roles with description, owners, and managers as a CSV file, select Actions > Download all as CSV on the Roles tab.

    • To download all business role definitions, select Actions > Download Definitions.

    • To download one or more business role definitions, select Actions > Download Definitions.

      • Select one or more roles on the Roles tab.

      • Type the business role name or a meaningful description.

      • (Optional) Include references to business role owners, managers, and fulfillers; and download included business roles, associated applications, technical roles, and assigned categories and approval policies.

      • Click Download.

  4. Select the download icon on the top title bar to access the saved files and download the files.

  5. (Optional) Delete the file from the download area in Identity Governance.

    If you do not manually delete files, Identity Governance will automatically delete files based on your default download retention day settings. For information about customizing download settings, see Section 3.9, Customizing Download Settings.

  6. If you make changes or want to import previously downloaded business roles into another environment, select Import Business Roles on the Roles tab.

  7. Navigate to the business roles JSON or zip file, select the file to import, then click Open.

  8. Identity Governance detects whether you are importing new or updated roles and whether the updates would create any conflicts or have unresolved references.

  9. Select how to continue based on what information the application user interface displays. For example, under Updates, you can compare the imported values with current values for each role by selecting the respective role before selecting the roles to import.

  10. Select the roles you want to import, then click Import.

    NOTE:Identity Governance does not automatically publish imported business roles. You must publish them in order for them to take effect in the system. For more information, see Publishing or Deactivating Business Roles.

  11. (Conditional) If you import more than the preconfigured threshold for the number of roles that can be displayed on the import page, Identity Governance will switch to bulk import mode. When in bulk mode, instead of selecting whether to create, update, or handle conflicts for specific roles, you can select to import all new roles and update all existing roles. For conflicts, you can choose to either overwrite existing roles or create new roles.

    NOTE:The default value for roles that can be displayed is 200 or the value specified in com.netiq.iac.importExport.maxImportsToDisplay property.

  12. (Optional) Download the auto-generated import report from the download area. The import report will identify what was imported as well as call out any unresolved references.

To download or import business role approval policies:

  1. Log in to Identity Governance as a Customer, Global, or Business Roles Administrator.

  2. Under Policy, select Business Roles.

  3. Select a policy or all the policies on the Approval Policies tab.

  4. Select Actions > Download Definitions.

    1. Type the approval policy name or a meaningful description.

    2. (Optional) Include references to the approval policy approver.

    3. Select Download.

    4. Select the download icon on the top title bar to access the saved file and download the file.

    5. (Optional) Delete the file from the download area in Identity Governance.

      If you do not manually delete files, Identity Governance will automatically delete files based on your default download retention day settings. For information about customizing download settings, see Section 3.9, Customizing Download Settings.

  5. If you make changes, or want to want to import previously downloaded approval policies into another environment, select Import Approval Policies on the Approval Policies tab.

  6. Navigate to the approval policy JSON or zip file, select the file to import, then click Open.

  7. Identity Governance detects whether you are importing new or updated policies and whether the updates would create any conflicts or have unresolved references.

  8. Select how to continue based on what information the application user interface displays. For example, under Updates, you can compare the imported values with current values for each entity by selecting the respective policy before selecting the policies to import.

  9. Select the policies you want to import, then click Import.

  10. (Conditional) If you import more than the preconfigured threshold for the number of policies that can be displayed in the import page, Identity Governance will switch to bulk import mode. When in bulk mode, instead of selecting whether to create, update, or handle conflicts for specific policies, you can select to import all new policies and update all existing policies. For conflicts, you can choose to either overwrite existing policies or create new policies.

    NOTE:The default value for policies that can be displayed is 200 or the value specified in com.netiq.iac.importExport.maxImportsToDisplay property.

  11. (Optional) Download the auto-generated import report from the download area. The import report will identify what was imported as well as call out any unresolved references.