GitHub Repositories

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

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

  1. Navigate to Automate > Workspace in the navigation menu.

  2. Click the Git Repos 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 section, choose No account key from the drop-down menu.

    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 section, enter the following 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. Navigate to Automate > Workspace in the navigation menu.

  2. Click theGit Repos tab.

  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 section, select No Account Keys from the drop-down menu.

    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 section, enter the following 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. Navigate to Automate > Workspace.

  2. Click Git Repos.

  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 section, enter a Display Name for the repository.

  5. In the Account Keys section, choose No Account Keys from the drop-down menu.

    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 section, enter the following 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. Navigate to Automate > Targets in the navigation menu.

  3. Click the Account Keys tab.

  4. Click the New Account Key button.

  5. On the New Account Key page, in the Account Key Type section, choose Git Password-Based Credentials from the Account Key Type drop-down menu.

  6. In the General section, enter a Display Name.

  7. In the Git section, enter your GitHub username and password.

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

  8. Click Submit.

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

  9. In the left navigation menu, click Admin.

  10. 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 section, choose the account key you created from the Default Account Keys drop-down menu.
    2. Click Submit.

      3. 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.