Chaves, utilizadores e quem vê o quê

As chaves

Uma chave de API autentica um sistema, não uma pessoa. Cria-se em Chaves API e é mostrada uma única vez, no momento em que é criada.

cconnect_8f3c2a91d7e4b605f2c8a1d9e7b43c50a6f28d91

Se a perderes, não há forma de a recuperar: guardamos um hash e não a chave. O caminho é criar outra e revogar a anterior.

Dá-lhe um nome que ainda faça sentido daqui a seis meses. "Produção", "Facturação", "Integração da loja". Ao fim de um ano com quatro chaves chamadas "teste", ninguém sabe qual pode ser revogada.

O âmbito

Ao criar, podes limitar a chave a uma stream. Uma chave limitada a transaccional não consegue enviar por um domínio de marketing, e o pedido volta com 403.

Vale a pena quando os sistemas são diferentes, e normalmente são: a ferramenta de campanhas e a aplicação que emite recibos raramente são a mesma coisa.

Uma chave pode fazer tudo o resto que a API permite: consultar mensagens e eventos, gerir domínios, supressões e webhooks. Não há permissões mais finas do que isto, e não as inventámos: um controlo que existe mas que nada verifica é pior do que não existir.

Revogar

O botão Revogar corta o acesso imediatamente. Qualquer sistema a usar aquela chave deixa de conseguir enviar nesse instante, e não há forma de a pôr de volta.

A ordem que evita interrupção:

1. Cria a chave nova.
2. Põe-na no sistema e confirma que um envio funciona.
3. Revoga a antiga.

Para saber se uma chave ainda está em uso, olha para o Último uso na lista. Uma chave sem utilização há meses é uma chave a revogar.

Onde uma chave aparece

Depois de criada, o painel mostra só o prefixo, os primeiros caracteres. Chega para distinguir duas chaves e para reconhecer uma nos registos de alguém, e não chega para a usar.

Nos registos que guardamos nunca aparece a chave inteira. Nos teus também não deve aparecer: um sistema que escreve o cabeçalho Authorization no log está a guardar a chave em claro num sítio que muita gente lê.

Os utilizadores

Um utilizador é uma pessoa que entra no painel. As contas são criadas por nós, e não há registo aberto: uma conta existe depois de um contrato, e o registo aberto numa plataforma de envio convida quem quer enviar a partir da reputação alheia.

Uma pessoa pode ter acesso a várias contas, que é como uma agência gere vários clientes com uma entrada só. O selector no topo do painel lista exactamente as contas a que essa pessoa tem acesso.

Todos os utilizadores de uma conta vêem o mesmo. Não há papéis nem permissões por ecrã: seria um controlo que não temos como verificar do lado da API, e meio controlo é pior do que nenhum.

Sair de uma conta

Se entrares numa conta como operador nosso, o painel mostra um aviso permanente em cima, com o nome da conta e uma forma de sair. Não pode ser dispensado: os ecrãs são idênticos aos do cliente, e é assim que alguém muda as definições da conta errada sem dar por isso.

O que fazer se uma chave for exposta

1. Revoga-a. Primeiro, antes de investigar.
2. Cria uma nova e actualiza os sistemas.
3. Olha para Mensagens no período em causa, à procura de envios que não reconheças.
4. Se houve envio indevido, avisa-nos: a reputação dos IPs é partilhada, e podemos ajudar a limitar os danos.