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

# Servicios de cifrado de jugador

> Obtenga información sobre los secretos compartidos de jugador de PlayFab, las claves públicas de título y las cargas de registro cifradas con RSA que se usan para proteger la creación de cuentas y las solicitudes de inicio de sesión del cliente.

## Secretos compartidos de jugador

Los secretos compartidos de jugador son un nuevo tipo de clave pseudosecreta que se comparte entre los clientes del juego. Mediante una API, se puede intercambiar por la clave RSA pública del título y se puede usar para realizar el registro de cuentas.

Los títulos pueden tener varias claves compartidas de jugador, y pueden configurarlas y revocarlas a voluntad mediante las llamadas a la API de administración [Create](xref:titleid.playfabapi.com.admin.authentication.createplayersharedsecret), [Update](xref:titleid.playfabapi.com.admin.authentication.updateplayersharedsecret), [Delete](xref:titleid.playfabapi.com.admin.authentication.deleteplayersharedsecret) y [List](xref:titleid.playfabapi.com.admin.authentication.getplayersharedsecrets).

Los secretos compartidos de jugador deben integrarse en los clientes respectivos, ya que no hay ninguna API de cliente para recuperarlos, ni autenticada ni de ningún otro tipo.

## Clave pública del título

A continuación, el secreto compartido de jugador se envía a [GetTitlePublicKey](xref:titleid.playfabapi.com.client.authentication.gettitlepublickey). Si la clave es válida, la API devuelve una matriz de bytes de blob CSP RSA codificada en Base 64 que puede cifrar 237 bytes de datos.

Todas las API que permiten crear cuentas ahora aceptan la publicación de una solicitud de registro como carga cifrada en el campo `EncryptedRequest`.

<Note>
  Los campos estándar **`TitleId`**, **`InfoRequestParameters`** y **`CreateAccount`** *no* deben incluirse en la carga cifrada.
</Note>

## Uso de la clave pública del título para registrarse

Este es un ejemplo de código para registrar un jugador con `LoginWithCustomID` y la clave pública del título.

```csharp theme={null}
var titleKeyResult = PlayFabClientAPI.GetTitlePublicKey(new GetTitlePublicKeyRequest{ TitleId = "TITLE", TitleSharedSecret = "player shared secret" });

var cspBlob = Convert.FromBase64String(titleKeyResult.RSAPublicKey);

var encryptionModel = JsonConvert.SearializeObject(new LoginWithCustomIDRequest

{
    CustomID = "my player's custom id",
    PlayerSecret = "my player's individual secret"
});

string encryptedPayload;

using (var rsa = new RSACryptoServiceProvider())
{
    rsa.ImportCspBlob(cspBlob);
    var bytesToEncrypt = Encoding.UTF8.GetBytes(encryptionModel);
    var encryptedBytes = rsa.Encrypt(bytesToEncrypt, false);
    encryptedPayload = Convert.ToBase64String(encryptedBytes);
}

var postModel = new LoginWithCustomIDRequest
{
    TitleId = "TITLEID",
    EncryptedRequest = encryptedPayload,
    CreateAccount = True
};

var createAccountResult = PlayFabClientAPI.LoginWithCustomID(postModel);
```

## Secreto de jugador

Una parte del nuevo sistema de registro es un nuevo campo denominado `PlayerSecret`. Si se establece, le permite firmar los encabezados de las solicitudes, que el servidor valida durante las llamadas a la API de todos los servicios, incluidas las solicitudes de inicio de sesión.

El secreto de jugador solo se puede establecer *una vez* por usuario y por título. Un usuario con varios títulos en el mismo estudio debe establecer el secreto de jugador para cada uno de ellos.

Si el secreto de jugador aún no se ha establecido durante el registro, es posible establecerlo llamando a [SetPlayerSecret](xref:titleid.playfabapi.com.client.authentication.setplayersecret). Hay API de administración y de servidor que permiten establecer el secreto de jugador en un *nuevo* valor incluso si ya se había establecido anteriormente.

<Note>
  Una vez establecido, el secreto de jugador debe almacenarse de forma segura en el dispositivo, ya que *no* se puede recuperar si se pierde y *no* existe ninguna API para recuperarlo.
</Note>

## Uso del secreto de jugador para firmar solicitudes de API

En el siguiente ejemplo de código se construye un encabezado de firma que se puede usar para firmar solicitudes de API. El formato del encabezado de firma se muestra a continuación.

`jsonRequestModel.utcTimeStampInISO.playerSecret`

```csharp theme={null}
var postModel = new LoginWithCustomIDRequest

{
    TitleId = "TITLEID",
    CustomID =  "my player's custom id",
    CreateAccount = False
};

string signatureHeader;
string timestampHeader = DateTime.UtcNow.ToString("O");

string playerSecret; // the player secret that was sent during registration.

 using (var hash = new SHA256Managed())
{
    var bytesToHash = Encoding.UTF8.GetBytes(JsonConvert.SerializeObject(postModel)+"." + timestampHeader + "." + playerSecret);
    signatureHeader = hash.ComputeHash(bytesToHash);
}

var customHeaders = new Dictionary<string, string>
{
    { "X-PlayFab-Signature", signatureHeader },
    { "X-PlayFab-Timestamp", timestampHeader }
}

var loginResult = PLayFabClientAPI.LoginWithCustomID(postModel, customHeaders);
```

## Uso de una aplicación de directivas

Las [directivas de API](https://playfab.com/blog/permission-policies/) ahora se pueden usar para aplicar estos escenarios.

* Una solicitud de cliente es una carga cifrada.
* Una solicitud de cliente contiene encabezados firmados.

Incluso *sin* usar la aplicación de directivas, si se envía una carga cifrada (o se envían los encabezados), se validarán. Si no tienen el formato correcto, se produce un error.

Para crear una directiva que exija encabezados en una API específica, use una instrucción `Deny`. Esto crea una directiva que exige encabezados en *todas* las llamadas que pueda realizar y que no estén permitidas por la instrucción `Allow`.

Las instrucciones de directiva tienen una propiedad denominada `ApiConditions`. `ApiConditions` contiene una propiedad denominada `HasSignatureOrEncryption`, que es una enumeración con tres valores posibles:

* `Any`
* `True`
* `False`

<Note>
  El valor predeterminado (si *no* lo establece la directiva) es **`Any`**.
</Note>

La siguiente directiva de ejemplo permite *todas* las llamadas a la API (excepto las llamadas sin cifrar o sin encabezados) a `LoginWithCustomID`.

```json theme={null}
{
    "PolicyName": "ApiPolicy",
    "OverwritePolicy": true,
    "Statements":
    [
        {
            "Comment": "Require Headers on LoginWithCustomID",
            "Action": "*",
            "Principal": "*",
            "Effect": "Deny",
            "Resource": "pfrn:api--/Client/LoginWithCustomID",
            "ApiConditions": { "HasSignatureOrEncryption": "False" }
        },
        {
            "Comment": "Allow the rest policy",
            "Action": "*",
            "Principal": "*",
            "Effect": "Allow",
            "Resource": "pfrn:api--*"
        }
    ]
}
```

La instrucción `Deny` anterior contiene `HasSignatureOrEncryption: False`. Esto significa que se rechazan todas las solicitudes que no tienen firma ni cifrado. En otras palabras, todas las solicitudes que *tienen* encabezados de firma o cifrado se permiten en función de la directiva `Allow the rest policy`.


## Related topics

- [Autenticación de los servicios de XBOX para servicios de título](/es/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/live-title-service-authentication.md)
- [Inicios de sesión cifrados](/es/services/playfab/identity/player-identity/encryption/encrypted-logins.md)
- [Modelo de cifrado de MSIXVC2](/es/build/core-features/common/packaging/packaging-encryption-msixvc2.md)
- [Gestión en el servidor de los privilegios de usuario de los servicios XBOX](/es/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-server.md)
- [Configuración de servicios web en Partner Center](/es/services/xbox-services/fundamentals/s2s-auth-calls/custom-service-config/web-services/live-web-services.md)