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” 欄位複製位址。

如果您的遊戲在 Settings > Data Collection 中停用了 “Store full user IP addresses”，IP 位址的最後一個八位元會被模糊處理。

套用禁止

如果您認為有必要，可以建立 IP 禁止。有兩種方式可以建立禁止：透過 Game Manager 手動建立，或透過 Services SDK 以程式設計方式建立。

一個遊戲最多可以為 200 個 IP 位址或範圍建立 IP 禁止。

從 Game Manager 建立 IP 禁止

您的社群管理員可能想要使用 Game Manager 套用禁止。

瀏覽至 IP Bans 區段。
選取 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 禁止

從伺服器或服務建立禁止