Configuración de la autenticación de PlayFab mediante inicio de sesión anónimo

En esta guía se muestra cómo implementar la autenticación de PlayFab mediante las API de inicio de sesión anónimo con protección en el lado del servidor, centrándose únicamente en la autenticación con CustomID usando HTML5/JavaScript.

Información general

El 30 de junio de 2025, todos los títulos recién creados tendrán deshabilitada la creación de jugadores mediante las API anónimas.

Para mejorar la seguridad del inicio de sesión anónimo, PlayFab implementó una característica de seguridad crucial que separa las capacidades de creación de jugadores entre las API del lado del cliente y las del lado del servidor.

Creación de jugadores en el lado del cliente deshabilitada:
- Para los títulos recién creados, todas las API de inicio de sesión anónimo en el lado del cliente (LoginWithCustomID, LoginWithAndroidDeviceID, LoginWithIOSDeviceID, LoginWithNintendoSwitchDeviceId) ya no crean automáticamente nuevas cuentas de jugador. Los títulos creados antes del 30 de junio de 2025 pueden deshabilitar el inicio de sesión anónimo mediante la configuración de Game Manager.
- Deshabilitar la creación de jugadores en el lado del cliente evita la creación de cuentas no autorizada directamente desde clientes no autorizados.
- Solo los jugadores existentes pueden iniciar sesión mediante las API del lado del cliente.
Creación de jugadores en el lado del servidor habilitada:
- La creación de cuentas de jugador ahora se controla mediante las API del lado del servidor (LoginWithCustomID, LoginWithAndroidDeviceID, LoginWithIOSDeviceID, LoginWithNintendoDeviceId).
- Esto garantiza que toda la creación de cuentas se realice en un entorno seguro y controlado.

Requisitos previos

Un identificador único para el jugador (CustomID)
Un título registrado en PlayFab
La clave secreta de su título de PlayFab
Estar familiarizado con los conceptos básicos y las prácticas recomendadas de inicio de sesión
Un servidor con un nombre de dominio válido para servir archivos HTML estáticos

Si necesita ayuda para configurar un servidor, consulte el tutorial Ejecución de un servidor HTTP para pruebas. A lo largo de esta guía, supondremos que su dominio es http://playfab.example.

Flujo de autenticación

Creación de cuentas en el lado del servidor:
- Use Server/LoginWithCustomID con la API de servidor para crear nuevos jugadores
- Requiere una clave secreta del título
- Referencia: API de servidor - Login With Custom ID
Inicio de sesión en el lado del cliente:
- Use Client/LoginWithCustomID con la API de cliente para iniciar la sesión de jugadores existentes
- Referencia: API de cliente - Login With Custom ID

Pasos de implementación

1. Configure el entorno de desarrollo

Descargue el SDK de JavaScript desde la documentación del SDK de JavaScript
Instale los paquetes de Node.js necesarios:

npm install playfab-sdk

2. Implementación en el lado del servidor (Node.js)

Mantenga segura la clave secreta del título y nunca la exponga en el código del lado del cliente. La clave secreta solo debe usarse en entornos 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. Implementación en el lado del 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>

Configuración de las opciones de creación de jugadores

Para títulos existentes

Vaya al portal para desarrolladores de PlayFab y seleccione su título
Vaya a Settings.
Seleccione la pestaña API Features.
Active la casilla para evitar que se creen nuevas cuentas de jugador mediante las API de inicio de sesión anónimo

Para títulos nuevos

Habilitar la creación automática de jugadores para las API de inicio de sesión anónimo puede poner en peligro la seguridad. Habilite esta característica solo temporalmente durante el desarrollo o las pruebas. Deshabilítela siempre antes de pasar a producción.

Los títulos nuevos tienen deshabilitada de forma predeterminada la creación de jugadores mediante las API anónimas. Para habilitarla con fines de prueba, haga lo siguiente:

Vaya al portal para desarrolladores de PlayFab y seleccione su título
Vaya a Settings.
Seleccione la pestaña API Features.
Desactive la casilla para permitir que se creen nuevas cuentas de jugador mediante las API de inicio de sesión anónimo

Ejemplos de pruebas y respuestas

Ejemplo de respuesta del servidor

Cuando se crea correctamente un usuario mediante la API de servidor, se recibe una respuesta similar a la siguiente:

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

Ejemplo de respuesta del cliente

Al intentar crear una nueva cuenta desde la API de cliente (que ahora está deshabilitada), se recibe un error:

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

Cuando se inicia correctamente la sesión de un usuario existente mediante la API de cliente:

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

XBOX Services

PlayFab

Autenticación de inicio de sesión anónimo de servidor

Configuración de la autenticación de PlayFab mediante inicio de sesión anónimo

Información general

Requisitos previos

Flujo de autenticación

Pasos de implementación

1. Configure el entorno de desarrollo

2. Implementación en el lado del servidor (Node.js)

3. Implementación en el lado del cliente (HTML)

Configuración de las opciones de creación de jugadores

Para títulos existentes

Para títulos nuevos

Ejemplos de pruebas y respuestas

Ejemplo de respuesta del servidor

Ejemplo de respuesta del cliente

Lecturas adicionales

​Configuración de la autenticación de PlayFab mediante inicio de sesión anónimo

​Información general

​Requisitos previos

​Flujo de autenticación

​Pasos de implementación

​1. Configure el entorno de desarrollo

​2. Implementación en el lado del servidor (Node.js)

​3. Implementación en el lado del cliente (HTML)

​Configuración de las opciones de creación de jugadores

​Para títulos existentes

​Para títulos nuevos

​Ejemplos de pruebas y respuestas

​Ejemplo de respuesta del servidor

​Ejemplo de respuesta del cliente

​Lecturas adicionales

Configuración de la autenticación de PlayFab mediante inicio de sesión anónimo

Información general

Requisitos previos

Flujo de autenticación

Pasos de implementación

1. Configure el entorno de desarrollo

2. Implementación en el lado del servidor (Node.js)

3. Implementación en el lado del cliente (HTML)

Configuración de las opciones de creación de jugadores

Para títulos existentes

Para títulos nuevos

Ejemplos de pruebas y respuestas

Ejemplo de respuesta del servidor

Ejemplo de respuesta del cliente

Lecturas adicionales