# Conectar Shade a Backblaze

Shade admite Bring-Your-Own-S3 (BYOS3) con múltiples proveedores como AWS, GCP, MinIO, Wasabi, Backblaze y más. Aquí se explica cómo conectar Shade con tu cuenta existente de Backblaze.

### Aprovisionando 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 que conectes.
{% endhint %}

Si aún no tienes una cuenta de Backblaze, puedes crear una cuenta [aquí](https://www.backblaze.com/get-started). Para crear un nuevo bucket en Backblaze, inicia sesión en tu cuenta, ve a Buckets y “Create Bucket”.

<figure><img src="https://440362858-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&#x26;token=a6a9688c-8ea3-48b0-a0c0-5949c2142adc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://440362858-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&#x26;token=a4e6a64b-f14e-47aa-b22a-69a1ba4ca246" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
ShadeFS no requiere que se establezcan otras propiedades específicas en el bucket. Puedes optar por replicar datos, registrar o configurar versionado según prefiera tu empresa.
{% endhint %}

### Configurando CORS (Opción más fácil pero que no siempre funciona)

El intercambio de recursos de origen cruzado (CORS) es una característica importante que permite que los buckets sean accesibles desde otros orígenes (como <https://app.shade.inc>). Esto es crítico para que Shade acceda y descargue los medios originales para ti desde nuestra aplicación. Backblaze facilita compartir este origen. Recomendamos permitir todos los orígenes. Sin embargo, si prefieres un origen más restringido, es necesario poner en la lista blanca `*.shade.inc` como un origen permitido.

<figure><img src="https://440362858-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&#x26;token=98cdf9fc-04b7-46a0-a2ea-862615faa11f" alt=""><figcaption></figcaption></figure>

### Opción segura de actualización de CORS

B2 parece tener algunos problemas a veces para actualizar CORS directamente desde la interfaz. Para actualizar con certeza tu bucket b2, puedes usar el [b2 cli](https://www.backblaze.com/docs/cloud-storage-command-line-tools).

#### Crear un cors.json

Primero, crea 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 abre una terminal en tu máquina y actualiza:&#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
}
```

### Creando 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.

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

<figure><img src="https://440362858-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&#x26;token=26b59ca3-1bd6-4be4-ab52-14241865fa0c" alt=""><figcaption></figcaption></figure>

**Asegúrate de tener habilitado Leer y Escribir.**

Una vez que crees una nueva clave, copia el ID de la clave creada (Access Key para Shade) y applicationKey (clave secreta para Shade) al portapapeles y guárdalos para los siguientes pasos.

<figure><img src="https://440362858-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&#x26;token=ed030828-3246-4654-a835-eb04e247abeb" alt=""><figcaption></figcaption></figure>

### Creando una unidad BYOS en Shade

Al llegar a este punto, deberías haber adquirido con éxito los siguientes elementos:

1. Workspace de Shade
2. Nombre del bucket
3. Región del bucket
4. KeyID (Access Key)
5. applicationKey (Clave secreta)

Si no tienes un workspace aún, puedes crear uno [aquí](https://app.shade.inc).

Dentro de tu workspace de Shade, ahora puedes crear una unidad. Selecciona el botón más junto a “My drives” > BYOS drive.

<figure><img src="https://440362858-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&#x26;token=f29ba862-4ea3-454a-9b60-6a14622fa1e5" alt=""><figcaption></figcaption></figure>

#### Selecciona una plantilla

<figure><img src="https://440362858-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&#x26;token=72b36257-7e12-4c7e-95b5-7d8e29632adc" alt=""><figcaption></figcaption></figure>

Nuestras plantillas te ayudan a configurarte rápidamente con Shade con metadatos y vistas adicionales que te ayudan a organizar tus archivos y activos. Para más información sobre nuestra IA puedes consultar nuestra [academia](https://academy.shade.inc/ai-tools/custom-and-automated-metadata). En este caso, hemos seleccionado Producción de Video.

#### Creando nuestra unidad de Backblaze

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

<figure><img src="https://440362858-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&#x26;token=5be8cf69-5647-4b62-a801-425bf4b2d7b6" alt=""><figcaption></figcaption></figure>

#### Agregando nuestras credenciales de Backblaze

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

{% hint style="info" %}
Esto tiene que ser el nombre del bucket que creaste en Backblaze. Esto no es lo mismo que el nombre de la unidad que creaste en la pantalla anterior.
{% endhint %}

<figure><img src="https://440362858-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&#x26;token=080e27e4-5b92-4274-b99e-32a2b91b9825" alt=""><figcaption></figcaption></figure>

### Subiendo tu primer archivo

Una vez que hayas seguido los pasos anteriores, ahora puedes subir tu primer archivo a tu unidad Shade. Si se configuró correctamente, deberías poder subir tu archivo y montar la unidad Shade en tu ordenador desde la [Aplicación de escritorio Shade](https://shade.inc/download)

<figure><img src="https://440362858-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&#x26;token=068a3ab2-bf9a-4773-a5cf-3445643b121c" alt=""><figcaption></figcaption></figure>

### Consejos para la resolución de problemas

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

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

Si no puedes subir, por favor verifica la configuración de CORS en tu bucket o tus claves secretas / de acceso y los permisos asociados.