# Conectar Shade a Wasabi

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 tu cuenta existente de Wasabi.

### Provisionamiento de un nuevo bucket en Wasabi

{% hint style="info" %}
Aunque provisionar un nuevo bucket no es estrictamente necesario, recomendamos encarecidamente provisionar 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 conectes.
{% endhint %}

Si aún no tienes una cuenta de Wasabi, puedes crear una cuenta [aquí](https://console.wasabisys.com). Para crear un nuevo bucket en Wasabi, inicia sesión en tu cuenta, ve a Buckets y haz clic en “Create Bucket”.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FGby1mYxLsZf9KGOzceCb%2FScreenshot%202025-07-21%20at%209.42.04%E2%80%AFPM.png?alt=media&#x26;token=2ea4c448-f288-44eb-a582-f929313f6cde" alt=""><figcaption></figcaption></figure>

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

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

#### Nota especial sobre CORS

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 medios originales para ti desde nuestra app. Por [defecto](https://docs.wasabi.com/apidocs/operations-on-buckets#bucket-crossorigin-resource-sharing-cors-support), Wasabi tiene CORS configurado correctamente para permitir todos los orígenes. Sin embargo, si has cambiado o restringido tu origen, es necesario incluir en la lista blanca `*.shade.inc` como un origen permitido.

Puedes actualizar la configuración en el panel y aquí tienes el JSON adecuado:&#x20;

```
[
  {
    "AllowedHeaders": [
      "*"
    ],
    "AllowedMethods": [
      "GET",
      "PUT",
      "POST",
      "DELETE",
      "HEAD"
    ],
    "AllowedOrigins": [
      "*"
    ],
    "MaxAgeSeconds": 3000
  }
]
```

### Creación de claves de acceso

Shade accede a los buckets de Wasabi 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 clave de Root o de Sub-User que tenga acceso a tu bucket recién provisionado.

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F7iyAtxn3btAvZdeL4akq%2FScreenshot%202025-07-21%20at%209.42.54%E2%80%AFPM.png?alt=media&#x26;token=2c31fa4e-f2ee-477d-b4f3-e464b33409fb" alt=""><figcaption></figcaption></figure>

Asegúrate de haber descargado y copiado las claves al portapapeles

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

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

1. Espacio de trabajo de Shade
2. Nombre del bucket
3. Región del bucket
4. Clave de acceso
5. Clave secreta

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

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

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2F5GrmVTIvNOwwlLXFE5B0%2FScreenshot%202025-07-21%20at%209.43.17%E2%80%AFPM%20(1).png?alt=media&#x26;token=47145a06-8184-476d-85df-d032b2a06084" 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%2FUS2JrtZacwGYeBTn7nCN%2FScreenshot%202025-07-21%20at%209.43.25%E2%80%AFPM%20(1).png?alt=media&#x26;token=b94e13c1-33cd-4e62-ac1b-ae7a47c9daf7" 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 recursos. 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 Wasabi

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

<figure><img src="https://440362858-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2FG4IELRlQGdywO97eQ7SS%2FScreenshot%202025-07-21%20at%209.43.34%E2%80%AFPM.png?alt=media&#x26;token=6bdbe5bc-af88-4bd2-81c1-9b3ad362415a" alt=""><figcaption></figcaption></figure>

#### Añadiendo nuestras credenciales de Wasabi

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

{% hint style="info" %}
Tiene que ser el nombre del bucket que creaste en Wasabi. 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%2FaYZgOmWk6xhdFkGjAk4z%2FScreenshot%202025-07-21%20at%209.44.02%E2%80%AFPM.png?alt=media&#x26;token=33a14d3c-569a-4ab8-994c-a10a847c9bd8" alt=""><figcaption></figcaption></figure>

### Subiendo tu primer archivo

Una vez que hayas seguido los pasos anteriores, ya podrás subir tu primer archivo a tu unidad de Shade. Si se configuró correctamente, deberías poder subir tu archivo y montar la unidad de Shade en tu ordenador desde la [Aplicación de escritorio de 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%2F64bJhaCemet6iLpQFXWz%2FScreenshot%202025-07-21%20at%209.45.00%E2%80%AFPM.png?alt=media&#x26;token=32cda603-88ed-4cb6-a0e9-4124c8734011" alt=""><figcaption></figcaption></figure>

### Consejos para solucionar problemas

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

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

Si no puedes subir, revisa la configuración de CORS de tu bucket o tus claves secreta/de acceso y los permisos asociados.
