> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.md).

# Cómo Integrar el Almacenamiento de Objetos Con un Cliente S3

Conecta tu Almacenamiento de Objetos de Plenit a un cliente S3 en dos pasos: recopila los datos de conexión en el panel y configúralos en el cliente.

Almacenamiento de Objetos está pensado para guardar grandes volúmenes de datos de aplicaciones (archivado, backup, IoT, DevOps) a través de una API compatible con S3.

Eso te permite conectarlo con cualquier cliente S3 (CyberDuck, S3 Browser u otro) para gestionar tus buckets desde tu equipo. Esta guía recopila los datos del panel y los configura en el cliente.

> #### 👍 Qué consigues
>
> Tu bucket de Almacenamiento de Objetos conectado a un cliente S3, listo para subir, descargar y gestionar objetos desde la aplicación.

### Antes de empezar

* Acceder al panel de administración en [admin.plenit.com](https://admin.plenit.com) con permisos sobre el servicio.
* Tener una suscripción de **Almacenamiento de Objetos**. Si aún no la tienes, móntala con el [Inicio Rápido de Almacenamiento de Objetos.](https://docs.plenit.com/productos/object-storage/quickstart.md)
* Tener instalado un cliente S3 (por ejemplo, CyberDuck o S3 Browser) en tu equipo.

### Paso 1. Recopila los datos de conexión en el panel

En [admin.plenit.com](https://admin.plenit.com), ve a **Cloud Services → Almacenamiento de Objetos** y entra en la suscripción. Una integración por API necesita cuatro datos:

* **Endpoint (URL de acceso)**: pulsa Conectar en la suscripción y elige el acceso vía cliente. La ventana muestra la URL del servicio.
* **Path (nombre del bucket)**: aparece como Bucket en esa misma ventana.
* **Access Key**: en **Users → Credentials**.
* **Secret Key**: en la misma ventana de claves.

![Datos de conexión del bucket en el panel](https://70579932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2F6xK4beTqjepAkaqCOqhp%2Falmacenamiento-objetos-cliente-s3-01.png?alt=media\&token=c9af9480-e332-4afa-9bf7-2ba771eff7c5)

<figure><img src="https://70579932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FX1o0xqywN2bblFXnr1lH%2Falmacenamiento-objetos-cliente-s3-02.png?alt=media&amp;token=2c32a764-ca91-4057-9e0d-12a75adc8a5c" alt="Pestaña Users con la ventana Credentials (Access key y Secret key)"><figcaption><p>Credenciales del usuario en la pestaña Users</p></figcaption></figure>

> #### 🚧 Guarda bien la Secret Key
>
> La Secret Key es sensible: trátala como una contraseña y no la compartas.
>
> Junto con la Access Key, es lo que autentica el acceso de tu cliente S3 al bucket.

### Paso 2. Configura el cliente S3

Introduce esos datos en tu cliente S3. La forma exacta varía según la aplicación, pero todos piden lo mismo: la URL del paso 1, las claves (Access Key y Secret Key) y, según el usuario, el path. Clientes habituales son **CyberDuck** y **S3 Browser**.

![Configuración de los datos en el cliente S3](https://70579932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2F93gYCgEptPppbmXU4Yfr%2Falmacenamiento-objetos-cliente-s3-03.png?alt=media\&token=7c13374b-9c0a-4f14-9e2c-53f32321ecd0)

<figure><img src="https://70579932-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FQAUHkMrRArp7uyB5waC5%2Falmacenamiento-objetos-cliente-s3-04.png?alt=media&amp;token=a871f316-f752-44d8-8dd8-fb672f5b7710" alt="Cliente S3 conectado mostrando el bucket"><figcaption><p>Bucket visible en el cliente S3 tras conectar</p></figcaption></figure>

> #### 📘 Propietario (OWNER) frente al resto de usuarios
>
> Hay una diferencia clave según con qué usuario conectes:
>
> * El **propietario** (OWNER) del bucket accede directamente al recurso, sin configurar nada más: la conexión le redirige sola.
> * El **resto de usuarios** no tienen acceso directo, así que deben rellenar el campo **path** con el nombre del bucket al que quieren acceder.
>
> Si un usuario que no es el propietario no ve el contenido, casi siempre es porque le falta indicar el path.

### Conclusión

Integrar con un cliente S3 se reduce a recopilar cuatro datos del panel — endpoint, path, Access Key y Secret Key — e introducirlos en la aplicación.

El único matiz que conviene recordar es el del propietario: el OWNER entra directo, mientras que los demás usuarios tienen que indicar el path del bucket.

Con eso, gestionas tu Almacenamiento de Objetos desde el cliente S3 que prefieras, igual que cualquier almacenamiento compatible con el protocolo.

### Siguientes pasos

* Repasa los conceptos del servicio y de los buckets en [Conceptos de Almacenamiento de Objetos.](https://docs.plenit.com/productos/object-storage/concepts.md)
* Revisa la organización de tus buckets en [Buckets y objetos](https://docs.plenit.com/productos/object-storage/concepts/buckets-and-objects.md).
* Entiende cómo funcionan los usuarios y las claves en [Acceso S3: usuarios y credenciales.](https://docs.plenit.com/productos/object-storage/concepts/s3-access-users-and-credentials.md)


---

# 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://docs.plenit.com/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.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.
