OpenId Connect 연결

Links an OpenID Connect account to a user’s PlayFab account, based on an existing relationship between a title and an Open ID Connect provider and the OpenId Connect JWT from that provider.

Error codes

This operation may return the following PlayFab errors:

Error	Code
AccountLinkedToABannedPlayer	1613
InvalidIdentityProviderId	1263
LinkedIdentifierAlreadyClaimed	1184

POST

Client

LinkOpenIdConnect

Link Open Id Connect

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "ConnectionId": "exampleprovider",
  "IdToken": "eyJraWQi..."
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect"

payload = {
    "ConnectionId": "exampleprovider",
    "IdToken": "eyJraWQi..."
}
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ConnectionId: 'exampleprovider', IdToken: 'eyJraWQi...'})
};

fetch('https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ConnectionId' => 'exampleprovider',
    'IdToken' => 'eyJraWQi...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect"

	payload := strings.NewReader("{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "status": "<string>",
  "data": {}
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

인증

X-Authorization

string

header

필수

This API requires a client session ticket, available from any Client Login function.

본문

application/json

ConnectionId

string

필수

A name that identifies which configured OpenID Connect provider relationship to use. Maximum 100 characters.

IdToken

string

필수

The JSON Web token (JWT) returned by the identity provider after login. Represented as the id_token field in the identity provider's response. Used to validate the request and find the user ID (OpenID Connect subject) to link with.

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ForceLink

boolean

If another user is already linked to a specific OpenId Connect user, unlink the other user and re-link.

응답

code

integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status

string

The Http status code as a string.

data

object

마지막 수정일 2026년 10월 6일

⌘I

Link Open Id Connect

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "ConnectionId": "exampleprovider",
  "IdToken": "eyJraWQi..."
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect"

payload = {
    "ConnectionId": "exampleprovider",
    "IdToken": "eyJraWQi..."
}
headers = {
    "X-Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ConnectionId: 'exampleprovider', IdToken: 'eyJraWQi...'})
};

fetch('https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ConnectionId' => 'exampleprovider',
    'IdToken' => 'eyJraWQi...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect"

	payload := strings.NewReader("{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/LinkOpenIdConnect")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ConnectionId\": \"exampleprovider\",\n  \"IdToken\": \"eyJraWQi...\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "status": "<string>",
  "data": {}
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

PlayFab API

PlayFab REST API References

OpenId Connect 연결

Error codes

인증

본문

응답