Protocolos de comércio com agentes
Web Bot Auth: a chave publicada, a assinatura do pedido e o que o jsonW não faz com elas
O Web Bot Auth prova que um robô tem uma chave ligada a um endereço público. A prova vem de uma assinatura no pedido HTTP. Veja o formato da assinatura, o que a chave publicada resolve, o que não resolve e por que a Wortic ainda não usa o protocolo.
· jsonW 1.3.11
O protocolo
O Web Bot Auth é um rascunho do grupo de trabalho da IETF. Ele usa assinaturas de mensagens HTTP, definidas na RFC 9421. O robô assina o pedido com uma chave privada. O site confere a assinatura com a chave pública, publicada num endereço conhecido.
Os elementos da assinatura
A assinatura cobre partes do pedido, como o método, o endereço e alguns cabeçalhos. Ela também carrega o tempo de criação, para evitar reuso. O cabeçalho de identificação do robô aponta para o lugar onde a chave pública está.
Signature-Agent: [endereço onde a chave pública está publicada]
O que a chave publicada resolve
Com a chave publicada, o site sabe que o pedido foi feito por quem tem a chave privada correspondente. Isso prova posse. Não prova que o robô é honesto, nem quem o opera.
O que não resolve
O protocolo não prova quem é o dono do robô. Também não prova que alguém autorizou uma compra. Para isso, existe o mandato, que é outro registro. Por isso, o jsonW não deve tratar uma assinatura de robô como prova de compra.
Onde o jsonW entraria
O catálogo da casa poderia guardar a lista de chaves públicas aceitas, com o nome do robô e a data de validade de cada chave. Essa lista ainda não existe. Hoje nenhum registro da casa usa esse formato.
O que a Wortic faz hoje
A Wortic não usa Web Bot Auth. O protocolo não faz parte do que a casa tem no ar. Esta publicação deve ser atualizada se isso mudar.
Como conferir uma assinatura
Para testar, use um robô de demonstração com chave de teste. Confira se a assinatura cobre o método, o endereço e o tempo. Depois, troque um byte do pedido e veja se a verificação falha. Se não falhar, a verificação está errada.
A RFC 9421 está em rfc-editor.org, e o rascunho, em datatracker.ietf.org.
O cabeçalho que identifica o robô
O robô envia um cabeçalho de identificação com o endereço onde a chave está publicada. Quem recebe o pedido busca a chave nesse endereço e confere a assinatura. Se o endereço não responder, a verificação falha, e o pedido deve ser tratado como não identificado.
Chave e validade
Uma chave pública também tem vida útil. Por isso, o registro deve guardar a chave, a data de início e a data de fim de cada uma. Uma chave vencida não deve servir para provar identidade, mesmo que ainda esteja publicada.
O que o registro não deve conter
A chave privada nunca entra no registro da casa. Quem guarda a chave privada é o dono do robô. Um registro com a chave privada seria um risco, porque qualquer um poderia assinar pedidos em nome do robô.