Un peer es un programa que tiene una identidad de kolo-id: un par de claves Ed25519. No hay nombres de usuario ni cuentas. La clave pública es el nombre del peer en la red, y todas las demás bibliotecas se refieren a un peer por ella.
La clave
koloid.Generatecrea una identidad nueva.SaveySaveNewla escriben en un archivo yLoadla vuelve a leer, así que un peer conserva la misma clave entre reinicios.- El archivo de clave solo guarda la semilla de 32 bytes, escrita con el modo 0600.
PublicKeydevuelve la clave pública de 32 bytes, yPublicKeyStringla misma clave en hexadecimal. Al imprimir un*Identitysolo se muestra la clave pública; la semilla no aparece nunca en ninguna salida.
Qué significa «igual»
Dos peers son el mismo peer cuando sus claves públicas son iguales, byte a
byte: a.PublicKey().Equal(b.PublicKey()). Las direcciones no cuentan. Un
peer puede cambiar su dirección IP y su puerto y seguir siendo el mismo
peer, y dos peers detrás de una misma dirección siguen siendo dos peers.
Los programas suelen mostrar los primeros bytes de una clave como etiqueta corta, como hace el chat de Primeros pasos. Esa etiqueta es para que la lean las personas. No la uses nunca para decidir quién es alguien: compara la clave entera.
Cómo demuestra un peer su clave
- Una firma de
Signindica una cadena de contexto, comokolo-log/record/v1, y solo se verifica con ese contexto, así que una firma hecha para un tipo de mensaje nunca se acepta como otro. - Una conexión de kolo-secure es TLS 1.3 ligado a las claves de los dos peers. Al abrirse, cada lado conoce la clave pública del otro, y quien llama pidiendo una clave concreta recibe esa clave o un error.
Una persona, varios dispositivos
Un peer es una clave de dispositivo. Una persona que usa varios dispositivos tiene una clave en cada uno, y kolo-id puede unirlas a una sola persona:
- Una frase de recuperación de 24 palabras (BIP-39) da la clave de la persona. La biblioteca nunca la guarda ni la imprime.
- La clave de la persona certifica dispositivos aprobadores, y un aprobador
certifica dispositivos comunes, así que la clave de la persona nunca vive
en un dispositivo. Cada dispositivo guarda su propia clave aleatoria y su
certificado, en un archivo
.certjunto al archivo de clave. VerifyDevicecomprueba un mensaje de un dispositivo para la persona que esperas. Un dispositivo perdido se revoca sin perder la identidad.
Consulta Frase de recuperación y dispositivos.
kolo-invite vincula un dispositivo nuevo por
invitación, y el paquete devices de kolo-braid
guarda los dispositivos de una persona en un grupo.