Sistema de banimento de IP - XBOX Game Development Documentation

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

Game Manager - Banimentos de IP - Evento de login suspeito

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.

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.

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

Criando um banimento de IP no Game Manager

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

Navegue até a seção IP Bans.
Selecione New IP Ban para exibir o formulário New IP Ban.
Cole o endereço IP que deseja banir ou digite o intervalo CIDR que deseja banir.
Selecione Permanent para um banimento permanente ou selecione uma data e hora de expiração para o banimento.
Opcionalmente, digite o motivo do banimento.
Por fim, selecione o botão ADD BAN.

Game Manager - Banimentos de IP - Novo banimento de IP

Se tudo estiver configurado corretamente, você verá um novo banimento de IP na tabela com o status “Active”.

Game Manager - Banimentos de IP - Tabela

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

Game Manager - Banimentos de IP - Desabilitar

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.

Game Manager - Banimentos de IP - Editar

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

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.

A partir de um servidor ou serviço confiável, você pode usar o Services SDK 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.

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.

​Identificar

​Aplicando banimentos

​Criando um banimento de IP no Game Manager

​Gerenciando banimentos de IP no Game Manager

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

Identificar

Aplicando banimentos

Criando um banimento de IP no Game Manager

Gerenciando banimentos de IP no Game Manager

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