> 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/docs-pt/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.md).

# Como integrar o Armazenamento de Objetos com um Cliente S3

Armazenamento de Objetos foi pensado para guardar grandes volumes de dados de aplicações (arquivamento, cópia de segurança, IoT, DevOps) através de uma API compatível com S3.

Isso permite ligá-lo a qualquer cliente S3 (CyberDuck, S3 Browser ou outro) para gerir os teus buckets a partir do teu computador. Este guia reúne os dados do painel e configura-os no cliente.

> #### 👍 O que obténs
>
> O teu bucket de Armazenamento de Objetos ligado a um cliente S3, pronto para enviar, descarregar e gerir objetos a partir da aplicação.

### Antes de começar

* Aceder ao Painel de administração em [admin.plenit.com](https://admin.plenit.com) com Permissões sobre o serviço.
* Ter uma Subscrição de **Armazenamento de Objetos**. Se ainda não a tens, monta-a com o [Início Rápido de Armazenamento de Objetos.](/docs-pt/productos/object-storage/quickstart.md)
* Ter instalado um cliente S3 (por exemplo, CyberDuck ou S3 Browser) no teu computador.

### Passo 1. Reúne os dados de ligação no painel

Em [admin.plenit.com](https://admin.plenit.com), vai para **Cloud Services → Armazenamento de Objetos** e entra na subscrição. Uma integração por API precisa de quatro dados:

* **Endpoint (URL de acesso)**: `s3.plenit.com`.
* **Path (nome do bucket)**: no separador **Bucket**, campo **My bucket**.
* **Access Key**: em **Utilizadores → utilizador → menu (…) → Chaves**.
* **Secret Key**: na mesma janela de chaves.

{/\* 📸 CAPTURA 1 · Resumo/Bucket (nome e endpoint) e Utilizadores › Chaves (Access/Secret) \*/}

![Dados de ligação do bucket no painel](https://REEMPLAZA-URL/almacenamiento-objetos-cliente-s3-01.png)

> #### 🚧 Guarda bem a Secret Key
>
> A Secret Key é sensível: trata-a como uma palavra-passe e não a partilhes. 
>
> Juntamente com a Access Key, é o que autentica o acesso do teu cliente S3 ao bucket.

### Passo 2. Configura o cliente S3

Introduz esses dados no teu cliente S3. A forma exata varia consoante a aplicação, mas todas pedem o mesmo: o endpoint (`s3.plenit.com`), as chaves (Access Key e Secret Key) e, consoante o utilizador, o path. Clientes habituais são **CyberDuck** e **S3 Browser**.

{/\* 📸 CAPTURA 2 · exemplo de configuração num cliente S3 (endpoint, chaves, path) \*/}

![Configuração dos dados no cliente S3](https://REEMPLAZA-URL/almacenamiento-objetos-cliente-s3-02.png)

> #### 📘 Proprietário (OWNER) versus o resto dos utilizadores
>
> Há uma diferença-chave consoante o utilizador com que te ligas:
>
> * O **proprietário** (OWNER) do bucket acede diretamente ao recurso, sem configurar mais nada: a ligação redireciona-o sozinha.
> * O **resto dos utilizadores** não têm acesso direto, por isso devem preencher o campo **path** com o nome do bucket ao qual querem aceder.
>
> Se um utilizador que não é o proprietário não vê o conteúdo, quase sempre é porque lhe falta indicar o path.

### Conclusão

Integrar com um cliente S3 resume-se a recolher quatro dados do painel — endpoint, path, Access Key e Secret Key — e introduzi-los na aplicação.

A única nuance que convém recordar é a do proprietário: o OWNER entra diretamente, enquanto os demais utilizadores têm de indicar o path do bucket.

Com isso, geres o teu Armazenamento de Objetos a partir do cliente S3 que preferires, tal como qualquer armazenamento compatível com o protocolo.

### Passos seguintes

* Revê os conceitos do serviço e dos buckets em [Conceitos de Armazenamento de Objetos.](/docs-pt/productos/object-storage/concepts.md)
* Revê a organização dos teus buckets em [Estrutura e buckets.](/docs-pt/productos/file-storage/concepts/folder-structure.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/docs-pt/productos/object-storage/how-to/how-to-integrate-with-an-s3-client.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.