Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Synchronizing comments and attachments moved to GA and added in the docs


Live Search
spaceKeyZenGRCOnboardingGuide
additionalnone
placeholderSearch our site
typepage

Overview


Info
titleNOTE

For overall information on integrating Jira and ZenGRC, please see Jira Connector.


After Jira and ZenGRC are connected, you can select the Jira option when setting up an audit. This documentation shows where that option resides.

Info
titleNOTE
For overall information on integrating Jira and ZenGRC, please see Jira Connector

, along with additional steps needed when setting up a Jira audit.

Tip
titleTIP

If your organization is a member of our beta program, please see the documentation at Creating a Jira Audit - BetaExisting audits cannot be converted to Jira. The option can only be selected during the creation of a new audit after the ZenGRC and Jira integration is complete.

Step 1: Adding Basic Audit Information


To create a Jira audit, complete the following steps:

  1. Click New in the left-hand navigation and Audit.



  2. Complete the fields and select Jira in the Managed in drop-down.



    Tip
    titleTIP

    The dropdown boxes that display when Managed in Jira is selected are determined by settings in the connected Jira instance.

    In the Jira project dropdown, select a project.
    Image Removed
    This displays additional Jira dropdowns. Make selections for audit issue type, request issue type, and request issue link type.
    Tip
    titleTIP

    The following selections only determine how Jira is structured and do These selections do not impact ZenGRC. For example, if you select "Epic" in the Audit issue type dropdown, your audit is created as an Epic in Jira. And the selection of "Task" in the Request issue type dropdown means all audit requests imported during audit set up will be created as Tasks in Jira.

    Tip
    titleTIP

    Selections made in audit creation . But they still display in ZenGRC as requests.


  3. In the Jira project dropdown, select a project. This displays additional Jira dropdowns. Make selections for each. These selections override settings chosen when establishing connection between your ZenGRC and Jira instances.
    Click Next.

    Tip
    titleTIP
    Once Next is clicked


    Image Added

  4. Continue making selections for the remaining Jira fields as determined by your Jira project.

  5. The check boxes at page bottom provide the following functionality:
    • Synchronize comments - Selection that provides read-only ability to see all Jira comments within ZenGRC without opening the Jira ticket.
    • Synchronize attachments - Selection that displays Jira attachments as links within ZenGRC. The evidence still resides within Jira, but users don't need to open the Jira ticket, nor do they need Jira access.

      Image Added

  6. Click Next. After this point, you can no longer change where the audit is managed

    .



    Info
    titleNOTE

    For complete instructions on this step, please see Step 1: Adding Basic Audit Information.


Step 2: Defining the Scope


Step 2 in audit creation is the same for Jira and regular audits.

Info
titleNOTE
For

 For complete instructions on these steps, please see Step 2: Defining the Scope.

Step 3: Setting up Audit Requests - Jira


Infonote
titleNOTEIMPORTANT

Populating the requests template for a Jira audit has special considerations and is described in Configuring CSV Import for the Jira Connector.


After following the steps to populate the Jira requests template, and then importing it, the page displays import details. However, there is no action to take. To continue audit creation, complete the following:

  • Click Next.
  • The page displays for assessments.
    Info
    titleNOTE
    For complete instructions on this step, please see 

    configuring your CSV file for import, you can map them to controls. Please see Mapping Requests to Available Controls in Step 3: Setting up Audit Requests.

    Steps 4 and 5


    Step 4 and 5 in audit creation are the same for Jira and regular audits.
     

    Info
    titleNOTE
    For

     For complete instructions on these steps, please see Step 4: Generating Assessments and Step 5: Reviewing and Starting the Audit.