Export Roles

Required User Role: Administrator

On the Roles page, you can export one or more user groups in CSV or JSON format.

To export your user roles:

1. In the left navigation, click Settings.

   The Settings page appears.

2. Click the Access Control tile.

   The Access Control page appears. On this page, you can control user and group access to resources in your Tenable Vulnerability Management account.

3. Click the Roles tab.

   The Roles page appears. This page contains a table that lists all the Tenable-provided and custom roles on your Tenable Vulnerability Management instance.

4. (Optional) Refine the table data. For more information, see Tenable Vulnerability Management Workbench Tables.

5. Do one of the following:

   To export a single role:

   1. In the roles table, right-click the row for the role you want to export.

      The action options appear next to your cursor.

      -or-

      In the roles table, in the Actions column, click the button in the row for the role you want to export.

      The action buttons appear in the row.

   2. Click Export.

   To export multiple roles:

   1. In the roles table, select the check box for each role you want to export.

      The action bar appears at the top of the table.

   2. In the action bar, click Export.

      Note: You can individually select and export up to 200 roles. If you want to export more than 200 roles, you must select all the roles on your Tenable Vulnerability Management instance by selecting the check box at the top of the roles table and then click Export.

   The Export plane appears. This plane contains:

   • A text box to configure the export file name.
   • A list of available export formats.
   • A table of configuration options for fields to include in the exported file.

   Note: By default, all fields are selected.

   • A text box to set the number of days before the export expires.
   • A toggle to configure the export schedule.
   • A toggle to configure the email notification.
6. In the Name box, type a name for the export file.

7. Click the export format you want to use:

   Format	Description
   CSV	A CSV text file that contains a list of roles. Note: If your .csv export file includes a cell that begins with any of the following characters (=, +, -, @), Tenable Vulnerability Management automatically inputs a single quote (') at the beginning of the cell. For more information, see the related knowledge base article.
   JSON	A JSON file that contains a nested list of roles. Empty fields are not included in the JSON file.

8. (Optional) Deselect any fields you do not want to appear in the export file.

9. In the Expiration box, type the number of days before the export file expires.

   Note: Tenable Vulnerability Management allows you to set a maximum of 30 calendar days for export expiration.

10. (Optional) To set a schedule for your export to repeat:

    • Click the Schedule toggle.

    The Schedule section appears.

    • In the Start Date and Time section, select the date and time on which you want the export schedule to start.
    • In the Time Zone drop-down box, select the time zone to which you want the schedule to adhere.
    • In the Repeat drop-down box, select how often you want the export to repeat.
    • In the Repeat Ends drop-down, select the date on which you want the schedule to end.

      Note: If you select never, the schedule repeats until you modify or delete the export schedule.

11. (Optional) To send email notifications on completion of the export:

    Note: You can enable email notifications with or without scheduling exports.

    • Click the Email Notification toggle.

      The Email Notification section appears.

    • In the Add Recipients box, type the email addresses to which you want to send the export notification.

    • (Required) In the Password box, type a password for the export file. You must share this password with the recipients to allow them to download the file.

      Note: Tenable Vulnerability Management sends an email to the recipients and from the link in the email, the recipients can download the file by providing the correct password.

12. Click Export.

    Tenable Vulnerability Management begins processing the export. Depending on the size of the exported data, Tenable Vulnerability Management may take several minutes to process the export.

    When processing completes, Tenable Vulnerability Management downloads the export file to your computer. Depending on your browser settings, your browser may notify you that the download is complete.

13. Access the export file via your browser's downloads directory. If you close the export plane before the download finishes, then you can access your export file in the Export Management View.