Skip to content

Commit 365b575

Browse files
authored
S3 connectors: how to refresh expired AWS STS session tokens (#612)
1 parent 9db5956 commit 365b575

File tree

1 file changed

+19
-0
lines changed
  • snippets/general-shared-text

1 file changed

+19
-0
lines changed

snippets/general-shared-text/s3.mdx

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,25 @@ requirements. For more information about requirements, see the following:
8888
allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
8989
allowfullscreen
9090
></iframe>
91+
92+
<Warning>
93+
AWS STS credentials can be valid for as little as 15 minutes or as long as 36 hours, depending on how the credentials were initially
94+
generated. After the expiry time, the credentials are no longer valid will no longer work with the corresponding S3 connector.
95+
You must get a new set of credentials to replace the expired ones by calling
96+
[GetSessionToken](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetSessionToken.html) in the AWS STS API.
97+
To overwrite the expired credentials with the new set:
98+
99+
- For the Unstructured user interface (UI), manually update the AWS Key, AWS Secret Key, and STS Token fields in the Unstructured UI
100+
for the corresponding S3 [source](/ui/sources/s3) or [destination](/ui/destinations/s3) connector.
101+
- For the Unstructured API, use the Unstructured Workflow Endpoint to call the
102+
[update source](/api-reference/workflow/overview#update-a-source-connector) or
103+
[update destination](/api-reference/workflow/overview#update-a-destination-connector) connector operation
104+
for the corresponding S3 [source](/api-reference/workflow/sources/s3) or
105+
[destination](/api-reference/workflow/destinations/s3) connector.
106+
- For Unstructured Ingest, change the values of `--key`, `--secret`, and `--token` (CLI) or `key`, `secret`, and `token` (Python) in your command or code for the
107+
corresponding S3 [source](/ingestion/source-connectors/s3) or [destination](/ingestion/destination-connectors/s3) connector.
108+
109+
</Warning>
91110

92111
- If the target files are in the root of the bucket, the path to the bucket, formatted as `protocol://bucket/` (for example, `s3://my-bucket/`).
93112
If the target files are in a folder, the path to the target folder in the S3 bucket, formatted as `protocol://bucket/path/to/folder/` (for example, `s3://my-bucket/my-folder/`).

0 commit comments

Comments
 (0)