Skip to content

Commit 280a18c

Browse files
chore(docs): add info on using Storage Browser with existing S3 buckets (#6560)
1 parent 12a452d commit 280a18c

File tree

1 file changed

+6
-0
lines changed
  • docs/src/pages/[platform]/connected-components/storage/storage-browser

1 file changed

+6
-0
lines changed

docs/src/pages/[platform]/connected-components/storage/storage-browser/react.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,12 @@ export const { StorageBrowser } = createStorageBrowser({
162162
</ExampleCode>
163163
</Example>
164164

165+
<Message colorTheme="info" variation="filled" heading="Working with existing S3 storage">
166+
Amplify also supports [bringing in existing S3 resources](https://docs.amplify.aws/react/build-a-backend/storage/use-with-custom-s3/) instead of creating a new storage resource. When adding Storage Browser to access these resources, you may need to modify some of the example code listed in the provided documentation.
167+
168+
In the case where you are adding Storage Browser with an [Amplify backend configured with an existing S3 bucket](https://docs.amplify.aws/react/build-a-backend/storage/use-with-custom-s3/#configure-the-s3-bucket), keep in mind that the optional properties `buckets` and `paths` listed in the configuration examples are **required** by Storage Browser to display the bucket correctly.
169+
</Message>
170+
165171
### IAM Identity Center and S3 Access Grants
166172

167173
To use this authorization method, you first have to configure an IAM Identity Center and set up permission grants for your users and groups in S3 Access Grants. Then, you connect your application to Identity Center and configure your application to exchange an identity token from your external Identity Provider with one from Identity Center. Afterwards, you configure your application to provide the Identity Center token to Storage Browser when a user opens the page in your application to access your data in S3. To learn more, visit the [S3 documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-browser.html).

0 commit comments

Comments
 (0)