New Integrations Enablement

To enable creating a new integration with the JFrog Platform, set the flag for new integrations in the access.config.latest.yaml file.

1. Copy the access.config.latest.yaml file and rename it to access.config.import.yaml.

📘

Note

Do not update access.config.latest.yaml. Instead, edit the copy access.config.import.yaml. Upon the next Access restart, the import file is removed and becomes the access.config.latest.yaml file.

2. Open the access.config.import.yaml file.

3. Add this line in the new import file you created: integrations-enabled: true.

4. Complete the details in integration-templates by adding the ID of the integration, the name and the template. For example:

   YAML

   integrations-enabled: true 
   integration-templates: # list of possible integrations to create
     - id: "1"  # The id of the integration template, to save a reference back from the integration.
       name: "Slack integration" # The name of the integration as will appear in the UI when creating a new integration.
       redirect-uri: "https://my-jfrog-integrations.com/callback" # The redirect-uri that will direct users back to the integration client with the authorization code.
       scope: "applied-permissions/user" # Only this scope is currently supported.
       internal: false # Optional. Default false. Indicates whether it's an internal template, meaning will not be returned to UI unless specifically asked to include internal templates.

5. To make the integration page visible in the platform UI, set accessIntegration to true using one of the following options (both methods produce the same outcome — select whichever works best for you):

   1. Add the environment variable JF_FRONTEND_FEATURETOGGLER_ACCESSINTEGRATION and set it to true. For Artifactory versions above 7.60, if using Kubernetes, add the environment variable JF_FRONTEND_FEATURETOGGLER_ACCESSINTEGRATION to the frontend container environment variables.

      YAML

      frontend: 
        extraEnvironmentVariables: 
          - name: JF_FRONTEND_FEATURETOGGLER_ACCESSINTEGRATION 
            value: "true" # meaning will not be returned to UI unless specifically asked to include internal templates.

   2. Alternatively, in the system.yaml, set accessIntegration: true as follows:

      YAML

      Shared:
          featureToggler:
              accessIntegration: true

6. Restart Artifactory. This restarts the Access service, which populates access.config.import.yaml with the updated configuration values.