> ## 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 차단을 만들 수 있습니다. 차단을 만드는 방법에는 두 가지가 있습니다. Game Manager를 통해 수동으로 만들거나 [Services SDK](/services/playfab/sdks/playfab-sdk-intro)를 통해 프로그래밍 방식으로 만들 수 있습니다.

<Note>
  하나의 타이틀은 최대 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**를 선택하여 수동으로 비활성화할 수 있습니다. 상태가 **"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 차단은 광범위한 특성상 플레이어에게 큰 영향을 미칠 수 있으므로, 자동으로 또는 프로그래밍 방식으로 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

- [플레이어 차단 시스템](/ko/services/playfab/player-progression/player-data/player-bans.md)
- [People 시스템(친구 목록) 개요](/ko/services/xbox-services/community/people-system/live-people-system-overview.md)
- [FMA: XR-045 XBOX Network 및 계정 권한](/ko/publishing/certification/fma/xr-045.md)
- [XtfConsoleFieldId Enumeration](/ko/reference/tools/xtf/xtfapi/enums/xtfconsolefieldid-xbox-windows-t.md)
- [시스템 API 참조](/ko/reference/system/gc-reference-system-toc.md)