Importing workflows from a GitHub repository - Platform - BlueCat Gateway - 24.1

Gateway Administration Guide

Product name
BlueCat Gateway

When importing workflows from GitHub, you can import from a private GitHub repository or import publicly-available workflows from the BlueCat Labs public GitHub repository. BlueCat recommends this approach for new customers who want to start using BlueCat Gateway immediately. Your Gateway instance must have access to the Internet via ports 80 and 443 to import workflows from a remote GitHub repository.

Note: If you are importing workflows from a private GitHub repository, you must provide an authorization token (sometimes called an "auth token").

To import workflows from the BlueCat public GitHub repository:

  1. Open the Workflow management window. (Click the Navigator button if necessary, then click Administration > Workflow management.)

  2. Click Import (on the right side of the page).

  3. In the Import workflows window, select the workflows that you want to import:

    1. In Import source, select GitHub.

    2. In GitHub URL, enter the URL for the workflow package, using the following format:
      (GitHub URL)/archive/(branch).zip
    3. If you are using a private GitHub repository, in Authentication token, paste or enter a valid authentication token for the GitHub session.

    4. (Optional) To delete the current workflows and replace them with the imported ones, select the Overwrite Existing Workspace checkbox.

    When you're done, click Import, then confirm the operation

  4. (Optional, but recommended) After importing the workflow, refresh your browser, then assign appropriate permissions to user groups for the new workflow. For more details, see Setting page and REST endpoint permissions.

    If you do not assign user groups to the workflow, only admin users will be able to use or see it.