Login assinado

O transporte Signed Login pode ser usado por servidores que desejam personalizar a forma como atribuem clientes às ilhas, substituindo ou encapsulando o Archipelago na sua arquitetura.

Em vez de se ligar diretamente a um backend em tempo real, o Signed Login faz uma signed fetch para obter a string de ligação. Este passo intermédio permite aos servidores empregar qualquer estratégia de atribuição que desejem.

Os URIs de Signed Login têm esta forma:

signed-login:https://comms.example.com/auth&param=value

A parte após o signed-login: prefixo pode ser qualquer URL válida.

Uso

Um pedido de Signed Login é construído usando o signed fetch mecanismo.

A resposta, se for bem-sucedida, terá o estado 200 e um corpo JSON com pelo menos os seguintes campos:

Campo	Tipo	Valor
fixedAdapter	string	O URI de transporte atribuído (por exemplo, livekit: ou ws-room:)

Por exemplo:

{ 
  fixedAdapter: "ws-room:wss://comms.example.com/rooms/17"
}

Em caso de falha, a resposta pode ter qualquer código de estado apropriado e um corpo JSON com pelo menos os seguintes campos:

Campo	Tipo	Valor
message	string	(Opcional) uma explicação ou código de erro para a falha.

Respostas com campos adicionais no corpo JSON são válidas, e o conteúdo do erro message fica não especificado. As implementações podem usar esta flexibilidade para integrar signed-login: nas suas aplicações como acharem adequado.