> 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/details/credentials-and-s3-access.md).

# Credenciales y acceso S3

Para conectar cualquier software por S3 necesitas cuatro datos.

El concepto está en[ Acceso S3: usuarios y credenciales](/productos/object-storage/concepts/s3-access-users-and-credentials.md); aquí tienes los datos y los comandos.

### Datos de conexión

| Dato                            | Qué es                                    | Dónde lo obtienes                                    |
| ------------------------------- | ----------------------------------------- | ---------------------------------------------------- |
| Endpoint                        | La URL de acceso al repositorio           | En el resumen del repositorio, abajo a la izquierda  |
| Nombre del repositorio (bucket) | El nombre del bucket, que actúa de *path* | En el resumen del repositorio, arriba a la izquierda |
| Clave de acceso                 | El identificador público de la credencial | En **usuarios › (…) › Claves**                       |
| Clave secreta                   | La parte privada de la credencial         | En **usuarios › (…) › Claves**                       |

> #### 📘 Propietario y resto de usuarios
>
> El usuario propietario del repositorio accede de forma directa, sin indicar el repositorio. 
>
> El resto de usuarios deben indicar el **nombre del repositorio** (el *path*) al configurar el acceso, porque no se les redirige solos.

### AWS CLI

```shell
# Guarda las credenciales en un perfil
aws configure
# AWS Access Key ID:     <CLAVE_DE_ACCESO>
# AWS Secret Access Key: <CLAVE_SECRETA>

# Lista el contenido del repositorio
aws s3 ls s3://NOMBRE-REPOSITORIO --endpoint-url https://ENDPOINT

# Sube un objeto
aws s3 cp ./backup.tar.gz s3://NOMBRE-REPOSITORIO/ --endpoint-url https://ENDPOINT

# Descarga un objeto
aws s3 cp s3://NOMBRE-REPOSITORIO/backup.tar.gz ./ --endpoint-url https://ENDPOINT
```

### s3cmd

```shell
# Configuración guiada: introduce las claves y, como Host, tu endpoint
s3cmd --configure

# Operaciones habituales
s3cmd ls s3://NOMBRE-REPOSITORIO
s3cmd put backup.tar.gz s3://NOMBRE-REPOSITORIO/
s3cmd sync ./carpeta/ s3://NOMBRE-REPOSITORIO/carpeta/
```

### rclone

```shell
# Crea un remoto de tipo "s3" (proveedor: Other) con tu endpoint y claves
rclone config

# Operaciones habituales (remoto llamado "plenit" en este ejemplo)
rclone ls plenit:NOMBRE-REPOSITORIO
rclone copy ./backup.tar.gz plenit:NOMBRE-REPOSITORIO/
rclone sync ./carpeta plenit:NOMBRE-REPOSITORIO/carpeta

```

> #### 🚧 Cuida la clave secreta
>
> La clave secreta da acceso al repositorio. No la dejes en el historial del shell ni en scripts en claro: usa perfiles de credenciales o variables de entorno, y rótala desde **usuarios › (…) › Claves** si sospechas que se ha expuesto. Una credencial distinta por cliente o por servicio te facilita revocar sin afectar al resto.

### URLs firmadas

Para entregar un objeto puntual sin dar credenciales, generas un enlace temporal de descarga.

| Aspecto  | Detalle                                                    |
| -------- | ---------------------------------------------------------- |
| Qué es   | Un enlace temporal de descarga de un objeto                |
| Para qué | Compartir un objeto concreto sin dar acceso al repositorio |
| Validez  | Caduca pasado el tiempo que defines                        |

### Dónde seguir

* Qué software puedes conectar: [Clientes compatibles.](/productos/object-storage/details/compatible-clients.md)
* Quién accede y con qué permisos: [Usuarios y permisos.](/productos/object-storage/details/users-and-permissions.md)
* El concepto de usuarios y credenciales: [Acceso S3: usuarios y credenciales.](/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 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://docs.plenit.com/productos/object-storage/details/credentials-and-s3-access.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.