Chaves de API e segurança
Escopos, listas de IPs permitidos, limites diários de gasto, expiração, rotação sem interrupção e o que fazer se uma chave vazar.
Nesta página
Uma chave de API pode fazer tudo o que seus escopos permitem, pagando com seu saldo. Trate-a como uma senha.
Formato da chave
As chaves são sgk_ seguido de 40 letras e números. O SmsGrab guarda só uma impressão digital de cada chave, então ela é mostrada uma vez, quando você a cria ou rotaciona, e nunca mais. Na sua conta você vê apenas o começo e os quatro últimos caracteres.
Limite o que cada chave pode fazer
Ao criar ou editar uma chave, você pode restringi-la:
| Configuração | O que faz |
|---|---|
| Escopos | read para saldo, catálogo, preços, ativações e uso; read e purchase para também comprar, cancelar e finalizar |
| Lista de IPs permitidos | Até 50 endereços IPv4 ou IPv6 ou faixas CIDR; requisições de outros endereços são recusadas |
| Limite diário de gasto | O máximo que essa chave pode gastar (líquido) por dia UTC; acima disso, as compras são recusadas e nada é cobrado |
| Expiração | Uma data opcional depois da qual a chave para de funcionar, no máximo 2 anos à frente |
Use uma chave por aplicação ou servidor, com os menores escopos necessários. Uma conta pode ter até 10 chaves ativas.
Confirmar mudanças sensíveis
Criar uma chave, rotacioná-la, adicionar um webhook, trocar o segredo de um webhook e afrouxar uma chave (mais escopos, uma lista de IPs maior, um limite mais alto ou uma expiração mais tardia) pedem sua senha de novo, além do código da verificação em duas etapas se ela estiver ativada. A confirmação vale por 5 minutos. Revogar uma chave e apertar seus limites nunca pedem isso.
Rotação sem interrupção
Rotacionar dá um novo segredo à chave, mantendo as configurações, o uso e os webhooks. Você escolhe um período de transição de até 72 horas em que o segredo antigo ainda funciona, para atualizar seus servidores sem interrupção.
Revogar
Revogar para a chave na hora e de vez. Os webhooks dela também são desativados.
Se uma chave vazou
- Revogue a chave, ou rotacione com um período de transição de 0 hora.
- Confira o registro de requisições da chave (últimos 7 dias) e sua Carteira em busca de atividades que você não reconhece.
- Crie uma nova chave com lista de IPs permitidos e limite diário de gasto.
O que registramos
As chaves nunca aparecem em nenhum log. Para cada requisição guardamos por 7 dias o horário, a rota, o status, a duração e um id da requisição, e você pode vê-los por chave. Criar, rotacionar e revogar chaves também aparece na atividade da conta, e cada chave nova gera uma notificação.
Nunca pelo navegador
A API não aceita chamadas feitas por páginas web (não há CORS). Chame-a apenas a partir dos seus próprios servidores.
Este artigo foi útil?
Obrigado! Que bom que ajudou.