> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Système de bannissement d'adresses IP

> Bloquez les connexions PlayFab suspectes en créant des bannissements d'adresses IP uniques ou de plages CIDR depuis Game Manager ou le SDK Services, avec une expiration permanente ou temporaire.

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](/fr-CA/services/playfab/live-service-management/game-configuration/entities).

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"**.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-suspicious-login-event.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=8cc7a5e0fd83557e26642cf5c762c03b" alt="Game Manager - Bannissements d'adresses IP - Événement de connexion suspect" width="1370" height="673" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-suspicious-login-event.png" />

<Note>
  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é.
</Note>

## 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](/fr-CA/services/playfab/sdks/playfab-sdk-intro).

<Note>
  Un titre peut créer des bannissements pour 200 adresses ou plages d'adresses IP au maximum.
</Note>

### 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.

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

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-new-ip-ban.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=42567eb75f0d8ea839a865fc3bac832c" alt="Game Manager - Bannissements d'adresses IP - Nouveau bannissement" width="1372" height="685" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-new-ip-ban.png" />

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

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-table.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=21604260c8ec2c76cc13ecc5ab558000" alt="Game Manager - Bannissements d'adresses IP - Tableau" width="1376" height="701" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-table.png" />

### 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"**.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-disable.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=c7fbdc60e6a109011eff1684882b474c" alt="Game Manager - Bannissements d'adresses IP - Désactiver" width="1369" height="827" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-disable.png" />

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.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-edit.png?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=c8fa5ea054f8f74b7cddf3297bf714f8" alt="Game Manager - Bannissements d'adresses IP - Modifier" width="1366" height="692" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-edit.png" />

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

<Warning>
  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.
</Warning>

Depuis un serveur ou un service de confiance, vous pouvez utiliser le [SDK Services](/fr-CA/services/playfab/sdks/playfab-sdk-intro) 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.

```csharp theme={null}
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.


## Related topics

- [Système de bannissement des joueurs](/fr-CA/services/playfab/player-progression/player-data/player-bans.md)
- [Révoquer un bannissement d'adresse IP](/fr-CA/services/playfab/api-references/rest/admin/account-management/revoke-ip-ban.md)
- [Créer un bannissement d'adresse IP](/fr-CA/services/playfab/api-references/rest/admin/account-management/create-ip-ban.md)
- [Obtenir les bannissements d'adresse IP pour une adresse IP](/fr-CA/services/playfab/api-references/rest/admin/account-management/get-ip-bans-for-ip.md)
- [Mettre à jour un bannissement d'adresse IP](/fr-CA/services/playfab/api-references/rest/admin/account-management/update-ip-ban.md)