> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/byos/connecting-shade-to-backblaze.md).

# Connexion de Shade à Backblaze

Shade prend en charge Bring-Your-Own-S3 (BYOS3) avec plusieurs fournisseurs tels qu’AWS, GCP, MinIO, Wasabi, Backblaze, et plus encore. Voici comment connecter Shade à votre compte Backblaze existant.

### Provisionner un nouveau bucket dans Backblaze

{% hint style="info" %}
Bien que le provisionnement d’un nouveau bucket ne soit pas strictement nécessaire, nous recommandons vivement d’en provisionner un nouveau pour Shade. Shade ne peut pas utiliser des fichiers dans des buckets existants en raison de la nature de ShadeFS. Shade créera deux nouveaux dossiers `blobs` et `chunks` dans n’importe quel bucket auquel vous le connectez.
{% endhint %}

Si vous n’avez pas encore de compte Backblaze, vous pouvez en créer un [ici](https://www.backblaze.com/get-started). Pour créer un nouveau bucket dans Backblaze, connectez-vous à votre compte, rendez-vous dans Buckets, puis cliquez sur « Create Bucket ».

{% hint style="warning" %}
Lors du nommage des buckets, veuillez éviter d’utiliser des préfixes numériques, car cela peut provoquer l’échec des téléversements.
{% endhint %}

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FwiyUqp1EMe9kxmzqUY0s%2FScreenshot%202025-07-21%20at%2010.05.57%E2%80%AFPM.png?alt=media&amp;token=a6a9688c-8ea3-48b0-a0c0-5949c2142adc" alt=""><figcaption></figcaption></figure>

En suivant les étapes et les invites, assurez-vous de noter votre **nom du bucket**, ainsi que votre **région du bucket** (car ils sont importants et seront utilisés à une étape ultérieure). *Dans ce cas, le nom de notre bucket est « shade-new-bucket » et la région (non illustrée) est us-east-005.*

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FrfYsy1OGqFNgpTNZehUj%2FScreenshot%202025-07-21%20at%2010.06.34%E2%80%AFPM.png?alt=media&amp;token=a4e6a64b-f14e-47aa-b22a-69a1ba4ca246" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS ne nécessite aucun autre paramètre spécifique sur le bucket. Vous pouvez choisir de répliquer les données, de journaliser ou de configurer le versioning comme vous le souhaitez pour votre entreprise.
{% endhint %}

### Configuration de CORS (option plus simple, mais qui ne fonctionne pas toujours)

Le Cross-Origin Resource Sharing est une caractéristique importante qui permet aux buckets d’être accessibles depuis d’autres origines (comme <https://app.shade.inc>). C’est essentiel pour que Shade puisse accéder et télécharger les médias originaux pour vous depuis notre application. Backblaze facilite le partage de cette origine. Nous recommandons d’autoriser toutes les origines. Cependant, si vous préférez une origine plus restreinte, il faut ajouter à la liste blanche `*.shade.inc` comme origine autorisée.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FK04PmQnY9OPDkeiPt7cg%2FScreenshot%202025-07-21%20at%2010.07.19%E2%80%AFPM.png?alt=media&amp;token=98cdf9fc-04b7-46a0-a2ea-862615faa11f" alt=""><figcaption></figcaption></figure>

### Méthode infaillible pour mettre à jour CORS

B2 semble parfois rencontrer quelques problèmes lors de la mise à jour de CORS directement depuis l’interface. Pour mettre à jour à coup sûr votre bucket b2, vous pouvez utiliser le [b2 cli](https://www.backblaze.com/docs/cloud-storage-command-line-tools).

#### Créer un cors.json

Tout d’abord, créez un `cors.json` fichier contenant le contenu suivant.

```json
[

  {

    "corsRuleName": "web-any-origin",

    "allowedOrigins": ["*"],

    "allowedHeaders": ["*"],

    "allowedOperations": [

      "b2_download_file_by_id",

      "b2_download_file_by_name",

      "b2_upload_file",

      "b2_upload_part",

      "s3_get",

      "s3_put",

      "s3_delete",

      "s3_head"

    ],

    "maxAgeSeconds": 3000

  }

]
```

Ensuite, ouvrez un terminal sur votre machine et mettez à jour :

```
b2 bucket update --cors-rules "/path/to/cors.json" your-bucket-name-here allPublic
```

Il devrait répondre avec le résultat suivant :

```json
{

    "accountId": "---------",
    "bucketId": "---------",
    "bucketInfo": {},
    "bucketName": "---------",
    "bucketType": "allPublic",
    "corsRules": [
        {
            "allowedHeaders": [
                "*"
            ],
            "allowedOperations": [
                "s3_head",
                "b2_download_file_by_id",
                "b2_upload_part",
                "b2_upload_file",
                "s3_put",
                "b2_download_file_by_name",
                "s3_delete",
                "s3_get"
            ],
            "allowedOrigins": [
                "*"
            ],
            "corsRuleName": "web-any-origin",
            "exposeHeaders": null,
            "maxAgeSeconds": 3000
        }
    ],
    "defaultRetention": {
        "mode": null
    },
    "defaultServerSideEncryption": {
        "mode": "none"
    },
    "isFileLockEnabled": false,
    "lifecycleRules": [],
    "options": [
        "s3"
    ],
    "replication": {
        "asReplicationDestination": null,
        "asReplicationSource": null
    },
    "revision": 5
}
```

### Créer des clés d’accès

Shade accède aux buckets Backblaze via le protocole S3 ; cela signifie que Shade a besoin d’un nom de bucket, d’une région de bucket, d’une clé d’accès et d’une clé secrète pour accéder à ce bucket.

Rendez-vous dans Access Keys > Create Access Key et provisionnez une clé Master ou Application Key. Ici, nous provisionnons une clé d’application spécifiquement pour notre bucket.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FhkdgNx8GCyRFeqHHgTs2%2FScreenshot%202025-07-21%20at%2010.08.44%E2%80%AFPM.png?alt=media&amp;token=26b59ca3-1bd6-4be4-ab52-14241865fa0c" alt=""><figcaption></figcaption></figure>

**Assurez-vous que Read et Write sont activés.**

Une fois que vous avez créé une nouvelle clé, copiez l’ID de clé créé (Access Key pour Shade) et applicationKey (Secret key pour Shade) dans votre presse-papiers et conservez-les pour les étapes suivantes.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjCM2LtFyqhnxN6JRrCgW%2FScreenshot%202025-07-21%20at%2010.08.53%E2%80%AFPM.png?alt=media&amp;token=ed030828-3246-4654-a835-eb04e247abeb" alt=""><figcaption></figcaption></figure>

### Créer un lecteur BYOS dans Shade

En arrivant à ce stade, vous devriez avoir acquis avec succès les éléments suivants :

1. Espace de travail Shade
2. Nom du bucket
3. Région du bucket
4. ID de clé (Access Key)
5. applicationKey (clé secrète)

Si vous n’avez pas encore d’espace de travail, vous pouvez en créer un [ici](https://app.shade.inc).

Dans votre espace de travail Shade, vous pouvez maintenant créer un lecteur. Sélectionnez le bouton plus à côté de « My drives » > lecteur BYOS.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FjqzLgveMAH1u4Jue0PBb%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM.png?alt=media&amp;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### Sélectionnez un modèle

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FPE80uq4lWAvyvhx7ZpEn%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM.png?alt=media&amp;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

Nos modèles vous aident à configurer rapidement Shade avec des métadonnées et des vues supplémentaires qui vous aident à organiser vos fichiers et vos ressources. Pour plus d’informations sur notre IA, vous pouvez consulter notre [academy](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). Dans ce cas, nous avons चयनné Production vidéo.

#### Création de notre lecteur Backblaze

Ensuite, nous choisissons le nom de notre lecteur et sélectionnons notre fournisseur Backblaze.

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FezRZIfHFnkZVjRuVh25l%2FScreenshot%202025-07-21%20at%2010.10.54%E2%80%AFPM.png?alt=media&amp;token=5be8cf69-5647-4b62-a801-425bf4b2d7b6" alt=""><figcaption></figcaption></figure>

#### Ajout de nos identifiants Backblaze

À partir des étapes précédentes, nous ajoutons nos identifiants Backblaze, notamment le nom de notre bucket, la région, la clé d’accès et la clé secrète.

{% hint style="info" %}
Il doit s’agir du nom de bucket que vous avez créé dans Backblaze. Ce n’est pas le même que le nom du lecteur que vous avez créé sur l’écran précédent.
{% endhint %}

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FIlbsTBemKdmX7GejHN7u%2FScreenshot%202025-07-21%20at%2010.12.23%E2%80%AFPM.png?alt=media&amp;token=080e27e4-5b92-4274-b99e-32a2b91b9825" alt=""><figcaption></figcaption></figure>

### Téléchargement de votre premier fichier

Une fois que vous avez suivi les étapes précédentes, vous êtes maintenant en mesure de téléverser votre premier fichier vers votre lecteur Shade. Si la configuration a réussi, vous devriez pouvoir téléverser votre fichier et monter le lecteur Shade sur votre ordinateur depuis l’ [application de bureau Shade](https://shade.inc/download)

<figure><img src="https://2926217644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F7LzkoI92nHxn2cWLxpdi%2FScreenshot%202025-07-21%20at%2010.20.30%E2%80%AFPM.png?alt=media&amp;token=068a3ab2-bf9a-4773-a5cf-3445643b121c" alt=""><figcaption></figcaption></figure>

### Conseils de dépannage

Si vous avez d’autres questions, n’hésitez pas à nous contacter à <support@shade.inc> ou rejoignez notre [Discord](https://discord.gg/h8wqFMJ4vK).

#### Je n’arrive pas à téléverser, que se passe-t-il ?

Si vous n’arrivez pas à téléverser, veuillez vérifier les paramètres CORS de votre bucket ou vos clés secrètes / d’accès ainsi que les autorisations associées.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/byos/connecting-shade-to-backblaze.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
