GitHub Repositories

To use the content in our GitHub repositories, you must have them configured in Automation. These repositories are typically configured by default; if they are not configured in your tenant, use the instructions below to configure them.

Perform the following steps to add a Git repository for atomic actions to your tenant.

  1. Choose Automate > Advanced in the navigation menu.

  2. Click the Git Repositories tab.

  3. Click the New Git Repository button on the right (or click the Display name of an existing repository to update).

  4. On the New Git Repository page, in the General area, enter a Display Name for the repository.

    New Git Repository

  5. In the Account Keys area, click the No Account Keys drop-down menu and choose True.

    No Account Keys True

    Note: You may see a 403 Forbidden error when importing content from GitHub. Some of the repositories we configure for you are created without credentials. Unauthenticated API requests to GitHub are rate-limited so, if you want to avoid this, you can update the repository configurations with an account key using the procedure in the Add Account Key section below.

  6. In the Git area, enter the Git information:

    • Protocol: HTTPS

    • REST API Repository Type: GitHub

    • REST API Repository: api.github.com/repos/CiscoSecurity/sxo-05-security-workflows

    • Branch: Main

    • Code Path: Atomics

      Atomics Repo Git Info

  7. Click Submit.

    When the operation completes, you will see a green success message at the top of the page.

    New Atomics Repo Creation Success

Perform the following steps to add a workflows repository to your tenant.

  1. Choose Automate > Advanced in the navigation menu.

  2. Click Git Repositories.

  3. Click New Git Repository (or click the existing repository that you want to update).

  4. On the Add Git Repository page, in the General area, enter a Display Name for the repository.

  5. In the Account Keys area, click the No Account Keys drop-down menu and choose True.

    Note: You may see a 403 Forbidden error when importing content from GitHub. Some of the repositories we configure for you are created without credentials. Unauthenticated API requests to GitHub are rate-limited so, if you want to avoid this, you can update the repository configurations with an account key using the procedure in Add Account Key section below.

  6. In the Git area, enter the Git information:

    • Protocol: HTTPS
    • REST API Repository Type: GitHub
    • REST API Repository: api.github.com/repos/CiscoSecurity/sxo-05-security-workflows
    • Branch: Main
    • Code Path: Workflows

  7. Click Submit.

    When the operation completes, you will see a green success message at the top of the page.

  1. Choose Automate > Advanced in the navigation menu.

  2. Click Git Repositories.

  3. Click New Git Repository (or click the existing repository that you want to update).

  4. On the Add Git Repository page, in the General area, enter a Display Name for the repository.

  5. In the Account Keys area, click the No Account Keys drop-down menu and choose True.

    Note: You may see a 403 Forbidden error when importing content from GitHub. Some of the repositories we configure for you are created without credentials. Unauthenticated API requests to GitHub are rate-limited so, if you want to avoid this, you can update the repository configurations with an account key using the procedure in the Add Account Key section below.

  6. In the Git area, enter the Git information:

    • Protocol: HTTPS
    • REST API Repository Type: GitHub
    • REST API Repository: api.github.com/repos/CiscoSecurity/sxo-05-security-workflows
    • Branch: Main
    • Code Path: Workflows-Default

  7. Click Submit.

    When the operation completes, you will see a green success message at the top of the page.

Add an account key if you use any repositories that require authentication, or receive a 403 Forbidden error when importing content from GitHub. Perform the following steps to add an account key to any of your Git repositories.

Note: If your GitHub account has two-factor authentication enabled, you must use a personal access token. To generate a token, see the GitHub instructions.

  1. Create a new Git repository using one of the methods above.

  2. Choose Automate > Account Keys in the navigation menu.

  3. Click New Account Key on the right.

  4. On the New Account Key page, in the Account Key Type area, click the Account Key Type drop-down menu and then choose Git Password-Based Credentials.

  5. In the General area, enter a Display Name.

  6. In the Git area, enter your GitHub username and password.

    Note: If you have a personal access token, enter the token instead of your password.

  7. Click Submit.

    When the operation completes, you will see a green success message at the top of the page.

  8. In the left navigation menu, click Admin.

  9. Click the Display name of the repository you want to use the account key with and perform the following steps:

    1. In the Account Keys area, click the No Account Keys drop-down menu and choose False.
    2. Click the Default Account Keys drop-down menu and choose the account key you created.
    3. Click Submit.

      4. When the operation completes, you will see a green success message at the top of the page.

      Repeat these steps to add account keys to any additional repositories you want to use them with.