Autenticação de login anônimo no servidor

Este guia mostra como implementar a autenticação do PlayFab usando APIs de login anônimo com proteção no lado do servidor, com foco apenas na autenticação CustomID usando HTML5/JavaScript.

Visão geral

A partir de 30 de junho de 2025, todos os títulos recém-criados terão a criação de jogadores por meio de APIs anônimas desabilitada.

Para aprimorar a segurança do login anônimo, o PlayFab implementou um recurso de segurança crucial que separa os recursos de criação de jogadores entre as APIs do lado do cliente e do lado do servidor.

Criação de jogadores no lado do cliente desabilitada:
- Para títulos recém-criados, todas as APIs de login anônimo no lado do cliente (LoginWithCustomID, LoginWithAndroidDeviceID, LoginWithIOSDeviceID, LoginWithNintendoSwitchDeviceId) não criam mais novas contas de jogador automaticamente. Os títulos criados antes de 30 de junho de 2025 podem desabilitar o login anônimo por meio da configuração do Game Manager.
- Desabilitar a criação de jogadores no lado do cliente impede a criação não autorizada de contas diretamente a partir de clientes não autorizados.
- Somente jogadores existentes podem fazer login por meio das APIs do lado do cliente.
Criação de jogadores no lado do servidor habilitada:
- A criação de contas de jogador agora é feita por meio de APIs do lado do servidor (LoginWithCustomID, LoginWithAndroidDeviceID, LoginWithIOSDeviceID, LoginWithNintendoDeviceId).
- Isso garante que toda a criação de contas ocorra em um ambiente seguro e controlado.

Pré-requisitos

Um identificador exclusivo para o jogador (CustomID)
Um título registrado no PlayFab
A chave secreta do seu título do PlayFab
Familiaridade com as noções básicas e práticas recomendadas de entrada
Um servidor com um nome de domínio válido para servir arquivos HTML estáticos

Se precisar de ajuda para configurar um servidor, consulte o tutorial Executando um servidor HTTP para testes. Ao longo deste guia, presumiremos que seu domínio é http://playfab.example.

Fluxo de autenticação

Criação de contas no lado do servidor:
- Use Server/LoginWithCustomID com a API do servidor para criar novos jogadores
- Requer uma chave secreta do título
- Referência: API do servidor - Login With Custom ID
Login no lado do cliente:
- Use Client/LoginWithCustomID com a API do cliente para fazer o login de jogadores existentes
- Referência: API do cliente - Login With Custom ID

Etapas de implementação

1. Configurar seu ambiente de desenvolvimento

Baixe o SDK do JavaScript na documentação do SDK do JavaScript
Instale os pacotes do Node.js necessários:

npm install playfab-sdk

2. Implementação no lado do servidor (Node.js)

Mantenha a chave secreta do seu título em segurança e nunca a exponha no código do lado do cliente. A chave secreta só deve ser usada em ambientes de servidor seguros.

const { create } = require('domain');
const http = require('http');
const PlayFab = require('playfab-sdk');
const PlayFabServer = require('playfab-sdk/Scripts/PlayFab/PlayFabServer');

// Initialize PlayFab settings
PlayFab.settings.titleId = "YOUR_TITLE_ID"; // Replace with your actual PlayFab Title ID
PlayFab.settings.developerSecretKey = "YOUR_SECRET_KEY"; // Replace with your actual secret key

// Callback function for PlayFab API responses
function onPlayFabResponse(error, result) {
    if (error) {
        console.error("PlayFab Error:", error);
        return;
    }
    console.log("PlayFab Success:", result);
}

// Function to create user with custom ID
function createUserWithCustomId(customId, callback) {
    PlayFab.PlayFabServer.LoginWithCustomID({
        CreateAccount: true,
        CustomId: customId,
    }, (error, result) => {
        if (error) {
            console.error("PlayFab Error:", error);
            callback(error);
            return;
        }
        console.log("PlayFab Success:", result);
        callback(null, result.data);
    });
}

const customId = "YOUR_CUSTOM_ID"; // Replace with your actual custom ID
const server = http.createServer((req, res) => {
    res.writeHead(200, {'Content-Type': 'application/json'});
    createUserWithCustomId(customId, (error, result) => {
        if (error) {
            res.end(JSON.stringify({ error: error }));
            return;
        }
        res.end(JSON.stringify({ success: result }));
    });
});

const port = 3000;
server.listen(port, () => {
  console.log(`Server running at http://localhost:${port}/`);
});

3. Implementação no lado do cliente (HTML)

<!DOCTYPE html>
<html>
<head>
    <script src="PlayFabSdk/src/PlayFab/PlayFabClientApi.js"></script>
</head>
<body>
    <p>Server LoginWithCustomId Auth Example</p>
    <button onclick="loginWithCustomID()">Log In with CustomId</button>
    <script>
        function loginWithCustomID() {
            var customId = "YOUR_CUSTOM_ID";
            PlayFabClientSDK.LoginWithCustomID({
                CustomId: customId,
                TitleId: YOUR_TITLE_ID,
            }, onPlayFabResponse);
        }
       

        function onPlayFabResponse(response, error) {
            if (response)
                logLine("Response: " + JSON.stringify(response));
            if (error)
                logLine("Error: " + JSON.stringify(error));
        }

        function logLine(message) {
            var textnode = document.createTextNode(message);
            document.body.appendChild(textnode);
            var br = document.createElement("br");
            document.body.appendChild(br);
        }
    </script>
</body>
</html>

Definindo as configurações de criação de jogadores

Para títulos existentes

Navegue até o portal do desenvolvedor do PlayFab e selecione seu título
Vá para Settings.
Selecione a guia API Features.
Marque a caixa para impedir que novas contas de jogador sejam criadas por meio de APIs de login anônimo

Desabilitando a criação de jogadores usando Client/LoginWithCustomId

Para novos títulos

Habilitar a criação automática de jogadores para APIs de login anônimo pode comprometer a segurança. Habilite esse recurso apenas temporariamente durante o desenvolvimento ou os testes. Sempre o desabilite antes de passar para a produção.

Novos títulos têm a criação de jogadores por meio de APIs anônimas desabilitada por padrão. Para habilitá-la para testes, faça o seguinte:

Navegue até o portal do desenvolvedor do PlayFab e selecione seu título
Vá para Settings.
Selecione a guia API Features.
Desmarque a caixa para permitir que novas contas de jogador sejam criadas por meio de APIs de login anônimo

Habilitando a criação de jogadores usando Client/LoginWithCustomId

Exemplos de testes e respostas

Exemplo de resposta do servidor

Ao criar um usuário com êxito por meio da API do servidor, você recebe uma resposta semelhante a:

{
    "code": 200,
    "status": "OK",
    "data": {
        "PlayFabId": "PLAYFAB_ID",
        "SessionTicket": "SESSION_TICKET",
        "NewlyCreated": true
    }
}

Exemplo de resposta do cliente

Ao tentar criar uma nova conta a partir da API do cliente (que agora está desabilitada), você recebe um erro:

{
    "code": 400,
    "status": "BadRequest",
    "error": "PlayerCreationDisabled"
}

Ao fazer o login de um usuário existente com êxito por meio da API do cliente:

{
    "code": 200,
    "status": "OK",
    "data": {
        "PlayFabId": "PLAYFAB_ID",
        "SessionTicket": "SESSION_TICKET",
        "NewlyCreated": false
    }
}

XBOX Services

PlayFab

Visão geral

Pré-requisitos

Fluxo de autenticação

Etapas de implementação

1. Configurar seu ambiente de desenvolvimento

2. Implementação no lado do servidor (Node.js)

3. Implementação no lado do cliente (HTML)

Definindo as configurações de criação de jogadores

Para títulos existentes

Para novos títulos

Exemplos de testes e respostas

Exemplo de resposta do servidor

Exemplo de resposta do cliente

Leitura adicional

​Configurando a autenticação do PlayFab usando login anônimo

​Visão geral

​Pré-requisitos

​Fluxo de autenticação

​Etapas de implementação

​1. Configurar seu ambiente de desenvolvimento

​2. Implementação no lado do servidor (Node.js)

​3. Implementação no lado do cliente (HTML)

​Definindo as configurações de criação de jogadores

​Para títulos existentes

​Para novos títulos

​Exemplos de testes e respostas

​Exemplo de resposta do servidor

​Exemplo de resposta do cliente

​Leitura adicional

Configurando a autenticação do PlayFab usando login anônimo

Visão geral

Pré-requisitos

Fluxo de autenticação

Etapas de implementação

1. Configurar seu ambiente de desenvolvimento

2. Implementação no lado do servidor (Node.js)

3. Implementação no lado do cliente (HTML)

Definindo as configurações de criação de jogadores

Para títulos existentes

Para novos títulos

Exemplos de testes e respostas

Exemplo de resposta do servidor

Exemplo de resposta do cliente

Leitura adicional