JSON에서 사용자 프로필 키 이름 맵으로
작동 방식
엑솔라 로그인 웹훅에 대한 응답으로 반환하는 JSON 개체의 필드를 엑솔라 시스템의 다음 사용자 프로필 속성에 매핑할 수 있습니다.
- 생년월일(birthday)
- 닉네임(nickname)
- 이름(first_name)
- 성(last_name)
- 성별(gender)
- 서버의 사용자 ID(server_custom_id)
- 데이터를 웹샵 솔루션과 동기화하는 경우
- Mailchimp 병합 태그를 적용하는 경우
- 다른 외부 시스템과의 통합을 구현하는 경우
server_custom_id 속성에 대한 키를 지정하면 server_custom_id 계정 병합을 활성화할 수 있습니다. 이렇게 하면 시스템에서 동일한 server_custom_id를 가진 모든 계정을 동일한 사용자가 소유한 것으로 식별할 수 있습니다.사용자
사용자 정의 사용자 데이터 스토리지를 사용하고 엑솔라 로그인에서 이 스토리지의 데이터를 사용하려는파트너.
획득 방법
- 관리자 페이지의 프로젝트에서 로그인 섹션으로 이동 합니다.
- 로그인 옵션을 선택하고 사용자 데이터베이스 섹션으로 이동합니다.
- 스토리지 섹션으로 이동합니다.
- 사용자 정의 스토리지를 선택합니다.
- 키 매핑을 구성할 웹훅을 선택합니다.- 사용자 인증
- 사용자 생성
- 소셜 로그인
 
- 키 이름 매핑 블록에서 사용자 프로필 속성에 매핑할 필드 이름을 입력합니다.
- 사용자 계정 연결 활성화 토글을 활성 상태로 설정하면 시스템에서 동일한 server_custom_id를 가진 모든 계정을 동일한 사용자의 계정으로 식별할 수 있습니다(선택 사항).
알림
server_custom_id 계정 연결은 키 매핑에서 server_custom_id 속성에 대한 키를 지정한 경우에만 사용할 수 있습니다.- 변경 사항 저장을 클릭합니다.
알림
키 매핑에 모든 필드를 포함할 필요는 없습니다.
키 이름 맵 사용 예시
웹훅 응답의 사용자 데이터를 JWT 및 사용자 프로필 속성으로 전달하기
- 사용자 인증 웹훅에 대한 응답으로 다음 JSON 개체(모든 필드 집합을 포함할 수 있음)를 전송하십시오.
Copy
- json
 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}
- 관리자 페이지에서 nickname및server_custom_id속성에 키를 매핑했습니다.
- 사용자 세부 정보 가져오기 요청에 대한 응답으로 다음 JSON을 수신하게 됩니다.
Copy
- json
 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을 반환합니다.웹샵 솔루션에서 인증 시 키 이름 맵 및 계정 연결 사용
- 사용자는 사용자 ID를 사용하여 웹샵 솔루션에 로그인합니다. 사용자 ID는 JWT의 server_custom_id필드에 기록됩니다.
- 웹샵 솔루션은 웹샵 솔루션의 사용자 유효성 검사 웹훅을 서버로 보냅니다.
- 서버는 HTTP 200(사용자가 있는 경우) 또는404(사용자가 없는 경우)로 웹훅에 응답합니다.
- 웹샵 솔루션에서 사용자를 인증합니다.
- 사용자가 소셜 로그인과 같은 다른 방식을 사용하여 웹 상점에 다시 로그인합니다.
- 웹 상점이 사용자를 소셜 네트워크의 로그인 페이지로 리디렉션합니다.
- 사용자가 소셜 네트워크에 로그인합니다.
- 소셜 네트워크가 사용자의 프로필 데이터를 웹 상점에 반환합니다.
- 웹 상점이 웹훅을 소셜 로그인 URL로 전송합니다.
- 서버가 소셜 네트워크 프로필 데이터를 기반으로 사용자를 식별하고 사용자 ID 인증 시 사용된 사용자 ID를 할당합니다.
- 서버는 2xx코드로 응답하고 사용자 ID가 포함된 JSON 본문을 포함합니다.
- 웹 상점은 사용자 특성을 저장하고 웹훅 응답의 데이터를 JWT의 partner_data필드에 추가합니다.
- 키 이름 맵에 server_custom_id키가 포함되어 있고 계정 연결이 활성화된경우 웹 상점은 키 이름 맵에 따라 수신된 사용자 데이터를 프로필 속성에 매핑하고 계정을 연결합니다.
- 웹 상점은 사용자 ID 로그인 시 사용된 계정으로 사용자를 인증합니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.계속 읽기
유용한 링크
사용자 지정 사용자 데이터 저장소오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.