> 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/apportez-votre-propre-stockage/connecting-shade-to-backblaze.md).

# Connexion de Shade à Backblaze

Shade prend en charge le mode Bring-Your-Own-S3 (BYOS3) avec plusieurs fournisseurs tels que AWS, GCP, MinIO, Wasabi, Backblaze, et bien d’autres. Voici comment connecter Shade à votre compte Backblaze existant.

### Provisionnement d’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 les fichiers 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 créer un compte [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 de la nomination des buckets, veuillez éviter d’utiliser des préfixes numériques, car cela peut entraîner l’échec des envois.
{% endhint %}

<figure><img src="/files/d31e033db5765556c0656221a791282a899bad04" alt=""><figcaption></figcaption></figure>

En suivant les étapes et les instructions, assurez-vous de garder une trace de votre **nom du bucket**, et de votre **région du bucket** (car ces informations sont importantes et seront utilisées à 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="/files/e6cf63ff53caa86911ddc6bcf9f60c0a9f6298da" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS n’exige aucune autre propriété spécifique sur le bucket. Vous pouvez choisir de répliquer les données, d’activer les journaux ou de mettre en place le versioning selon vos besoins pour votre entreprise.
{% endhint %}

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

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

<figure><img src="/files/217bfce3cf66a37642bbb0a3528363081a1b2677" alt=""><figcaption></figcaption></figure>

### Option 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 votre bucket b2 de façon infaillible, vous pouvez utiliser le [CLI b2](https://www.backblaze.com/docs/cloud-storage-command-line-tools).

#### Créer un cors.json

Commencez par créer un `cors.json` fichier avec 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

  }

]
```

Ouvrez ensuite un terminal sur votre machine et mettez à jour :&#x20;

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

Il devrait renvoyer un résultat ici :&#x20;

```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éation de 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="/files/4a06f64e444769fd28471143a4af2af77e42ab4f" alt=""><figcaption></figcaption></figure>

**Assurez-vous que les options Read et Write sont activées.**

Une fois la nouvelle clé créée, copiez l’ID de clé créé (Access Key pour Shade) et applicationKey (Secret key for Shade) dans votre presse-papiers et conservez-les pour les prochaines étapes.

<figure><img src="/files/ed0af06a78d5eb67d869076b19f769d2f6fb3566" alt=""><figcaption></figcaption></figure>

### Création d’un lecteur BYOS dans Shade

À ce stade, vous devriez avoir obtenu avec succès les éléments suivants :

1. Espace de travail Shade
2. Nom du bucket
3. Région du bucket
4. KeyID (clé d’accès)
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="/files/2fd6cc9bac58b9da224cccbb852640dc69f0b146" alt=""><figcaption></figcaption></figure>

#### Sélectionnez un modèle

<figure><img src="/files/8e2275de0bbd81c0861ad561a602ae35689543cd" alt=""><figcaption></figcaption></figure>

Nos modèles vous aident à démarrer rapidement avec Shade grâce à des métadonnées et des vues supplémentaires qui vous aident à organiser vos fichiers et vos actifs. Pour en savoir plus sur notre IA, vous pouvez consulter notre [académie](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). Dans ce cas, nous avons sélectionné Production vidéo.

#### Création de notre drive Backblaze

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

<figure><img src="/files/c3c810931b2a6385fa7cbc074adb7573f6238942" alt=""><figcaption></figcaption></figure>

#### Ajout de nos identifiants Backblaze

À partir des étapes précédentes, nous ajoutons nos identifiants Backblaze, y compris le nom du 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 drive que vous avez créé à l’écran précédent.
{% endhint %}

<figure><img src="/files/fa3f1e317efcccc978508ec265fcbbe8f1a0939b" alt=""><figcaption></figcaption></figure>

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

Une fois les étapes précédentes suivies, vous êtes maintenant en mesure de téléverser votre premier fichier sur 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="/files/4cd3f9bcf5342473319654745a69c473ef0fdc28" alt=""><figcaption></figcaption></figure>

### Conseils de dépannage

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

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

Si vous ne parvenez 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/apportez-votre-propre-stockage/connecting-shade-to-backblaze.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.