Connect to your JFrog instance using the DevOps Change Workspace playbook to track artifact repositories published to JFrog.

Before you begin

Complete the tasks specified in the Getting started with DevOps Change Velocity topic.

Role required: sn_devops.admin or sn_devops.tool_owner

Procedure

  1. Navigate to Workspaces > DevOps Change Workspace and use one of the following options to open the Playbook to onboard JFrog.
    OptionSteps
    Homepage
    1. Select the Connect tool widget
    2. On the  Connect to a tool  modal, select JFrog from the Artifact category.
    Applications module
    1. Select Applications (Applications icon.).
    2. Select an existing application, or create one. To create an application, see Create an application - Classic.
    3. From the  Recommended actions  pane, select the  Connect a tool  card.
    4. On the  Connect to a tool  modal, select JFrog from the Artifact category.
    Tools module
    1. Select Tools (Tools icon.).
    2. From the Capability list, select Artifact.
    3. Select Connect a tool.
    4. On the  Connect to a tool  modal, select JFrog.
  2. Specify a name for the tool in the Tool name field, and select Next.

    Connect to the JFrog tool screen

  3. On the JFrog instance details playbook activity:
    1. Enter the URL of your JFrog instance.
    2. Enter the login credentials of the global admin for the JFrog instance.
    3. (Optional) Select the MID Server option and enter its details if your JFrog instance is attached to a MID Server.
      A MID server is required if your tool instance is hosted on-prem. For more information about MID server, see MID Server selection.

    Connect to the JFrog tool - Enter instance details screen

  4. Select Connect.
  5. Permission checks are run on the credentials that you entered.
    Permissions required and permissions that are available are displayed. If you want to enter credentials with better permissions, select Re-enter credentials. The credentials that you specified must have the Administer Platform role in JFrog for seamless discovery and import of tool objects. This is a limitation from JFrog. For detailed information on all the required permissions, see Jira permissions in Permissions required for DevOps tools.
    You can choose to continue with the tool connection even if you don't have all the required permissions.
    Note: If your tool credential has changed, you must update the credentials in your ServiceNow instance. For more information, see Update third-party tool credentials in DevOps Change Velocity.

    Connect to JFrog tool - Permission checks screen

  6. Select Next.
  7. Specify the access for the tool.
    1. If you want to control access to the tool, add the groups that must be given access to the tool in the Maintained by field.
      The tasks these users in the groups can perform depends on the role assigned to them.
      • DevOps Tool Owner role: Can view and edit the tool.
      • DevOps App Owner role: Can view the tool and can associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's objects (such as plans, repositories, and pipelines).
      • DevOps Administrator role: Can edit all tools.
      • Other DevOps roles: Can view the tool.
      Note: If you don't select a group and skip this step, all users with the DevOps Tool Owner role will be able to edit the tool.
    2. If you choose to control access to the tool, the All App Owners can view and associate tool objects to applications option becomes available for selection.

      This option enables all users having the DevOps App Owner role to access the tool. If selected, they’ll be able to view, associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's objects.

    3. Select Assign.

    Specify tool access

  8. From the Summary page, select View tool record to review the details of the connected instance.

    Connection summary

Result

You’ve successfully onboarded your JFrog tool to DevOps Change Velocity.