# Conectar Shade con Backblaze

Shade admite Bring-Your-Own-S3 (BYOS3) con múltiples proveedores como AWS, GCP, MinIO, Wasabi, Backblaze y más. Así es como conectar Shade con su cuenta existente de Backblaze.

### Aprovisionamiento de un nuevo bucket en Backblaze

{% hint style="info" %}
Aunque aprovisionar un nuevo bucket no es estrictamente necesario, recomendamos encarecidamente aprovisionar un nuevo bucket para Shade. Shade no puede usar archivos en buckets existentes debido a la naturaleza de ShadeFS. Shade creará dos nuevas carpetas `blobs` y `chunks` en cualquier bucket al que lo conecte.
{% endhint %}

Si aún no tiene una cuenta de Backblaze, puede crear una cuenta [aquí](https://www.backblaze.com/get-started). Para crear un nuevo bucket en Backblaze, inicie sesión en su cuenta, vaya a Buckets y seleccione “Create Bucket”.

{% hint style="warning" %}
Al nombrar buckets, evite usar prefijos numéricos, ya que esto puede hacer que las cargas fallen.
{% endhint %}

<figure><img src="/files/9a7d5daebf54e458a50b8c2e0909e86bad4b0e73" alt=""><figcaption></figcaption></figure>

Siguiendo los pasos y las indicaciones, asegúrese de tener a mano el **nombre del bucket**y la **región del bucket** (ya que son importantes y se usarán en un paso posterior). *En este caso, el nombre de nuestro bucket es “shade-new-bucket” y la región (no mostrada) es us-east-005.*

<figure><img src="/files/9003c4fb744e191b45ca148905695139228eaced" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS no requiere que se establezca ninguna otra propiedad específica en el bucket. Puede optar por replicar datos, registrar o configurar el versionado según prefiera para su negocio.
{% endhint %}

### Configuración de CORS (Opción más fácil, pero no siempre funciona)

Cross-Origin Resource Sharing es una característica importante que permite que los buckets sean accesibles desde otros orígenes (como <https://app.shade.inc>). Esto es fundamental para que Shade acceda y descargue contenido multimedia original para usted desde nuestra app. Backblaze facilita compartir este origen. Recomendamos permitir todos los orígenes. Sin embargo, si prefiere un origen más restringido, es necesario incluir en la lista blanca `*.shade.inc` como un origen permitido.

<figure><img src="/files/522f95bb1b456b0368d4ca12906ee7661741aa84" alt=""><figcaption></figcaption></figure>

### Opción segura para actualizar CORS

B2 parece tener algunos problemas a veces al actualizar CORS directamente desde la interfaz. Para actualizar de forma segura su bucket b2, puede usar el [b2 cli](https://www.backblaze.com/docs/cloud-storage-command-line-tools).

#### Crear un cors.json

Primero, cree un `cors.json` archivo con el siguiente contenido.

```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

  }

]
```

Luego abra una terminal en su equipo y actualice:&#x20;

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

Debería responder con un resultado como este:&#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
}
```

### Creación de claves de acceso

Shade accede a los buckets de Backblaze mediante el protocolo S3; esto significa que Shade requiere un nombre de bucket, una región del bucket, una clave de acceso y una clave secreta para poder acceder a este bucket.

Vaya a Access Keys > Create Access Key y aprovisione una Master Key o una Application Key. Aquí, aprovisionamos una clave de aplicación específicamente para nuestro bucket.

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

**Asegúrese de tener habilitado Read y Write.**

Una vez que cree una nueva clave, copie el ID de clave creado (Access Key para Shade) y applicationKey (clave secreta para Shade) en su portapapeles y guárdelo para los siguientes pasos.

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

### Creación de una unidad BYOS en Shade

Al llegar a este punto, debería haber obtenido correctamente los siguientes elementos:

1. Espacio de trabajo de Shade
2. Nombre del bucket
3. Región del bucket
4. KeyID (Access Key)
5. applicationKey (Secret Key)

Si aún no tiene un espacio de trabajo, puede crear uno [aquí](https://app.shade.inc).

Dentro de su espacio de trabajo de Shade, ahora puede crear una unidad. Seleccione el botón de más junto a “My drives” > unidad BYOS.

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

#### Seleccionar una plantilla

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

Nuestras plantillas le ayudan a empezar rápidamente con Shade, con metadatos y vistas adicionales que le ayudan a organizar sus archivos y recursos. Para obtener más información sobre nuestra IA, puede visitar nuestra [academia](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). En este caso, hemos seleccionado Producción de video.

#### Creación de nuestra unidad Backblaze

A continuación, decidimos el nombre de nuestra unidad y seleccionamos nuestro proveedor Backblaze.

<figure><img src="/files/4604f183a87fb653a726d254682665b8b5b86dd7" alt=""><figcaption></figcaption></figure>

#### Añadir nuestras credenciales de Backblaze

A partir de los pasos anteriores, añadimos nuestras credenciales de Backblaze, incluido el nombre del bucket, la región, la clave de acceso y la clave secreta.

{% hint style="info" %}
Este debe ser el nombre del bucket que creó en Backblaze. No es el mismo que el nombre de la unidad que creó en la pantalla anterior.
{% endhint %}

<figure><img src="/files/94aa848ea248b3894d9a630c301ddbeff580f378" alt=""><figcaption></figcaption></figure>

### Subiendo su primer archivo

Una vez que haya seguido los pasos anteriores, ya podrá subir su primer archivo a su unidad de Shade. Si se configuró correctamente, debería poder subir su archivo y montar la unidad de Shade en su computadora desde la [Aplicación de escritorio de Shade](https://shade.inc/download)

<figure><img src="/files/9a5e55d0b9994fc2e85bd7633b7fc8e19094814b" alt=""><figcaption></figcaption></figure>

### Consejos para la solución de problemas

Si tiene más preguntas, no dude en contactarnos en <support@shade.inc> o unirse a nuestro [discord](https://discord.gg/h8wqFMJ4vK).

#### No puedo subir, ¿qué está pasando?

Si no puede subir, revise la configuración de CORS en su bucket o sus claves secreta / de acceso y los permisos asociados.


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.