Um peer é um programa que tem uma identidade kolo-id: um par de chaves Ed25519. Não existem nomes de usuário nem contas. A chave pública é o nome do peer na rede, e todas as outras bibliotecas se referem a um peer por ela.
A chave
koloid.Generatecria uma nova identidade.SaveeSaveNewgravam a identidade em um arquivo eLoada lê de volta, então um peer mantém a mesma chave quando reinicia.- O arquivo de chave guarda só a seed de 32 bytes, gravada com modo 0600.
PublicKeyretorna a chave pública de 32 bytes, ePublicKeyStringa mesma chave em hex. Imprimir uma*Identitymostra só a chave pública; a seed nunca aparece em nenhuma saída.
O que “igual” quer dizer
Dois peers são o mesmo peer quando as chaves públicas deles são iguais,
byte a byte: a.PublicKey().Equal(b.PublicKey()). Endereços não contam. Um
peer pode mudar de endereço IP e de porta e continuar sendo o mesmo peer, e
dois peers atrás de um mesmo endereço continuam sendo dois peers.
Os programas costumam mostrar os primeiros bytes de uma chave como um rótulo curto, como faz o chat de Primeiros passos. Esse rótulo serve para as pessoas lerem. Nunca use esse rótulo para decidir quem é alguém: compare a chave inteira.
Como um peer prova a sua chave
- Uma assinatura feita com
Signdeclara uma string de contexto, comokolo-log/record/v1, e só é válida nesse contexto, então uma assinatura feita para um tipo de mensagem nunca é aceita como outro. - Uma conexão kolo-secure é TLS 1.3 ligado às chaves dos dois peers. Quando ela abre, cada lado conhece a chave pública do outro, e quem inicia a conexão pedindo uma determinada chave recebe essa chave ou um erro.
Uma pessoa, vários dispositivos
Um peer é uma chave de dispositivo. Uma pessoa que usa vários dispositivos tem uma chave em cada um, e a kolo-id pode ligá-las a uma só pessoa:
- Uma frase de recuperação de 24 palavras (BIP-39) dá a chave da pessoa. A biblioteca nunca a guarda nem a imprime.
- A chave da pessoa certifica dispositivos aprovadores, e um aprovador
certifica dispositivos comuns, então a chave da pessoa nunca fica em um
dispositivo. Cada dispositivo guarda a sua própria chave aleatória e o seu
certificado, em um arquivo
.certao lado do arquivo de chave. VerifyDeviceconfere uma mensagem de um dispositivo para a pessoa que você espera. Um dispositivo perdido é revogado sem perder a identidade.
Veja Frase de recuperação e dispositivos.
A kolo-invite vincula um dispositivo novo por
convite, e o pacote devices da kolo-braid
guarda os dispositivos de uma pessoa em um grupo.