Object Storage
Cloudbear Object Storage keeps files for your applications in S3-compatible buckets. Your application uses a standard S3 client or SDK.
Typical uses are uploads, media, exports and backups.
Buckets and keys
Each bucket is private. We make a bucket for each application environment, for example one bucket for staging and one bucket for production.
You get an access key and a secret key for each bucket. A key gives access only to the buckets that it is for. We can replace a key when you ask for it.
Connection details
| Setting | Value |
|---|---|
| Endpoint | https://object-storage.cloudbear.nl |
| Region | nl-ams |
| Addressing | Path-style (https://object-storage.cloudbear.nl/<bucket>/<key>) |
| Credentials | The access key and the secret key that we give you |
The IP addresses of this hostname can change at all times. Read IP address allowlists before you add a firewall rule.
Set path-style addressing in your client. Virtual-hosted addressing (<bucket>.object-storage.cloudbear.nl) does not work.
Presigned URLs and multipart uploads work as in other S3 services.
Options
These options are available when you ask for them:
- Versioning: the bucket keeps the earlier versions of a file when you replace or delete it.
- Lifecycle rules: the bucket deletes files automatically after a period that you choose.
SFTP gateway to S3
Some applications and partners can send files only with SFTP. For them, the SFTP gateway gives SFTP access to a bucket. The SFTP user gets a username and a password. The SFTP user does not get an S3 key.
Connection details
| Setting | Value |
|---|---|
| Host | sftp.object-storage.cloudbear.nl |
| Port | 2022 |
| Login | Username and password |
The IP addresses of this hostname can change at all times. Read IP address allowlists before you add a firewall rule.
We send the username and the password through different channels. We also give you the fingerprints of the host keys. Compare them with the fingerprints that your SFTP client shows at the first login.
Access control
- Each SFTP user has a list of IP addresses. A login from a different IP address fails.
- After 10 failed logins in 10 minutes, the gateway blocks the IP address for 15 minutes.
- An SFTP user can have read-only access.
- The gateway gives access only to files. Shell commands and port forwarding are not available.
Folders
An SFTP user sees one of these:
- One bucket as
/. - One folder in a bucket as
/. The SFTP user cannot see the files outside that folder. - More than one bucket. Each bucket is a folder in
/.
Limits
S3 keeps each file as one complete object. Thus, the SFTP gateway has these limits:
- An upload must write the full file from the start. You cannot append to a file or continue an upload that stopped.
- A rename makes a copy of the file and then deletes the original. The rename of a large file takes more time.
- You can rename a folder only when it is empty.
- The maximum file size is approximately 78 GiB.
- A folder can hold a maximum of 100,000 entries.
- The gateway does not keep file permissions or file times. Each file shows the time of its last upload.
- The gateway closes a connection after 30 minutes without activity.
IP address allowlists
Allowlists in your firewall
The IP addresses of object-storage.cloudbear.nl and sftp.object-storage.cloudbear.nl can change at all times. Do not put these IP addresses in an allowlist.
If your firewall needs an allowlist, make the allowlist with the hostnames, not with the IP addresses.
Allowlists on S3 keys and SFTP users
We can limit each S3 key and each SFTP user to a list of IP addresses. A request or a login from a different IP address fails. Tell us the IP addresses when you ask for a key or an SFTP user.
How to get Object Storage
Contact us through your personal Slack channel or by phone (+31 (0)85 743 0370). Tell us these items:
- The application and the environments that need a bucket.
- The options that you need, for example versioning, lifecycle rules or an IP address allowlist.
- For SFTP access: the usernames, the IP addresses and the type of access (read-only, or read and write).