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

# Sistema de banimento de IP

> Bloqueie logins suspeitos no PlayFab criando banimentos de IP de endereço único ou de intervalo CIDR no Game Manager ou no Services SDK, com expiração permanente ou temporizada.

O recurso de banimento de IP permite restringir o acesso ao jogo a partir de endereços ou intervalos IP especificados. Quando um banimento de IP é aplicado, as tentativas futuras de autenticação feitas a partir desse endereço IP ou dentro do intervalo banido serão rejeitadas. Os banimentos de IP podem ser permanentes ou temporários, com uma data de expiração especificada, e podem ser aplicados a um único endereço IP ou a um intervalo IP expresso em notação CIDR. Um banimento de IP tem escopo para um título e não se aplica a nenhum outro título do seu [namespace](/pt-BR/services/playfab/live-service-management/game-configuration/entities).

O tutorial a seguir mostra como usar o sistema de banimento de IP, usando a API do PlayFab e o Game Manager.

## Identificar

Você pode identificar um endereço IP a ser banido por meio do PlayStream Monitor. Se notar uma atividade de login suspeita, encontre um evento **Player logged in** e selecione as chaves na coluna **JSON** para ver os detalhes. Copie o endereço do campo **"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 - Banimentos de IP - Evento de login suspeito" width="1370" height="673" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-suspicious-login-event.png" />

<Note>
  Se "Store full user IP addresses" em **Settings > Data Collection** estiver desabilitado para o seu título, o último octeto do endereço IP será ofuscado.
</Note>

## Aplicando banimentos

Se considerar necessário, você poderá criar um banimento de IP. Há duas maneiras de criar banimentos: manualmente pelo Game Manager ou programaticamente pelo [Services SDK](/pt-BR/services/playfab/sdks/playfab-sdk-intro).

<Note>
  Um título pode criar banimentos de IP para até 200 endereços ou intervalos IP.
</Note>

### Criando um banimento de IP no Game Manager

Seu gerente de comunidade pode querer aplicar um banimento usando o Game Manager.

1. Navegue até a seção IP Bans.
2. Selecione **New IP Ban** para exibir o formulário **New IP Ban**.
3. Cole o endereço IP que deseja banir ou digite o intervalo CIDR que deseja banir.
4. Selecione **Permanent** para um banimento permanente ou selecione uma data e hora de expiração para o banimento.
5. Opcionalmente, digite o motivo do banimento.
6. Por fim, selecione o botão **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 - Banimentos de IP - Novo banimento de IP" width="1372" height="685" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-new-ip-ban.png" />

Se tudo estiver configurado corretamente, você verá um novo banimento de IP na tabela com o status **"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 - Banimentos de IP - Tabela" width="1376" height="701" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-table.png" />

### Gerenciando banimentos de IP no Game Manager

Você pode desabilitar manualmente os banimentos de IP selecionando-os e, em seguida, selecionando **Disable selected bans**. O status deles muda para **"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 - Banimentos de IP - Desabilitar" width="1369" height="827" data-path="images/playfab/player-progression/player-data/tutorials/game-manager-ipbans-disable.png" />

Você pode editar um banimento selecionando o campo de endereço IP na tabela. Isso leva você ao formulário **Edit IP Ban**. Nele, você pode desabilitar (ou reabilitar) banimentos, bem como modificar a data de expiração e o motivo. Selecione **Save** para salvar as alterações.

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

Quando a data de expiração de um banimento passa, seu status se torna **"Expired"**. Para reativar o banimento, você deve definir uma nova data de expiração. Somente os banimentos de IP com o status **"Active"** impedem logins.

### Criando um banimento a partir de um servidor ou serviço

<Warning>
  Devido à sua natureza abrangente e ao possível alto impacto nos jogadores, desaconselhamos a criação automática ou programática de banimentos de IP.
</Warning>

A partir de um servidor ou serviço confiável, você pode usar o [Services SDK](/pt-BR/services/playfab/sdks/playfab-sdk-intro) para criar um banimento de IP por meio da API de administrador. A API de administrador exige a chave secreta de desenvolvedor do seu título e não deve ser chamada a partir de um cliente do jogo.

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

Os banimentos de IP aplicados por meio da API também são exibidos na tabela de banimentos de IP do título no Game Manager.


## Related topics

- [Sistema de banimento de jogadores](/pt-BR/services/playfab/player-progression/player-data/player-bans.md)
- [Revogar banimento de IP](/pt-BR/services/playfab/api-references/rest/admin/account-management/revoke-ip-ban.md)
- [Atualizar banimento de IP](/pt-BR/services/playfab/api-references/rest/admin/account-management/update-ip-ban.md)
- [Criar banimento de IP](/pt-BR/services/playfab/api-references/rest/admin/account-management/create-ip-ban.md)
- [Obter banimentos de IP para o IP](/pt-BR/services/playfab/api-references/rest/admin/account-management/get-ip-bans-for-ip.md)