AWS AmazonS3: Document instanceScope parameter for S3 Access Grants GetDataAccess
Summary
Adds a new 'Instance scope' section explaining the instanceScope parameter (SELF vs ALL) for GetDataAccess, describing how it controls whether credentials are returned from the caller's own S3 Access Grants instance or from instances shared via AWS RAM, and the MatchedInstanceArn response field.
Security assessment
The added text documents an authorization-scoping control: instanceScope=SELF restricts credential issuance to the caller's own account instance, while ALL broadens it to AWS RAM-shared instances. This is security-relevant authorization guidance but describes a feature rather than a fixed vulnerability.
Evidence
+The `instanceScope` parameter sets the scope of S3 Access Grants instances that S3 Access Grants searches for a grant that matches the `target` parameter. The default value is `SELF`, but the requester can set `instanceScope` to `ALL`.
Diff
diff --git a/AmazonS3/latest/userguide/access-grants-credentials.md b/AmazonS3/latest/userguide/access-grants-credentials.md index 6076cf6..23bda40 100644 --- a//AmazonS3/latest/userguide/access-grants-credentials.md +++ b//AmazonS3/latest/userguide/access-grants-credentials.md @@ -43,0 +44,4 @@ The `durationSeconds` parameter sets the temporary credential's duration, in sec +###### Instance scope + +The `instanceScope` parameter sets the scope of S3 Access Grants instances that S3 Access Grants searches for a grant that matches the `target` parameter. The default value is `SELF`, but the requester can set `instanceScope` to `ALL`. With `SELF`, the AWS account ID you pass in the request must be the account that owns the data, and S3 Access Grants returns credentials for the matching grant in that account's instance. If instances from other accounts are shared with you through AWS Resource Access Manager (AWS RAM), you can set `instanceScope` to `ALL`. S3 Access Grants then finds the account that owns the bucket in `target` and returns credentials for the matching grant in that account's instance. With `ALL`, the account ID in the request can be your own account ID. In both cases, the response includes the `MatchedInstanceArn` field, which identifies the instance that contains the matching grant. With `SELF`, this is the instance of the account ID in the request. With `ALL`, it's the instance where the grant matched, which can belong to another account. +