SETUP GUIDES · FILE STORAGE
Backblaze B2 bucket
Store your app’s files in Backblaze B2.
Backblaze B2 is low-cost storage that speaks the same language as Amazon S3. You create a private bucket and an application key that only works for that bucket.
Words you’ll see
- Bucket
- A storage container for files at a storage provider, like a top-level folder in the cloud. Your app’s uploads go into it.
- Access key ID and secret access key
- A pair of values that works like a username and password for programs. The ID can be shown; the secret is shown once when you create it.
- Endpoint
- The web address Claspine uses to reach your storage provider, such as https://s3.us-east-1.amazonaws.com.
- Region
- The part of the world where the provider runs your service, such as us-east-1 (Virginia) or europe-west4 (Netherlands). Use the region where you set things up.
- CORS
- A browser safety setting on the bucket that says which websites may upload or download directly. Without it, browsers block uploads from your app.
Steps
- In Backblaze, open Buckets → Create a Bucket, keep it Private, and create it.
- Note the bucket’s Endpoint shown in its details (for example
s3.us-west-004.backblazeb2.com). - Open Application Keys → Add a New Application Key. Allow access to this bucket only with Read and Write.
- Copy the keyID and applicationKey. The application key is shown only once.
- Add a CORS rule on the bucket for your app’s web address (bucket settings → CORS Rules).
- Open the Claspine console, choose your project and go to File Storage.
- Pick this provider in the list, then fill in the fields as shown in “What goes where in Claspine” below.
- Click Save & test. Claspine writes one tiny test file into your bucket, reads it back and deletes it. A green result means everything is connected.
What goes where in Claspine
| Console field | Value |
|---|---|
| ENDPOINT | https:// followed by the endpoint from step 2. |
| REGION | The middle part of the endpoint, e.g. us-west-004. |
| ACCESS KEY ID / SECRET | keyID and applicationKey from step 4. |
Keep it safe
- A key limited to one bucket cannot touch your other buckets.
Claspine stores the values encrypted, never shows them again in full, and never sends them to your app or SDK.