AWS Security ChangesHomeSearch

AWS codebuild: Document iam:PassRole requirement for CodeBuild StartBuild APIs

Service: codebuild · 2026-10-24 · Documentation medium

File: codebuild/latest/userguide/auth-and-access-control-permissions-reference.md · Type: iam

Summary

Expands the CodeBuild permissions reference: StartBuild now lists iam:PassRole (needed with serviceRoleOverride) and adds a StartBuildBatch entry requiring iam:PassRole for serviceRoleOverride or buildBatchConfigOverride.serviceRole, with project and role resource ARNs.

Security assessment

The change documents that starting builds/batch builds with a role override requires iam:PassRole and specifies the exact project and IAM role resource ARNs, which is IAM least-privilege and privilege-escalation-relevant guidance. It is security documentation rather than a fix for a specific disclosed vulnerability.

Evidence

+**Actions:** `codebuild:StartBuild`, `iam:PassRole`

Diff

diff --git a/codebuild/latest/userguide/auth-and-access-control-permissions-reference.md b/codebuild/latest/userguide/auth-and-access-control-permissions-reference.md
index ffb508a..374eaf4 100644
--- a//codebuild/latest/userguide/auth-and-access-control-permissions-reference.md
+++ b//codebuild/latest/userguide/auth-and-access-control-permissions-reference.md
@@ -284 +284,26 @@ StartBuild
-**Action:** `codebuild:StartBuild`
+**Actions:** `codebuild:StartBuild`, `iam:PassRole`
+
+Required to start running builds. `iam:PassRole` is required only when the request includes `serviceRoleOverride`.
+
+**Resources:**
+
+  * `arn:aws:codebuild:`region-ID`:`account-ID`:project/`project-name` `
+
+  * `arn:aws:iam::`account-ID`:role/`role-name` `
+
+
+
+
+StartBuildBatch
+    
+
+**Actions:** `codebuild:StartBuildBatch`, `iam:PassRole`
+
+Required to start running batch builds. `iam:PassRole` is required only when the request includes `serviceRoleOverride` or `buildBatchConfigOverride.serviceRole`.
+
+**Resources:**
+
+  * `arn:aws:codebuild:`region-ID`:`account-ID`:project/`project-name` `
+
+  * `arn:aws:iam::`account-ID`:role/`role-name` `
+
@@ -286 +310,0 @@ StartBuild
-Required to start running builds.
@@ -288 +311,0 @@ Required to start running builds.
-**Resource:** `arn:aws:codebuild:`region-ID`:`account-ID`:project/`project-name` `