Fetch assinado

Quando os clientes do protocolo quiserem fazer solicitações HTTPs autenticadas, podem usar o padrão signed fetch mecanismo.

Um signed fetch é uma solicitação que inclui um serializada em JSONrepresentado por meio de cabeçalhos. Servidores com APIs compatíveis com Decentraland podem validar identidades antes de, por exemplo, permitir solicitações de scenes ou criar adapters.

Cabeçalhos

As informações de que o servidor precisa para validar a cadeia de autenticação são transmitidas em 3+ cabeçalhos:

• X-Identity-Timestamp: o timestamp incluído na carga útil assinada (veja abaixo).

• X-Identity-Metadata: o metadata incluído na carga útil assinada (veja abaixo).

• X-Identity-AuthChain-<index>: o etapa de autenticação serializada em JSON <index>, começando em 0.

A cadeia transmitida é validada pelo servidor conforme especificado.

Corpo

O corpo da solicitação não é especificado. Os serviços têm total flexibilidade para usar quaisquer protocolos ou formatos que desejarem.

Carga útil

A cadeia de autenticação carga útil para um signed fetch é uma string em minúsculas, separada por dois-pontos que inclui alguns dos elementos da solicitação:

<method>:<path>:<timestamp>:<metadata>

O method e path os campos devem corresponder aos da solicitação, e timestamp é o mesmo que no X-Identity-Timestamp cabeçalho.

O último campo, metadata, pode ter conteúdo arbitrário.

Por exemplo:

get:/some/path:1682790056:{"some":"custom json"}