Système de bannissement d'adresses IP - XBOX Game Development Documentation

La fonctionnalité de bannissement d’adresses IP vous permet de restreindre l’accès au jeu depuis des adresses ou des plages d’adresses IP spécifiées. Lorsqu’un bannissement d’adresse IP est appliqué, les tentatives d’authentification ultérieures effectuées depuis cette adresse IP ou depuis la plage bannie sont rejetées. Les bannissements d’adresses IP peuvent être permanents ou temporaires, avec une date d’expiration spécifiée, et peuvent s’appliquer à une adresse IP unique ou à une plage d’adresses IP exprimée en notation CIDR. Un bannissement d’adresse IP est limité à un titre et ne s’applique à aucun autre titre de votre espace de noms. Le tutoriel suivant vous montre comment utiliser le système de bannissement d’adresses IP à l’aide de l’API PlayFab et de Game Manager.

Identifier

Vous pouvez identifier une adresse IP à bannir au moyen de PlayStream Monitor. Si vous remarquez une activité de connexion suspecte, recherchez un événement Player logged in et sélectionnez les accolades dans la colonne JSON pour afficher ses détails. Copiez l’adresse figurant dans le champ “IPV4Address”.

Game Manager - Bannissements d'adresses IP - Événement de connexion suspect

Si l’option “Store full user IP addresses” de Settings > Data Collection est désactivée pour votre titre, le dernier octet de l’adresse IP est masqué.

Application des bannissements

Si vous le jugez nécessaire, vous pouvez créer un bannissement d’adresse IP. Il existe deux façons de créer des bannissements : manuellement au moyen de Game Manager, ou par programmation au moyen du SDK Services.

Un titre peut créer des bannissements pour 200 adresses ou plages d’adresses IP au maximum.

Création d’un bannissement d’adresse IP depuis Game Manager

Votre gestionnaire de communauté peut souhaiter appliquer un bannissement à l’aide de Game Manager.

Accédez à la section IP Bans.
Sélectionnez New IP Ban pour afficher le formulaire New IP Ban.
Collez l’adresse IP que vous souhaitez bannir, ou saisissez la plage CIDR à bannir.
Sélectionnez Permanent pour un bannissement permanent, ou sélectionnez une date et une heure d’expiration pour votre bannissement.
Si vous le souhaitez, saisissez le motif de votre bannissement.
Enfin, sélectionnez le bouton ADD BAN.

Game Manager - Bannissements d'adresses IP - Nouveau bannissement

Si tout est correctement défini, un nouveau bannissement d’adresse IP apparaît dans le tableau avec l’état “Active”.

Game Manager - Bannissements d'adresses IP - Tableau

Gestion des bannissements d’adresses IP depuis Game Manager

Vous pouvez désactiver manuellement des bannissements d’adresses IP en les sélectionnant, puis en sélectionnant Disable selected bans. Leur état passe à “Disabled”.

Game Manager - Bannissements d'adresses IP - Désactiver

Vous pouvez modifier un bannissement en sélectionnant le champ de l’adresse IP dans le tableau. Vous accédez alors au formulaire Edit IP Ban. Vous pouvez y désactiver (ou réactiver) des bannissements, ainsi que modifier la date d’expiration et le motif. Sélectionnez Save pour enregistrer vos modifications.

Game Manager - Bannissements d'adresses IP - Modifier

Lorsque la date d’expiration d’un bannissement est dépassée, son état passe à “Expired”. Pour réactiver le bannissement, vous devez définir une nouvelle date d’expiration. Seuls les bannissements d’adresses IP à l’état “Active” empêchent les connexions.

Création d’un bannissement depuis un serveur ou un service

En raison de leur large portée et de leur impact potentiellement important sur les joueurs, nous déconseillons de créer des bannissements d’adresses IP automatiquement ou par programmation.

Depuis un serveur ou un service de confiance, vous pouvez utiliser le SDK Services pour créer un bannissement d’adresse IP au moyen de l’API Admin. L’API Admin nécessite la clé secrète de développeur de votre titre et ne doit pas être appelée depuis un client de jeu.

public async Task CreateIPBanAsync(string ipAddress, DateTime expirationDate)
{
    var response = await PlayFabAdminAPI.CreateIPBanAsync(
        new CreateIPBanRequest
        {
            IPAddress = ipAddress,
            Expires = expirationDate.ToUniversalTime(),
            Reason = "Automatic IP ban"
        });

    if (response.Error != null)
    {
        Debug.LogError(response.Error.GenerateErrorReport());
        return;
    }

    // Handle response.Result.IPBanData
}

Les bannissements d’adresses IP appliqués au moyen de l’API s’affichent également dans le tableau des bannissements d’adresses IP du titre dans Game Manager.

​Identifier

​Application des bannissements

​Création d’un bannissement d’adresse IP depuis Game Manager

​Gestion des bannissements d’adresses IP depuis Game Manager

​Création d’un bannissement depuis un serveur ou un service

Identifier

Application des bannissements

Création d’un bannissement d’adresse IP depuis Game Manager

Gestion des bannissements d’adresses IP depuis Game Manager

Création d’un bannissement depuis un serveur ou un service