Escrever um servidor
Sirva o handshake e a biblioteca; adicione backups de saves, cheats ou pareamento quando quiser e declare-os nas funções. Um servidor cabe em um fim de semana.
GET /.well-known/lantern
GET /api/lantern/v1/apps?sort=addedO texto ainda pode mudar antes da 1.0. Os comentários são bem-vindos, sobretudo de quem escreve clientes e servidores.
Feito para durar
O que o torna sólido
O Lantern começa do zero: não é compatível com nenhum protocolo anterior, então cada escolha serve à segurança e à duração.
- Versionado duas vezes, no caminho e em cada documento: uma mudança nunca quebra um cliente em silêncio.
- Um token por dispositivo, aprovado no servidor e revogável um a um: nenhuma senha é digitada ou guardada no console.
- HTTPS em todo lugar. Um servidor em casa com o próprio certificado fica fixado no pareamento, depois de comparada a impressão digital da chave nas duas telas.
- Conteúdo verificado: cada arquivo vem com o seu SHA-256, que o console verifica antes de qualquer instalação.
- Funções declaradas: o servidor diz o que oferece, a quem e em qual esquema.
- Uma suíte de conformidade que verifica um servidor de fora, e um servidor de referência que passa nela.
O que é novo
O que acrescenta
O que os clientes tinham de adivinhar até agora, por escrito.
- Um SHA-256 para cada arquivo, verificado antes de qualquer instalação.
- Uma versão no caminho e um schema em cada documento: um cliente e um servidor de idades diferentes continuam se entendendo.
- Uma lista de funções declarada em vez de adivinhada.
- Páginas com cursor que não saltam nem repetem nada enquanto a biblioteca muda.
- Parear um console com um token revogável, em vez de uma senha guardada nele.
- Erros com códigos de estado reais, todos num só formato.
- Nada escondido: nenhum identificador de hardware, nenhuma criptografia proprietária, nenhuma mudança no cliente decidida pelo servidor.
Implementá-lo
Para quem escreve servidores e clientes
A especificação é curta: poucas rotas, formas fixas, HTTP e JSON simples.
Escrever um cliente
Encontre os servidores da rede local, leia as funções deles, percorra a biblioteca página por página e verifique o SHA-256 de cada download. Um cliente cabe em algumas centenas de linhas de C++.
User-Agent: ExampleClient/0.1
Range: bytes=0-1048575Esquemas e exemplos
Um esquema JSON para cada documento, um exemplo de cada um e uma descrição OpenAPI das rotas, para verificar os seus.
No repositório: uma suíte de conformidade para rodar contra um servidor (conformance/) e um pequeno servidor de referência que passa nela (server/). Só uma implementação que passe na suíte deve se dizer compatível com o Lantern.
O primeiro cliente será o PlayShelf, um gerenciador de pacotes homebrew para o Nintendo Switch. PlayShelf
Para os seus próprios jogos
O Lantern leva o que o seu servidor tem, entre ele e o seu console. Ele não encontra nada nem distribui nada: não é um jeito de conseguir jogos, e os servidores são para os jogos que você possui.
Licenças
Livre para implementar
- CC BY 4.0O texto da especificação: compartilhe e adapte, citando a origem.
- MITTodo o resto (esquemas, descrição OpenAPI, exemplos, suíte de conformidade, servidor de referência), para que qualquer servidor ou cliente, sob qualquer licença, possa implementar o protocolo e copiar os esquemas como estão.
Perguntas, comentários e propostas vão para as issues do repositório.
Este site
Privacidade
Este site não usa cookies e só guarda no seu navegador o idioma que você escolhe no cabeçalho. Ele não carrega nada de outro site: as fontes, as imagens e os scripts são servidos junto com ele.
Ele conta as visitas com Umami Cloud, na União Europeia (Frankfurt), sem cookies. Para cada página vista: a página, a página de onde você veio, seu navegador, sistema e tipo de dispositivo, o tamanho da sua tela, seu idioma e seu país. Seu endereço IP é usado para saber o país e distinguir as visitas, e não é guardado com elas. As contagens são mantidas por seis meses, usadas só para saber o que é lido, e nunca vendidas nem compartilhadas. A política da Umami: umami.is/privacy.
Quem publica este site, quem o hospeda e como perguntar sobre os seus dados: Privacidade e aviso legal
Leia e conte para a gente
O rascunho é o momento de mudar as coisas. Uma issue sobre uma rota, um campo ou um caso esquecido ajuda todos os servidores e clientes que virão.