IP 封禁系统 - XBOX Game Development Documentation

IP 封禁功能允许你限制来自指定 IP 地址或范围的游戏访问。当应用 IP 封禁时,未来从该 IP 地址或在封禁范围内进行的身份验证尝试将被拒绝。IP 封禁可以是永久的,也可以是具有指定过期日期的临时封禁,并且可以应用于单个 IP 地址或以 CIDR 表示法表达的 IP 范围。IP 封禁的范围限定于某个游戏,不适用于你的命名空间中的任何其他游戏。以下教程向你展示如何使用 PlayFab API 和 Game Manager 来使用 IP 封禁系统。

识别

你可以通过 PlayStream Monitor 识别要封禁的 IP 地址。如果你注意到可疑的登录活动,请找到 Player logged in 事件,然后选择 JSON 列中的花括号以查看其详细信息。从 “IPV4Address” 字段复制地址。

如果你的游戏在设置 > 数据收集中禁用了”存储完整的用户 IP 地址”,则 IP 地址的最后一个八位字节将被混淆。

应用封禁

如果你认为有必要,可以创建 IP 封禁。有两种创建封禁的方式:通过 Game Manager 手动创建,或通过 Services SDK 以编程方式创建。

一个游戏最多可为 200 个 IP 地址或范围创建 IP 封禁。

从 Game Manager 创建 IP 封禁

你的社区经理可能希望使用 Game Manager 应用封禁。

导航至 IP 封禁部分。
选择 New IP Ban 以显示 New IP Ban 表单。
粘贴你希望封禁的 IP 地址,或键入你希望封禁的 CIDR 范围。
选择 Permanent 进行永久封禁,或为你的封禁选择过期日期和时间。
(可选)键入封禁原因。
最后,选择 ADD BAN 按钮。

如果所有设置都正确,你将在表中看到一个状态为 “Active” 的新 IP 封禁。

从 Game Manager 管理 IP 封禁

你可以通过选择 IP 封禁然后选择 Disable selected bans 来手动禁用它们。它们的状态将更改为 “Disabled”。

你可以通过选择表中的 IP 地址字段来编辑封禁。这会将你带到 Edit IP Ban 表单。在这里,你可以禁用(或重新启用)封禁,以及修改过期日期和原因。选择 Save 保存你的更改。

当封禁的过期日期过后,其状态变为 “Expired”。若要重新激活该封禁,你必须定义一个新的过期日期。只有状态为 “Active” 的 IP 封禁才能阻止登录。

从服务器或服务创建封禁

由于 IP 封禁的广泛影响以及对玩家的潜在高影响,我们建议不要自动或以编程方式创建 IP 封禁。

从受信任的服务器或服务,你可以使用 Services SDK 通过 Admin API 创建 IP 封禁。Admin API 需要你的游戏的开发者密钥,并且不得从游戏客户端调用。

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 封禁表中。

​识别

​应用封禁

​从 Game Manager 创建 IP 封禁

​从 Game Manager 管理 IP 封禁

​从服务器或服务创建封禁

识别

应用封禁

从 Game Manager 创建 IP 封禁

从 Game Manager 管理 IP 封禁

从服务器或服务创建封禁