> For the complete documentation index, see [llms.txt](https://docs.prismacloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.prismacloud.io/content-collections/application-security/get-started/connect-code-and-build-providers/ci-cd-runs/add-aws-codebuild.md).

# AWS Code Build

Integrate Prisma Cloud with your AWS Code Build to allow dynamic, automated, and context-specific scans within your development workflow. This includes continuous scanning of your workflow whenever changes are pushed or triggered, integrating security checks, and catching issues as soon as they are introduced. Additionally, it automates shift-left actions such as notifying developers or creating tickets, based on scan results.

1. Before you begin.
   1. [Generate and copy the Prisma Cloud access key](/content-collections/administration/create-access-keys.md) to enable access to Prisma Cloud. The access key includes a key ID and secret.
   2. Add the Prisma Cloud IP addresses and hostname for Application Security to an [allow list](/content-collections/get-started/console-prerequisites.md) to enable access to the Prisma Cloud Console.
   3. Grant the Prisma user integrating Prisma Cloud with AWS Code Build **Administrator** user permissions.
2. In Application Security.
   1. Select **Home** > **Settings** > **Connect Provider** > **Code & Build Providers**.

      <figure><img src="/files/XKnsAzR4JSx7Q1BGkVMp" alt="connect provider menu"><figcaption></figcaption></figure>
   2. Select **AWS Code Build** (under CI/CD Runs) in the catalog that is displayed.

      <figure><img src="/files/LSFiWuVPnPC2pbtFdyTL" alt="connect provider"><figcaption></figcaption></figure>

      The **Add Environment Variable** step of the integration wizard opens.
   3. Add the Prisma Cloud access key as an environment variable: Copy and paste the following code snippet into your CLI.

      `aws ssm put-parameter --name bc-api-key --value PRISMA_ACCESS_KEY::PRISMA_SECRET_KEY --type SecureString`

      Replace `PRISMA_ACCESS_KEY::PRISMA_SECRET` with your access key ID and secret generated in step 1.1 above.
   4. Select **Next**.
   5. Copy and paste the following sample code from the **Configure Subscription** step of the integration wizard into your **buildspec.yaml** configuration.

      The code is only a reference. Replace the values in the code with your own values.

      ```
      version: 0.2
      env:
        variables:
            BC_SOURCE: "codebuild"
            PRISMA_API_URL: "https://api2.prismacloud.io"
        parameter-store:
            BC_API_KEY: "bc-api-key"
      phases:
        install:
          runtime-versions:
            python: 3.8
          commands:
             - pip3 install checkov
             - echo Installing codebuild-extras...
             - curl -fsSL https://raw.githubusercontent.com/bridgecrewio/aws-codebuild-extras/master/install >> extras.sh
             - . ./extras.sh
        build:
          commands:
             - pip3 uninstall -y aws-sam-cli
             - checkov -d . --use-enforcement-rules --bc-api-key $BC_API_KEY --repo-id $CODEBUILD_ACCOUNT_ID/$CODEBUILD_PROJECT --branch $CODEBUILD_GIT_BRANCH -o cli -o junitxml --output-file-path console,test_results.xml
      reports:
        prisma-cloud-infrastructure-security:
          files:
             - test_results.xml
          discard-paths: yes
          file-format: JunitXml
      ```
   6. Save the file in the root (top level) directory.
   7. Select **Done**.
3. Verify integration.

   In **Application Security**, select **Home** > **Settings** > **CI/CD Runs** tab.

   Your integrated AWS Code Build repositories will be displayed. You may have to wait for up to three minutes before the status of the integration is updated.
4. Next step: Monitor and manage scan results.
   * The next AWS Code Build scan will automatically include the selected repositories
   * To view scan results and resolve issues, in **Application Security** select **Home** > **Projects**. See [Monitor and Manage Code Build Issues](https://github.com/PaloAltoNetworks/pc-docs-md/tree/main/enterprise-edition/content-collections/application-security/risk-management/monitor-and-manage-code-build/monitor-and-manage-code-build.md) for more information


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.prismacloud.io/content-collections/application-security/get-started/connect-code-and-build-providers/ci-cd-runs/add-aws-codebuild.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.