netcode

código de red

netcode es un protocolo cliente/servidor seguro construido sobre UDP.

Está pensado para su uso en juegos multijugador en tiempo real, que necesitan un protocolo orientado a la conexión pero sin el bloqueo de cabecera de línea de TCP.

netcode tiene las siguientes características:

• Conexión segura del cliente con tokens de conexión. Sólo los clientes que usted autorice pueden conectarse a su servidor. Esto es perfecto para un juego en el que realizas el emparejamiento en un servidor web y luego envías clientes a un servidor.
• Sistema de slots para clientes. Los servidores tienen n ranuras para clientes. Al cliente se le asigna una ranura cuando se conecta al servidor y rápidamente se le niega la conexión si se ocupan todas las ranuras.
• Desconexión rápida y limpia en el lado del cliente o del servidor de la conexión para abrir la ranura para un nuevo cliente, además de tiempos de espera para desconexiones forzadas.
• Paquetes cifrados y firmados. Los paquetes no pueden ser manipulados ni leídos por partes no involucradas en la conexión. La criptografía se realiza mediante la excelente biblioteca de sodio.
• Muchas características de seguridad que incluyen una sólida protección contra paquetes creados con fines malintencionados, ataques de reproducción de paquetes y ataques de amplificación de paquetes.
• Soporte para etiquetado de paquetes que puede reducir significativamente la fluctuación en los enrutadores Wi-Fi. Lea este artículo para más detalles.

netcode es estable y está listo para producción.

Uso

Comience generando una clave privada aleatoria de 32 bytes. No comparta su clave privada con nadie .

Especialmente, ¡no incluya su clave privada en el ejecutable de su cliente!

Aquí hay una clave privada de prueba:

 static uint8_t private_key [ NETCODE_KEY_BYTES ] = { 0x60 , 0x6a , 0xbe , 0x6e , 0xc9 , 0x19 , 0x10 , 0xea , 
                                                  0x9a , 0x65 , 0x62 , 0xf6 , 0x6f , 0x2b , 0x30 , 0xe4 , 
                                                  0x43 , 0x71 , 0xd6 , 0x2c , 0xd1 , 0x99 , 0x27 , 0x26 ,
                                                  0x6b , 0x3c , 0x60 , 0xf4 , 0xb7 , 0x15 , 0xab , 0xa1 };

Cree un servidor con la clave privada:

 char * server_address = "127.0.0.1:40000" ;

struct netcode_server_config_t server_config ;
netcode_default_server_config ( & server_config );
memcpy ( & server_config . private_key , private_key , NETCODE_KEY_BYTES );

struct netcode_server_t * server = netcode_server_create ( server_address , & server_config , time );
if ( ! server )
{
    printf ( "error: failed to create servern" );
    return 1 ;
}

Luego inicie el servidor con la cantidad de ranuras de cliente que desee:

 netcode_server_start ( server , 16 );

Para conectar un cliente, su cliente debe acceder a una API REST en su backend que devuelva un token de conexión .

El uso de un token de conexión protege su servidor para que solo los clientes autorizados con su backend puedan conectarse.

 netcode_client_connect ( client , connect_token );

Una vez que el cliente se conecta al servidor, se le asigna un índice de cliente y puede intercambiar paquetes cifrados y firmados con el servidor.

Para obtener más detalles, consulte client.c y server.c

Código fuente

Este repositorio contiene la implementación de netcode en C.

Otras implementaciones de netcode incluyen:

• implementación de código de red C #
• implementación de netcode Golang
• Implementación de netcode Rust (bifurcación actualizada de vvanders/netcode.io)
• Implementación de netcode Rust (nueva implementación de Rust desde cero)
• código de red para Unity
• código de red para UE4
• código de red para mecanografiado

Si desea crear su propia implementación de netcode, lea el estándar netcode 1.02.

Colaboradores

Estas personas son increíbles:

• Val Vanders - Implementación de Rust
• Walter Pearce - Implementación de Rust
• Isaac Dawson - Implementación de Golang
• Alan Stagner: integración de Unity, implementación de C#
• Jérôme Leclercq - Soporte para token de conexión aleatoria nonce
• Randy Gaul: vulnerabilidad descubierta en la protección de repetición
• Benny Chen - Implementación de texto mecanografiado
• Benny Nazimov - Implementación de Rust

¡Gracias por tus contribuciones a netcode!

Autor

El autor de esta biblioteca es Glenn Fiedler.

Otras bibliotecas de código abierto del mismo autor incluyen: confiabilidad, serialización y yojimbo.

Si encuentra útil este software, considere patrocinarlo. ¡Gracias!

Licencia

Licencia BSD de 3 cláusulas.