# Parameter Store: navegar, revelar e editar parâmetros

Navegue pelos parâmetros do Systems Manager por caminho, veja valores e histórico, revele SecureStrings com segurança e crie, edite ou exclua parâmetros.

Abra **Services → Systems Manager → Parameter Store**. Os parâmetros aparecem um nível do caminho por vez (`/checkout-api` → `prod` → `DB_POOL_SIZE`), com os valores String e StringList na lista. A busca procura em todos os nomes e descrições sob o caminho atual.

Screenshot: Parameter Store em /checkout-api/prod: valores String e StringList visíveis, SecureStrings ocultos

## A tela de um parâmetro

- Tipo, nível, versão, quando mudou pela última vez e quem mudou, e a chave do KMS de um SecureString.
- **History**: cada versão com valor, horário, autor e rótulos. Versões SecureString continuam ocultas.
- Suas [tags](https://cloudconsole.dev/pt-br/help/tags).

## Valores SecureString

Um SecureString fica oculto até você tocar em **Reveal**. Se o [bloqueio do app](https://cloudconsole.dev/pt-br/help/app-lock) estiver ativado, ou a proteção da conta for *Typed + Face ID*, o Face ID ou sua digital é pedido antes. O valor aparece por 30 segundos e é apagado assim que o app vai para segundo plano ou você sai da tela. Ele nunca é salvo, nunca entra na busca nem no registro de Activity, e os relatórios de falhas mascaram valores de parâmetros. Revelar fica registrado no CloudTrail como qualquer chamada `GetParameter`.

## Alterações (Pro)

- **Create**: um String, StringList ou SecureString (opcionalmente com sua própria chave do KMS) sob o caminho atual.
- **Edit value**: salva uma nova versão com o mesmo tipo e chave; as versões anteriores continuam no histórico. O campo de um SecureString não vem preenchido, então o valor atual nunca é lido para isso.
- **Delete**: remove o parâmetro e todas as suas versões (confirmação digitada).

O registro de Activity guarda o nome do parâmetro e a ação, nunca o valor.

## Permissões

| O quê | Ações do IAM | Em ReadOnlyAccess / ViewOnlyAccess |
|---|---|---|
| Lista e busca | `ssm:DescribeParameters` | Sim / Não (adicione) |
| Valores e histórico | `ssm:GetParametersByPath`, `ssm:GetParameter`, `ssm:GetParameterHistory` | Sim / Não (adicione) |
| Revelar um SecureString | `ssm:GetParameter`, mais `kms:Decrypt` em uma chave gerenciada pelo cliente | Sim (não `kms:Decrypt`) / Não |
| Create, Edit value, Delete | `ssm:PutParameter`, `ssm:DeleteParameter` (e `kms:Encrypt` para uma chave gerenciada pelo cliente) | Não / Não |

Se uma chamada for negada, a tela diz qual permissão falta, inclusive quando é a chave do KMS que recusa.

## Perguntas frequentes

### Um SecureString é enviado para algum lugar além da AWS?

Não. O CloudConsole fala direto com a AWS a partir do seu celular. O valor só existe na tela enquanto é exibido, e é apagado depois de 30 segundos, quando o app vai para segundo plano ou quando você sai da tela.

**Ainda com dúvidas?**

Escreva para [support@cloudconsole.dev](mailto:support@cloudconsole.dev) contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.

## Veja também

- [Run Command: rodar um comando de shell nas suas instâncias](https://cloudconsole.dev/pt-br/help/run-command) – Como usar o app
- [Bloquear o app com Face ID ou impressão digital](https://cloudconsole.dev/pt-br/help/app-lock) – Privacidade e segurança
- [Permissões para alterações (ações do Pro)](https://cloudconsole.dev/pt-br/help/permissions-for-changes) – Permissões e erros
- [Onde suas credenciais ficam guardadas](https://cloudconsole.dev/pt-br/help/credentials-and-privacy) – Privacidade e segurança

[Todos os tópicos de ajuda →](https://cloudconsole.dev/pt-br/help/)

---

Source: https://cloudconsole.dev/pt-br/help/parameter-store

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
