Adicionar um conector leva quatro campos e cerca de um minuto, e praticamente todo mundo trava no mesmo. O cliente pergunta como deve autenticar, oferece OAuth e um cabeçalho de requisição, e a resposta certa é a terceira opção que ninguém espera: nenhuma.
Por que nenhuma é a resposta certa
A chave já está no endereço. Um conector apontado para esse endereço está apontado para uma porta que já está aberta para quem tiver essa URL, então não sobra nada para o OAuth resolver. Escolha OAuth mesmo assim e o cliente sai procurando um servidor de autorização que nunca ia responder; adicione um cabeçalho bearer e você terá enviado uma segunda credencial a um servidor que não pedia nenhuma.
Não é um atalho para driblar a segurança. Ele transfere toda a segurança para um único lugar — o endereço — que é algo que você pode ver, copiar, colar e revogar, em vez de um fluxo em que você precisa confiar que três partes o implementaram corretamente.
Para onde vai o cuidado, então
- Trate o endereço como a credencial, porque ele é. O lugar dele é no cliente e em nenhum outro — nem em um documento compartilhado, nem em uma captura de tela das suas configurações.
- Crie uma por cliente, se quiser. Revogar uma chave derruba apenas os conectores construídos sobre ela.
- Use os endereços específicos quando um assistente tiver uma só função. Um conector que só consegue ler a caixa de entrada não consegue publicar no LinkedIn por engano.
- Revogue imediatamente se uma vazar. É instantâneo, e criar outra leva um segundo.
A outra metade da resposta
O motivo de um endereço aberto ser suportável é que aquilo que está por trás dele é cuidadoso por conta própria. Uma campanha executa uma ação por turno e conta o orçamento do dia a partir das ações já realizadas. Tudo o que leva o seu nome espera o seu sim. Uma pausa do LinkedIn é tratada como pausa, e não repetida até virar uma restrição. Um assistente com o endereço ainda assim não consegue fazer a sua conta executar vinte coisas em um minuto, porque nada aqui consegue.
Se você se lembrar de uma só linha disto: quando o cliente perguntar como autenticar, diga “nenhuma” e deixe os cabeçalhos vazios.
Perguntas frequentes
E se um cliente não me deixar escolher “nenhuma”?
Então ele está pedindo um cabeçalho, e não uma identidade, e a chave vai ali: X-API-KEY, com o endereço simples e sem a chave no caminho. Todo cliente que vale a pena usar oferece “nenhuma”; os que não oferecem costumam ser versões antigas, e atualizar é o caminho mais curto.
Uma chave para tudo ou uma para cada cliente?
Uma para cada, se você usa mais de um cliente. Elas não custam nada, o painel as lista com a última vez em que cada uma foi usada, e assim revogar uma derruba um só conector em vez de todos.
O que acontece no instante em que eu revogo uma?
Tudo o que foi construído sobre ela para de responder, imediatamente. Um conector que continua apontando para uma chave revogada informa que não tem ferramentas, que é a mesma coisa que um endereço digitado errado informa — então revogue de propósito e crie a chave substituta antes de sair procurando o que quebrou.