Skip to content

Commit 14d9407

Browse files
authored
fix: add external id to aws assume role (#2384)
1 parent 92d4cbf commit 14d9407

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

docs/en/guides/40-load-data/00-stage/06-aws-iam-role.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,14 @@ title: "Creating External Stage with AWS IAM Role"
44

55
# Why IAM Role
66

7-
With AWS IAM Role, you can access your own AWS S3 buckets in Databend Cloud. This allows you to securely access your data and perform data analysis without having to manage your AWS credentials.
7+
AWS IAM (Identity and Access Management) Role provides a secure and flexible way to manage access to your AWS resources. When working with Databend Cloud, using IAM Role offers several key benefits:
8+
9+
- **Enhanced Security**: Instead of storing AWS access keys and secrets, IAM Role enables temporary credential access, significantly reducing security risks.
10+
- **Simplified Access Management**: You can manage permissions centrally through AWS IAM, making it easier to control who can access your S3 buckets and what operations they can perform.
11+
- **Seamless Integration**: Databend Cloud can securely access your AWS S3 buckets without requiring you to manage or rotate credentials manually.
12+
- **Compliance and Audit**: IAM Role provides detailed audit trails of access to your S3 buckets, helping you maintain compliance with security policies.
13+
14+
By using IAM Role, you can securely connect your Databend Cloud environment to your AWS S3 buckets while maintaining full control over access permissions and security policies.
815

916
# How to Use IAM Role
1017

@@ -57,6 +64,11 @@ With AWS IAM Role, you can access your own AWS S3 buckets in Databend Cloud. Thi
5764
"Principal": {
5865
"AWS": "arn:aws:iam::123456789012:role/xxxxxxx/tnabcdefg/xxxxxxx-tnabcdefg"
5966
},
67+
"Condition": {
68+
"StringEquals": {
69+
"sts:ExternalId": "my-external-id-123"
70+
}
71+
},
6072
"Action": "sts:AssumeRole"
6173
}
6274
]
@@ -72,7 +84,7 @@ With AWS IAM Role, you can access your own AWS S3 buckets in Databend Cloud. Thi
7284
4. Run the following SQL statement in Databend Cloud cloud worksheet or `BendSQL`:
7385

7486
```sql
75-
CREATE CONNECTION databend_test STORAGE_TYPE = 's3' ROLE_ARN = 'arn:aws:iam::987654321987:role/databend-test';
87+
CREATE CONNECTION databend_test STORAGE_TYPE = 's3' ROLE_ARN = 'arn:aws:iam::987654321987:role/databend-test' EXTERNAL_ID = 'my-external-id-123';
7688

7789
CREATE STAGE databend_test URL = 's3://test-bucket-123' CONNECTION = (CONNECTION_NAME = 'databend_test');
7890

0 commit comments

Comments
 (0)