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

# IP バン システム

> PlayFab API および Game Manager を通じて公開される IP バン システムの使用方法を示します。

IP バン機能を使用すると、指定された IP アドレスまたは範囲からのゲームへのアクセスを制限できます。IP バンが適用されると、その IP アドレスまたは禁止された範囲内から行われる将来の認証試行は拒否されます。IP バンは永続的にも、有効期限を指定して一時的にもでき、単一の IP アドレスまたは CIDR 表記で表された IP 範囲に適用できます。IP バンはタイトル単位でスコープされ、[名前空間](/services/playfab/live-service-management/game-configuration/entities) 内の他のタイトルには適用されません。

以下のチュートリアルでは、PlayFab API および Game Manager を使用して IP バン システムを使用する方法を示します。

## 特定

PlayStream Monitor を通じて、バンする IP アドレスを特定できます。疑わしいログイン アクティビティに気付いた場合、**Player logged in** イベントを見つけて、**JSON** 列の中括弧を選択し、詳細を表示します。**"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 - IP Bans - Suspicious Login Event" width="1370" height="673" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-suspicious-login-event.png" />

<Note>
  タイトルの **\[Settings > Data Collection]** で "Store full user IP addresses" が無効になっている場合、IP アドレスの最後のオクテットは難読化されます。
</Note>

## バンの適用

必要と判断した場合、IP バンを作成できます。バンを作成する方法は 2 つあります: Game Manager を通じて手動で行う方法と、[Services SDK](/services/playfab/sdks/playfab-sdk-intro) を通じてプログラム的に行う方法です。

<Note>
  1 つのタイトルで最大 200 個の IP アドレスまたは範囲に対して IP バンを作成できます。
</Note>

### Game Manager から IP バンを作成する

コミュニティ マネージャーは Game Manager を使用してバンを適用したい場合があります。

1. IP Bans セクションに移動します。
2. **\[New IP Ban]** を選択して **\[New IP Ban]** フォームを表示します。
3. バンする IP アドレスを貼り付けるか、バンする CIDR 範囲を入力します。
4. 永続的なバンには **\[Permanent]** を選択するか、バンの有効期限日時を選択します。
5. 必要に応じて、バンの理由を入力します。
6. 最後に、**\[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 - IP Bans - New IP Ban" width="1372" height="685" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-new-ip-ban.png" />

すべてが正しく設定されている場合、テーブルに **"Active"** ステータスの新しい IP バンが表示されます。

<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 - IP Bans - Table" width="1376" height="701" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-table.png" />

### Game Manager からの IP バンの管理

IP バンを選択して **\[Disable selected bans]** を選択することで、IP バンを手動で無効にできます。ステータスは **"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 - IP Bans - Disable" width="1369" height="827" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-disable.png" />

テーブル内の IP アドレス フィールドを選択することで、バンを編集できます。これにより **\[Edit IP Ban]** フォームが表示されます。ここでは、バンの無効化 (または再有効化) や、有効期限および理由の変更ができます。**\[Save]** を選択して変更を保存します。

<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 - IP Bans - Edit" width="1366" height="692" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-edit.png" />

バンの有効期限が過ぎると、そのステータスは **"Expired"** になります。バンを再アクティブ化するには、新しい有効期限を定義する必要があります。**"Active"** ステータスの IP バンのみがログインを防止します。

### サーバーまたはサービスからバンを作成する

<Warning>
  影響範囲が広く、プレイヤーへの潜在的な影響も大きいため、IP バンを自動的またはプログラム的に作成することは推奨しません。
</Warning>

信頼されたサーバーまたはサービスから、[Services SDK](/services/playfab/sdks/playfab-sdk-intro) を使用して、Admin API を通じて IP バンを作成できます。Admin API はタイトルの開発者シークレット キーを必要とし、ゲーム クライアントから呼び出してはなりません。

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

API を通じて適用された IP バンも、Game Manager のタイトルの IP バン テーブルに表示されます。


## Related topics

- [プレイヤー禁止 (Ban) システム](/ja-jp/services/playfab/player-progression/player-data/player-bans.md)
- [GDK コマース システムの概要](/ja-jp/publishing/xstore-commerce/xstore-overview.md)
- [ピープル システム](/ja-jp/services/xbox-services/community/people-system/index.md)
- [システム API リファレンス](/ja-jp/reference/system/gc-reference-system-toc.md)
- [消費型ベースのエコシステム](/ja-jp/publishing/xstore-commerce/xstore-consumables.md)