AWS codebuild: Document iam:PassRole requirement for CodeBuild StartBuild APIs
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` `