Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve S3 documentation for share links #457

Merged
merged 2 commits into from
Dec 3, 2023
Merged

Improve S3 documentation for share links #457

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
12d6959
Improve S3 documentation for share links
Cassie205 Nov 29, 2023
1acfe73
Correction
Cassie205 Dec 1, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion cyberduck/share.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Providers with support to share a file using a public, password protected or tem

### S3

For connections using [S3](../protocols/s3/index.md) protocol.
For connections using [S3](../protocols/s3/index.md) protocol, make sure the bucket allows [ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html?icmpid=docs_amazons3_console) and doesn't block [public access](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html?icmpid=docs_amazons3_console).

`````{tabs}
````{group-tab} Cyberduck
Expand Down
10 changes: 9 additions & 1 deletion protocols/s3/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -539,7 +539,7 @@ You can access all URLs (including from [CDN](../../protocols/cdn/cloudfront.md)
```{important}
Public URLs are only accessible if the permission `READ` is granted for `EVERYONE`.
```

Choose *File → Share…* to change the ACL on the file permanently allowing read for everyone. You can reset the changed ACL in [Info → ACL](../../cyberduck/info.md#access-control-list-acl).

### Pre-signed Temporary URLs
Expand All @@ -560,6 +560,14 @@ Using the AWS4 signature version used in Cyberduck version 5.0 and later, pre-si
This deprecated signature version is not compatible with new regions such as `eu-central-1`.
```

### Limitations

Share links cannot be created when failing to update the ACLs on a file because

* Bucket has "Object Ownership" set to "Bucket owner enforced" ([ACLs disabled](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html?icmpid=docs_amazons3_console)).
Error message: `This bucket does not allow ACLs`
* ["Block public acccess"](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html?icmpid=docs_amazons3_console) is enabled on bucket. Error message: `Access denied`

## Metadata

You can edit standard HTTP headers and add [custom HTTP headers](../../cyberduck/info.md#metadata-http-headers) to files to store [metadata](http://docs.amazonwebservices.com/AmazonS3/latest/index.html?UsingMetadata.html). Choose *File → Info (macOS `⌘I` Windows `Alt+Return`) → Metadata* to edit headers.
Expand Down
Loading