Skip to content

Commit

Permalink
Merge branch 'no-issue-add-warning-edge-storage'
Browse files Browse the repository at this point in the history
  • Loading branch information
robsongajunior committed Dec 5, 2024
2 parents fc82eef + fa559ff commit 5531270
Show file tree
Hide file tree
Showing 10 changed files with 36 additions and 6 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,10 @@ You should receive the following response:
}
```

:::caution[Warning]
When a bucket is configured with **read-write permissions**, any user can access and modify its content (for example, by using a PUT request to overwrite files). Verify the required permissions for each use case and enforce proper access controls in order to avoid risks.
:::

---

## Removing bucket
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -201,6 +201,10 @@ In addition to the required authentication and necessary permissions, some API o
- **Read-write**: objects in the bucket can be modified.
- **Restricted**: objects in the bucket can be modified and read but can't be accessed by the Azion Edge Platform. Buckets can't be modified using Azion Runtime and can't be used as an origin for edge applications.

:::caution[Warning]
When a bucket is configured with **read-write permissions**, any user can access and modify its content (for example, by using a PUT request to overwrite files). Verify the required permissions for each use case and enforce proper access controls in order to avoid risks.
:::

### S3 credentials

**Edge Storage** offers compatibility with the S3 protocol through credentials.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -129,3 +129,7 @@ You should receive the following response:
</Tabs>

Now, you have successfully created a bucket and attributed read-write permissions to it. You can start storing and retrieving objects from this bucket.

:::caution[Warning]
When a bucket is configured with **read-write permissions**, any user can access and modify its content (for example, by using a PUT request to overwrite files). Verify the required permissions for each use case and enforce proper access controls in order to avoid risks.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -75,3 +75,6 @@ The bucket's name cannot be updated.

</Tabs>

:::caution[Warning]
When a bucket is configured with **read-write permissions**, any user can access and modify its content (for example, by using a PUT request to overwrite files). Verify the required permissions for each use case and enforce proper access controls in order to avoid risks.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ h1, p {
}
```

3. Run the following `POST` request in your terminal, replacing `[TOKEN VALUE]` with your [personal token](/en/documentation/products/guides/personal-tokens/) and writing the desired bucket name in `name` to create a read-write bucket:
3. Run the following `POST` request in your terminal, replacing `[TOKEN VALUE]` with your [personal token](/en/documentation/products/guides/personal-tokens/) and writing the desired bucket name in `name` to create a read-only bucket:

```bash
curl --location 'https://api.azion.com/v4/storage/buckets' \
Expand All @@ -68,7 +68,7 @@ curl --location 'https://api.azion.com/v4/storage/buckets' \
--header 'Authorization: Token [TOKEN VALUE]' \
--data '{
"name": "app-origin",
"edge_access": "read_write"
"edge_access": "read_only"
}'
```

Expand All @@ -79,7 +79,7 @@ curl --location 'https://api.azion.com/v4/storage/buckets' \
"state": "executed",
"data": {
"name": "app-origin",
"edge_access": "read_write"
"edge_access": "read_only"
}
}
```
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,10 @@ Você deverá receber a seguinte resposta:
}
```

:::caution[Atenção]
Quando um bucket está configurado com **permissões de leitura e escrita (read-write)**, qualquer usuário pode acessar e modificar seu conteúdo (por exemplo, usando uma requisição PUT para sobrescrever arquivos). Verifique as permissões necessárias para cada caso de uso e implemente controles de acesso adequados para evitar riscos.
:::

---

## Remova um bucket
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,10 @@ Além da autenticação e permissões necessárias, algumas operações são res
- **Read-write**: objetos no bucket podem ser modificados.
- **Restricted**: objetos no bucket podem ser modificados e lidos, mas não podem ser acessados pela Plataforma de Edge da Azion. Isso significa que os buckets não podem ser modificados usando Azion Runtime e não pode ser usado como origem para edge applications.

:::caution[Atenção]
Quando um bucket está configurado com **permissões de leitura e escrita (read-write)**, qualquer usuário pode acessar e modificar seu conteúdo (por exemplo, usando uma requisição PUT para sobrescrever arquivos). Verifique as permissões necessárias para cada caso de uso e implemente controles de acesso adequados para evitar riscos.
:::

### Credenciais S3

**Edge Storage** oferece compatibilidade com o protocolo S3 por meio de credenciais.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -73,3 +73,6 @@ O nome do bucket não pode ser modificado.

</Tabs>

:::caution[Atenção]
Quando um bucket está configurado com **permissões de leitura e escrita (read-write)**, qualquer usuário pode acessar e modificar seu conteúdo (por exemplo, usando uma requisição PUT para sobrescrever arquivos). Verifique as permissões necessárias para cada caso de uso e implemente controles de acesso adequados para evitar riscos.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -129,3 +129,7 @@ Você deve receber a seguinte resposta:
</Tabs>

Agora, você criou com sucesso um bucket e atribuiu permissões de leitura e escrita a ele. Você pode começar a armazenar e acessar objetos deste bucket.

:::caution[Atenção]
Quando um bucket está configurado com **permissões de leitura e escrita (read-write)**, qualquer usuário pode acessar e modificar seu conteúdo (por exemplo, usando uma requisição PUT para sobrescrever arquivos). Verifique as permissões necessárias para cada caso de uso e implemente controles de acesso adequados para evitar riscos.
:::
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ h1, p {
}
```

3. Execute a requisição `POST` a seguir no seu terminal, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/) e inserindo o nome desejado do bucket em `name` para criar um bucket de leitura e escrita:
3. Execute a requisição `POST` a seguir no seu terminal, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/) e inserindo o nome desejado do bucket em `name` para criar um bucket de leitura apenas (read-only bucket):

```bash
curl --location 'https://api.azion.com/v4/storage/buckets' \
Expand All @@ -68,7 +68,7 @@ curl --location 'https://api.azion.com/v4/storage/buckets' \
--header 'Authorization: Token [TOKEN VALUE]' \
--data '{
"name": "app-origin",
"edge_access": "read_write"
"edge_access": "read_only"
}'
```

Expand All @@ -79,7 +79,7 @@ curl --location 'https://api.azion.com/v4/storage/buckets' \
"state": "executed",
"data": {
"name": "app-origin",
"edge_access": "read_write"
"edge_access": "read_only"
}
}
```
Expand Down

0 comments on commit 5531270

Please sign in to comment.