JSON에서 사용자 프로필 키 이름 맵으로

작동 방식

엑솔라 로그인 웹훅에 대한 응답으로 반환하는 JSON 개체의 필드를 엑솔라 시스템의 다음 사용자 프로필 속성에 매핑할 수 있습니다.

  • 생년월일(birthday)
  • 닉네임(nickname)
  • 이름(first_name)
  • 성(last_name)
  • 성별(gender)
  • 서버의 사용자 ID(server_custom_id)

알림
키 매핑은 다음 엑솔라 로그인 웹훅에만 사용할 수 있습니다.
키 이름 매핑을 사용할 수 있습니다.키 이름 맵에서 server_custom_id 속성에 대한 키를 지정하면 server_custom_id 계정 병합을 활성화할 수 있습니다. 이렇게 하면 시스템에서 동일한 server_custom_id를 가진 모든 계정을 동일한 사용자가 소유한 것으로 식별할 수 있습니다.

사용자

사용자 정의 사용자 데이터 스토리지를 사용하고 엑솔라 로그인에서 이 스토리지의 데이터를 사용하려는파트너.

획득 방법

  1. 관리자 페이지의 프로젝트에서 로그인 섹션으로 이동 합니다.
  2. 로그인 옵션을 선택하고 사용자 데이터베이스 섹션으로 이동합니다.
  3. 스토리지 섹션으로 이동합니다.
  4. 사용자 정의 스토리지를 선택합니다.
  5. 키 매핑을 구성할 웹훅을 선택합니다.
    • 사용자 인증
    • 사용자 생성
    • 소셜 로그인
  6. 키 이름 매핑 블록에서 사용자 프로필 속성에 매핑할 필드 이름을 입력합니다.
  1. 사용자 계정 연결 활성화 토글을 활성 상태로 설정하면 시스템에서 동일한 server_custom_id를 가진 모든 계정을 동일한 사용자의 계정으로 식별할 수 있습니다(선택 사항).
알림
server_custom_id 계정 연결은 키 매핑에서 server_custom_id 속성에 대한 키를 지정한 경우에만 사용할 수 있습니다.
  1. 변경 사항 저장을 클릭합니다.
알림
키 매핑에 모든 필드를 포함할 필요는 없습니다.

키 이름 맵 사용 예시

웹훅 응답의 사용자 데이터를 JWT 및 사용자 프로필 속성으로 전달하기

  1. 사용자 인증 웹훅에 대한 응답으로 다음 JSON 개체(모든 필드 집합을 포함할 수 있음)를 전송하십시오.
Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17}
  1. 관리자 페이지에서 nicknameserver_custom_id 속성에 키를 매핑했습니다.
  1. 사용자 세부 정보 가져오기 요청에 대한 응답으로 다음 JSON을 수신하게 됩니다.
Copy
Full screen
Small screen
 1{
 2  "birthday": null,
 3  "country": null,
 4  "devices": [
 5    {
 6      "device": null,
 7      "last_used_at": null,
 8      "type": null
 9    },
10    {
11      "device": null,
12      "last_used_at": null,
13      "type": null
14    }
15  ],
16  "email": null,
17  "external_id": null,
18  "first_name": null,
19  "gender": null,
20  "groups": [
21    {
22      "id": 1,
23      "is_default": false,
24      "name": "admin"
25    },
26    {
27      "id": 5,
28      "is_default": false,
29      "name": "user"
30    }
31  ],
32  "id": null,
33  "is_anonymous": false,
34  "last_login": null,
35  "last_name": null,
36  "nickname": "gamer123",
37  "phone": null,
38  "phone_auth": null,
39  "registered": null,
40  "tag": null,
41  "username": null
42}
알림
필드가 키 이름 매핑에 추가된 경우 웹훅 응답에서 반환된 모든 값이 사용자의 JWT 토큰에 포함됩니다. 시스템에 없는 사용자 프로필 속성의 경우 응답은 null을 반환합니다.
결과적으로, 엑솔라 사용자 프로필에 포함되고 API와 토큰을 통해 사용할 수 있는 시스템의 데이터를 제어합니다.

웹샵 솔루션에서 인증 시 키 이름 맵 및 계정 연결 사용

  1. 사용자는 사용자 ID를 사용하여 웹샵 솔루션에 로그인합니다. 사용자 ID는 JWT의 server_custom_id 필드에 기록됩니다.
  2. 웹샵 솔루션은 웹샵 솔루션의 사용자 유효성 검사 웹훅을 서버로 보냅니다.
  3. 서버는 HTTP 200(사용자가 있는 경우) 또는 404(사용자가 없는 경우)로 웹훅에 응답합니다.
  4. 웹샵 솔루션에서 사용자를 인증합니다.
  5. 사용자가 소셜 로그인과 같은 다른 방식을 사용하여 웹 상점에 다시 로그인합니다.
  6. 웹 상점이 사용자를 소셜 네트워크의 로그인 페이지로 리디렉션합니다.
  7. 사용자가 소셜 네트워크에 로그인합니다.
  8. 소셜 네트워크가 사용자의 프로필 데이터를 웹 상점에 반환합니다.
  9. 웹 상점이 웹훅소셜 로그인 URL로 전송합니다.
  10. 서버가 소셜 네트워크 프로필 데이터를 기반으로 사용자를 식별하고 사용자 ID 인증 시 사용된 사용자 ID를 할당합니다.
  11. 서버는 2xx 코드로 응답하고 사용자 ID가 포함된 JSON 본문을 포함합니다.
  12. 웹 상점은 사용자 특성을 저장하고 웹훅 응답의 데이터를 JWT의 partner_data 필드에 추가합니다.
  13. 키 이름 맵에 server_custom_id 키가 포함되어 있고 계정 연결이 활성화된경우 웹 상점은 키 이름 맵에 따라 수신된 사용자 데이터를 프로필 속성에 매핑하고 계정을 연결합니다.
  14. 웹 상점은 사용자 ID 로그인 시 사용된 계정으로 사용자를 인증합니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

계속 읽기

마지막 업데이트: 2025년 9월 19일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!
피드백을 보내는 중 문제가 발생했습니다
잠시 후 다시 시도하거나 doc_feedback@xsolla.com으로 연락해 주세요.