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 로그인 시 사용된 계정으로 사용자를 인증합니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.계속 읽기
유용한 링크
사용자 지정 사용자 데이터 저장소오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.