netcode

code réseau

netcode est un protocole client/serveur sécurisé construit sur UDP.

Il est destiné à être utilisé par les jeux multijoueurs en temps réel, qui nécessitent un protocole orienté connexion mais sans blocage en tête de ligne de TCP.

netcode a les fonctionnalités suivantes :

• Connexion client sécurisée avec des jetons de connexion. Seuls les clients que vous autorisez peuvent se connecter à votre serveur. C'est parfait pour un jeu dans lequel vous effectuez du matchmaking dans un backend Web, puis envoyez des clients à un serveur.
• Système de slot client. Les serveurs ont n emplacements pour les clients. Les clients se voient attribuer un emplacement lorsqu'ils se connectent au serveur et se voient rapidement refuser la connexion si tous les emplacements sont occupés.
• Déconnexion rapide et propre du côté client ou serveur de la connexion pour ouvrir l'emplacement pour un nouveau client, ainsi que des délais d'attente pour les déconnexions matérielles.
• Paquets cryptés et signés. Les paquets ne peuvent pas être falsifiés ou lus par des parties non impliquées dans la connexion. La cryptographie est réalisée par l'excellente bibliothèque sodium.
• De nombreuses fonctionnalités de sécurité, notamment une protection robuste contre les paquets malveillants, les attaques par relecture de paquets et les attaques par amplification de paquets.
• Prise en charge du marquage des paquets qui peut réduire considérablement la gigue sur les routeurs Wi-Fi. Lisez cet article pour plus de détails.

Le netcode est stable et prêt pour la production.

Usage

Commencez par générer une clé privée aléatoire de 32 octets. Ne partagez votre clé privée avec personne .

Surtout, n’incluez pas votre clé privée dans l’exécutable de votre client !

Voici une clé privée de test :

 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 };

Créez un serveur avec la clé privée :

 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 ;
}

Démarrez ensuite le serveur avec le nombre d'emplacements clients souhaité :

 netcode_server_start ( server , 16 );

Pour connecter un client, votre client doit accéder à une API REST sur votre backend qui renvoie un jeton de connexion .

L'utilisation d'un jeton de connexion sécurise votre serveur afin que seuls les clients autorisés avec votre backend puissent se connecter.

 netcode_client_connect ( client , connect_token );

Une fois que le client se connecte au serveur, il se voit attribuer un index client et peut échanger des paquets cryptés et signés avec le serveur.

Pour plus de détails, veuillez consulter client.c et server.c

Code source

Ce référentiel contient l'implémentation du netcode en C.

D'autres implémentations de netcode incluent :

• Implémentation du netcode C#
• Implémentation du netcode Golang
• Implémentation de netcode Rust (fork mis à jour de vvanders/netcode.io)
• Implémentation netcode Rust (nouvelle implémentation Rust à partir de zéro)
• code réseau pour Unity
• code réseau pour UE4
• netcode pour Typescript

Si vous souhaitez créer votre propre implémentation de netcode, veuillez lire la norme netcode 1.02.

Contributeurs

Ces gens sont géniaux :

• Val Vanders - Implémentation de Rust
• Walter Pearce - Implémentation de Rust
• Isaac Dawson - Implémentation de Golang
• Alan Stagner - Intégration Unity, implémentation C#
• Jérôme Leclercq - Prise en charge du jeton de connexion aléatoire occasionnel
• Randy Gaul - Vulnérabilité découverte dans la protection contre la relecture
• Benny Chen - Implémentation dactylographiée
• Benny Nazimov - Implémentation de Rust

Merci pour vos contributions à netcode!

Auteur

L'auteur de cette bibliothèque est Glenn Fiedler.

D'autres bibliothèques open source du même auteur incluent : fiable, sérialiser et yojimbo.

Si vous trouvez ce logiciel utile, pensez à le sponsoriser. Merci!

Licence

Licence BSD à 3 clauses.