> ## 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.

# Como criar apps seguros

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

Trabalhar a segurança com o agente é parecido com qualquer outra parte da conversa. O agente do Macaly aplica padrões sensatos, e o que você traz é contexto: que tipo de projeto é, com quais dados ele lida e o que é importante para você. Quanto mais claro você for sobre o projeto, melhor o resultado.

## Defina o contexto desde o início

O mais útil que você pode fazer é contar ao agente, logo no começo, que tipo de projeto está construindo. Algumas palavras de contexto no início levam a um resultado mais sólido do que pedir ajustes de segurança depois que tudo já está pronto.

Ao descrever o projeto, mencione se ele envolve contas de usuário, dados pessoais ou qualquer coisa sensível. O agente leva isso em conta no projeto inteiro, desde a estrutura do banco de dados até a proteção dos endpoints da API.

Acrescentar "garanta que cada usuário veja apenas os próprios dados" depois que o app está pronto muitas vezes significa refatorar o que já existe. Mencionar isso desde o início faz com que o agente projete o app assim desde o primeiro momento.

Exemplos de contexto útil:

```
Estou criando um app SaaS com contas de usuário. Cada usuário
deve ver apenas os próprios projetos e dados. Trate isso como
um app de produção, em que segurança e proteção de dados importam.
```

```
Esta é uma ferramenta interna para nossa equipe gerenciar
chamados de suporte de clientes. Teremos os papéis de admin e
de membro. Os e-mails dos clientes e o histórico das conversas
são sensíveis, então trate-os com cuidado.
```

```
Estou criando um site institucional público para minha
consultoria. Sem contas de usuário, sem pagamentos, apenas
conteúdo e um formulário de contato.
```

O terceiro exemplo é tão útil quanto os dois primeiros. Ele diz ao agente que controles de acesso elaborados não são necessários, o que mantém o projeto simples.

## Quando dar mais contexto ao agente

Para um site simples, sem contas nem integrações externas, os padrões da plataforma costumam dar conta do recado. Um prompt curto é suficiente.

Um prompt inicial mais detalhado ajuda quando o projeto envolve qualquer um destes pontos:

* Contas de usuário e dados pessoais
* Diferentes níveis de permissão (como admin e membro)
* Dados empresariais sensíveis em ferramentas internas
* APIs públicas ou formulários abertos a envios de qualquer pessoa

Nesses casos, algumas frases a mais no primeiro prompt evitam várias iterações depois.

<Note>
  **O que são dados pessoais?** Qualquer informação que possa identificar alguém: nome, e-mail, telefone, endereço, endereço IP, foto. **Dados sensíveis** são um nível acima: informações de saúde, dados financeiros, mensagens privadas ou qualquer coisa relacionada a crianças. Se o seu projeto vai armazenar algum desses tipos, mencionar isso no primeiro prompt ajuda o agente a configurar tudo de forma adequada.
</Note>

## Ajustando comportamentos durante a construção

À medida que o projeto cresce, você pode querer ajustar pontos específicos. O agente pode refinar a validação de entradas, o limite de requisições, o acesso por papéis, quais dados são enviados à página e comportamentos semelhantes. Você não precisa de termos técnicos, basta descrever o que quer em linguagem simples.

Alguns exemplos:

```
O formulário de contato está recebendo spam. Limite os envios
a 3 por visitante por hora.
```

```
No ranking público, mostre apenas os nomes de exibição e as
pontuações. Não exponha nenhuma outra informação dos usuários.
```

```
Adicione uma área de administração em que só eu possa moderar
as publicações. Garanta que ninguém mais consiga acessá-la,
nem tentando adivinhar a URL.
```

O agente entende a intenção e a aplica onde for necessário.

## Se você não definiu o contexto no início

Se você já construiu algo e quer examinar o projeto com mais atenção antes de compartilhá-lo com usuários reais, não há problema. O agente pode revisar o que existe e sugerir melhorias sem que você precise começar de novo.

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

```
Quero levar este projeto para produção. Revise o que está
pronto e sugira o que devo reforçar antes de publicar.
```

```
Estou prestes a compartilhar este app com usuários reais.
Explique como os dados dos usuários são tratados e me avise
se algo parecer estranho.
```

O agente analisa como o acesso, o tratamento de dados e as integrações estão configurados e explica o que se beneficiaria de ajustes. Depois, você decide o que aplicar.

## Verificando áreas específicas com o agente

A qualquer momento, você pode pedir ao agente que explique como algo funciona no seu projeto. Alguns prompts que costumam dar respostas claras:

```
Explique como os dados dos usuários são protegidos neste app.
```

```
O que o endpoint do ranking público retorna para os visitantes?
```

```
Mostre onde as tentativas de login são limitadas.
```

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

Se você não tem certeza de que algo no projeto está certo, descreva sua dúvida ao agente com suas próprias palavras. Ele analisa as partes relevantes e explica o que existe ou sugere o que mudar. Não existem perguntas erradas, e perguntar é mais rápido do que adivinhar.

Para entender o que o Macaly cuida no nível da plataforma, veja a [Visão geral da segurança](/docs/pt-BR/security/overview). Para casos específicos, entre em contato pelo e-mail [support@macaly.com](mailto:support@macaly.com).


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