Stille Authentifizierung

Stille AuthentifizierungClient-side

get/social/{cross_social_provider_name}/cross_auth

Tauscht den Benutzer-JWT von Steam, Xbox oder Epic Games gegen den JWT in Ihrem Projekt (projectId).

Sie erhalten den Link, der den Benutzer zu Ihrem Projekt weiterleitet.

In dieser Anleitung ist beschrieben, wie Sie die stille Authentifizierung aktivieren.

Request

path Parameters

cross_social_provider_name

required

string

Name der Plattform, auf der der Benutzer autorisiert ist. Möglich sind steam, xbox, epicgames.

query Parameters

projectId required	string <uuid> Login-Projekt-ID aus dem Kundenportal.
login_url	string URL to redirect the user to after account confirmation, successful authentication, two-factor authentication configuration, or password reset confirmation. Must be identical to the Callback URL specified in the URL block of Publisher Account. For the scenario of a login error, the value should be identical to the the Error callback URL specified in the URL block of Publisher Account. To find the settings, go to Login > your Login project and select the Callback URLs section in the upper block. Required if there are several Callback URLs.
fields	Array of strings non-empty Liste der Parameter, die vom Benutzer oder sozialen Netzwerk zusätzlich abgefragt und in den JWT geschrieben werden müssen. Die Parameter müssen durch ein Komma getrennt sein. Zum Beispiel: `email`. Wird die `email` abgefragt und das soziale Netzwerk antwortet nicht mit dem Wert `email`: wird – sofern Sie das Login-Widget integriert haben – der Benutzer gebeten, seine E-Mail-Adresse in die entsprechende Maske einzugeben; muss – sofern Sie die Login API integriert haben – der Benutzer gebeten werden, seine E-Mail-Adresse in die entsprechende Maske auf Ihrer eigenen Benutzeroberfläche einzugeben. Bitte senden Sie die URL dieser Eingabemaske an Ihren Customer Success Manager. Nach Eingabe der E-Mail-Adresse erhält der Benutzer eine Nachricht, um die E-Mail-Adresse zu bestätigen. Wenden Sie sich bitte an Ihren Customer Success Manager, wenn Sie die Bestätigung der E-Mail-Adresse deaktivieren möchten.
session_ticket	string Session ticket received from the platform encoded according to the Base64 standard.
payload	string Your custom data. The value of the parameter will be returned in the `payload` claim of the user JWT. Recommended maximum length less than 500 characters. Note, that this parameter is only available if you use a custom user data storage.
with_logout	string Default: "0" Zeigt an, ob die vorhandenen Benutzer-JWT-Werte deaktiviert und stattdessen der durch diesen Aufruf generierte Wert aktiviert werden sollen. Folgende Werte sind möglich: `1`, um die vorhandenen Werte zu deaktivieren und einen neuen Wert zu aktivieren, `0`, damit die vorhandenen Werte aktiviert bleiben.
app_id	string Your app ID on the platform. Required if the platform where the user is authorized is Steam.
code	string Von der Plattform erhaltener Code.
is_redirect	boolean Default: true Legt fest, wie der Xsolla-Login-Server reagiert. Wenn: `true` eingestellt ist, antwortet der Xsolla-Login-Server mit dem Statuscode 302. Die URL für die Benutzerweiterleitung per Benutzer-JWT befindet sich im `Location`-Header. `false` eingestellt ist, antwortet der Xsolla-Login-Server mit dem Statuscode 200. Die URL für die Benutzerweiterleitung per Benutzer-JWT befindet sich im Antwortrumpf.
no_user_creation	boolean Default: false Do not create new user if they not exist yet. Existing users will be authorized as usual
deployment_id	string The deployment ID that the client is trying to authenticate with. This will impact interactions with other services that require a deployment. If the deployment is not public, only users who have been entitled will be able to log in. For more information on deployments and deployment IDs see Product, Sandbox, and Deployment IDs. Note: You must use this unique identifier to use the Ecommerce APIs, and to request access tokens used by game clients.

Responses

200

302

Redirection

400

Bad Request

404

Not Found

422

Unprocessable Entity

429

Too Many Requests

Request samples

curl --request GET \
  --url 'https://login.xsolla.com/api/social/{cross_social_provider_name}/cross_auth?projectId=SOME_STRING_VALUE&login_url=SOME_STRING_VALUE&fields=SOME_ARRAY_VALUE&session_ticket=SOME_STRING_VALUE&payload=SOME_STRING_VALUE&with_logout=0&app_id=SOME_STRING_VALUE&code=SOME_STRING_VALUE&is_redirect=true&no_user_creation=false&deployment_id=SOME_STRING_VALUE'

Response samples

application/json

{"login_url": "string"
}