Pular para o conteúdo
jsonW Paper GitHub

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ô.

Rascunho do Web Bot Auth na IETF →