> 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

Liga o teu Armazenamento de Objetos da Plenit a um cliente S3 em dois passos: recolhe os dados de ligação no painel e configura-os no cliente.

O 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-te ligá-lo a qualquer Cliente S3 (CyberDuck, S3 Browser ou outro) para gerir os teus buckets a partir do teu equipamento. Este guia reúne os dados do painel e configura-os no cliente.

> #### 👍 O que consegues
>
> O teu bucket de Armazenamento de Objetos ligado a um Cliente S3, pronto para carregar, 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.](https://docs.plenit.com/docs-pt/productos/object-storage/quickstart.md)
* Ter instalado um Cliente S3 (por exemplo, CyberDuck ou S3 Browser) no teu equipamento.

### Passo 1. Recolhe 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 necessita de quatro dados:

* **Endpoint (URL de acesso)**: clica em Ligar na subscrição e escolhe o acesso via cliente. A janela mostra a URL do serviço.
* **Path (nome do bucket)**: aparece como Bucket nessa mesma janela.
* **Access Key**: em **Utilizadores → Credenciais**.
* **Secret Key**: na mesma janela de chaves.

![Dados de ligação do bucket no painel](https://1427657614-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://1427657614-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>Credenciais do utilizador no separador Utilizadores</p></figcaption></figure>

> #### 🚧 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 todos pedem o mesmo: a URL do passo 1, as chaves (Access Key e Secret Key) e, consoante o utilizador, o path. Clientes habituais são **CyberDuck** e **S3 Browser**.

![Configuração dos dados no Cliente S3](https://1427657614-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://1427657614-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 visível no Cliente S3 após ligar</p></figcaption></figure>

> #### 📘 Proprietário (OWNER) face aos restantes utilizadores
>
> Há uma diferença-chave consoante com que utilizador te ligues:
>
> * O **proprietário** (OWNER) do bucket acede diretamente ao recurso, sem configurar mais nada: a ligação redireciona-o sozinha.
> * O **restantes utilizadores** não têm acesso direto, pelo que devem preencher o campo **path** com o nome do bucket a que 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 que os restantes 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.](https://docs.plenit.com/docs-pt/productos/object-storage/concepts.md)
* Revê a organização dos teus buckets em [Buckets e objetos](https://docs.plenit.com/docs-pt/productos/object-storage/concepts/buckets-and-objects.md).
* Compreende como funcionam os utilizadores e as chaves em [Acesso S3: utilizadores e credenciais.](https://docs.plenit.com/docs-pt/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/docs-pt/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.
