> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar apps seguras

> Como trabalhar com o agente nas decisões de segurança do teu projeto

Trabalhar em segurança com o agente é muito parecido com qualquer outra parte da conversa. O agente Macaly aplica predefinições sensatas, e aquilo que trazes é o contexto: que tipo de projeto é este, que dados trata e o que é importante para ti. Quanto mais claro fores sobre o teu projeto, melhor será o resultado.

## Define o contexto cedo

A coisa mais útil que podes fazer é dizer ao agente, logo no início, que tipo de projeto estás a criar. Algumas palavras de contexto no início levam a um resultado mais sólido do que pedir ajustes de segurança depois de tudo já estar construído.

Quando descreves o teu projeto, menciona se envolve contas de utilizador, dados pessoais ou algo sensível. O agente tem isso em conta em todo o projeto, desde como a base de dados é estruturada até como os endpoints da API são protegidos.

Adicionar "garante que cada utilizador só vê os seus próprios dados" depois de a app estar construída costuma implicar reestruturar o que já existe. Mencioná-lo à partida significa que o agente desenha a app dessa forma desde o início.

Exemplos de contexto útil:

```
Estou a criar uma app SaaS com contas de utilizador. Cada utilizador
só deve ver os seus próprios projetos e dados. Trata isto como uma
app de produção onde a segurança e a proteção de dados importam.
```

```
Isto é uma ferramenta interna para a nossa equipa gerir os tickets
de apoio ao cliente. Vamos ter funções de administrador e de membro.
Os emails dos clientes e o histórico de conversas são sensíveis,
por isso trata-os com cuidado.
```

```
Estou a criar um site de marketing público para a minha consultoria.
Sem contas de utilizador, sem pagamentos, apenas conteúdo e um
formulário de contacto.
```

O terceiro exemplo é tão útil como os dois primeiros. Diz ao agente que não são precisos controlos de acesso elaborados, o que mantém o projeto simples.

## Quando dar ao agente mais contexto

Para um site simples sem contas nem integrações externas, as predefinições da plataforma normalmente cobrem o que precisas. Um prompt curto é suficiente.

Um prompt inicial mais detalhado ajuda quando o teu projeto vai envolver algum dos seguintes pontos:

* Contas de utilizador e dados pessoais
* Diferentes níveis de permissão (como administrador e membro)
* Dados de negócio sensíveis em ferramentas internas
* APIs públicas ou formulários de submissão abertos

Nestes casos, algumas frases extra no teu primeiro prompt poupam iterações mais tarde.

<Note>
  **O que conta como dados pessoais?** Qualquer coisa que possa identificar alguém: nome, email, número de telefone, morada, endereço IP, fotografia. **Dados sensíveis** são um patamar acima: informações de saúde, detalhes financeiros, mensagens privadas ou qualquer coisa relacionada com crianças. Se o teu projeto for armazenar algum destes, mencioná-lo no teu primeiro prompt ajuda o agente a configurar tudo de forma adequada.
</Note>

## Refinar comportamentos durante a construção

À medida que o teu projeto cresce, podes querer ajustar coisas específicas. O agente pode refinar a validação de dados, os limites de pedidos, o acesso baseado em funções, que dados são enviados para a página e comportamentos semelhantes. Não precisas de termos técnicos, basta descreveres o que queres em linguagem simples.

Alguns exemplos:

```
O formulário de contacto está a receber spam. Limita as submissões
a 3 por visitante por hora.
```

```
Na tabela de classificação pública, mostra apenas nomes de exibição
e pontuações. Não exponhas nenhuma outra informação dos utilizadores.
```

```
Adiciona uma área de administração onde só eu possa moderar
publicações. Garante que mais ninguém consegue aceder-lhe, mesmo
adivinhando o URL.
```

O agente vai perceber a intenção e aplicá-la onde for relevante.

## Se não definiste o contexto cedo

Se já construíste algo e queres analisá-lo mais de perto antes de o partilhares com utilizadores reais, não há problema nenhum. O agente pode rever o que existe e sugerir melhorias sem teres de recomeçar do zero.

Alguns prompts que funcionam bem para este tipo de revisão:

```
Quero levar este projeto para produção. Revê o que existe e sugere
o que devo reforçar antes de publicar.
```

```
Estou prestes a partilhar esta app com utilizadores reais. Explica-me
como os dados dos utilizadores são tratados e diz-me se algo parecer
estranho.
```

O agente vai analisar como o acesso, o tratamento de dados e as integrações estão configurados, e explicar o que beneficiaria de ajustes. Depois podes decidir o que aplicar.

## Verificar áreas específicas com o agente

Podes pedir ao agente, em qualquer momento, para explicar como algo no teu projeto funciona. Alguns prompts que costumam dar respostas claras:

```
Explica-me como os dados dos utilizadores são protegidos nesta app.
```

```
O que devolve aos visitantes o endpoint da tabela de classificação
pública?
```

```
Mostra-me onde as tentativas de início de sessão têm limite de
pedidos.
```

```
Quem tem acesso à área de administração, e como é que isso é
imposto?
```

Se não tiveres a certeza se algo no teu projeto está bem, basta descreveres a tua preocupação ao agente em palavras simples. Ele vai analisar as partes relevantes e ou explicar o que existe, ou sugerir o que mudar. Não há perguntas erradas, e perguntar é mais rápido do que adivinhar.

Para contexto sobre o que o Macaly trata ao nível da plataforma, vê a [Visão geral da segurança](/docs/pt/security/overview). Para casos de uso específicos, contacta [support@macaly.com](mailto:support@macaly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.