회원 연동은 자체 사용중인 서비스의 회원 인증을 Online Contact의 헬프센터에 적용하여 회원 문의를 접수하고, 접수한 문의 내역을 다시 확인할 수 있도록 제공하는 기능입니다.
회원 연동은 GET 방식과 POST 방식의 두 가지 타입으로 제공하며, 연동을 위해서 Online Contact에서 제공하는 개발 명세서에 따라 API를 개발하여 회원연동 메뉴에 등록해야 합니다.
1. POST 방식
2. GET 방식
본 문서에는 GET 방식에 대해 설명하고 있습니다. POST 방식 가이드가 필요하다면, API 가이드 > 회원 연동(POST) 문서를 참고하십시오.
개발 명세서에 따라 API를 개발한 후 [서비스 관리 > 헬프센터 > 회원 연동] 메뉴에 접속하여 아래와 같이 설정합니다.
① 회원 연동 활성화
② 비회원 문의 접수
③ 로그인 타입
④ Token 검증 URL
Token 생성 샘플은 아래와 같으며, 파라미터 순서는 반드시 아래와 일치해야 합니다.
Online Contact 조직 Key는 [전체 관리 → 계약 서비스 현황 → 조직 정보] 메뉴에서 확인할 수 있습니다.
(※ Sample project > application.properties > oc.apikey= 항목에 조직 Key를 저장)
private String getSHA256Token(String serviceId, String usercode, String username, String email, String phone,
String returnUrl, Long time, String apiKey) throws Exception {
StringBuilder sb = new StringBuilder();
// Order by follow number:
sb.append(serviceId); // 1
sb.append("&");
sb.append(usercode); // 2
sb.append("&");
if (StringUtils.isNotBlank(username)) {
sb.append(username); // 3
sb.append("&");
}
if (StringUtils.isNotBlank(email)) {
sb.append(email); // 4
sb.append("&");
}
if (StringUtils.isNotBlank(phone)) {
sb.append(phone); // 5
sb.append("&");
}
if (StringUtils.isNotBlank(memberno)) {
sb.append(memberno); // 6
sb.append("&");
}
if (StringUtils.isNotBlank(returnUrl)) {
sb.append(returnUrl); // 7
sb.append("&");
}
sb.append(time); // 8
SecretKeySpec signingKey = new SecretKeySpec(apiKey.getBytes("UTF-8"), "HmacSHA256");
Mac mac = Mac.getInstance(signingKey.getAlgorithm());
mac.init(signingKey);
byte[] rawHmac = mac.doFinal(sb.toString().getBytes("UTF-8"));
return new String(Base64.encodeBase64(rawHmac));
}
// Sample
// Use this same input, the output is : Ah9M58CQ9RFTShjFuqziQr+0MjmJxN6+bzWxMD71moo=
public static void main(String[] args) throws Exception {
String s = getSHA256Token("hangame", "testusercode", "testUsername", "test@email.com", "123456789",
null, 1660095873001L, "7cf2828608274a49a3f06152b2188927");
System.out.println(s); // Output: Ah9M58CQ9RFTShjFuqziQr+0MjmJxN6+bzWxMD71moo=
}
URL
URL(개발)
인터페이스 명 | 프로토콜 | 호출방향 | 인코딩 | 결과 형식 | 인터페이스 설명 |
---|---|---|---|---|---|
GET 회원인증 | HTTPS | GET | UTF-8 | 서비스 측에서 헬프센터 접속 시, 고객정보 및 암호화 후 생성된 token 값을 파라미터로 URL에 추가해서 호출 |
명칭 | 변수 | 데이터 타입 | 필수 | 설명 |
---|---|---|---|---|
서비스 ID | service | VARCHAR(50) | O | 서비스 ID |
유저 ID | usercode | VARCHAR(50) | O | 유저ID(유니크 값) |
유저 명 | username | VARCHAR(50) | X | 유저 명 |
유저 이메일 | VARCHAR(100) | O | 유저 이메일 | |
전화번호 | phone | VARCHAR(20) | X | 전화번호 |
회원번호 | memberno | VARCHAR(50) | X | 회원번호 |
timestamp | time | LONG | O | 시간 단위: 밀리초 |
인증 Token | token | VARCHAR | O | 다음 파라미터 값과 조직 Key로 계산(SHA256). (선택사항 값이 null 혹은 없을 경우, token 생성에서 제외. 주의사항: 문자열에서 각 값의 순서는 다음과 동일해야 함) SHA256Digest(service + usercode + username + email + phone + memberno + returnUrl + time) |
인터페이스 명 | 프로토콜 | 호출방향 | 인코딩 | 결과 형식 | 인터페이스 설명 |
---|---|---|---|---|---|
Token 검증 URL | HTTPS | GET | UTF-8 | JSON | 서비스 측에서 token과 usercode로 로그인 상태 확인 후 JSON 형태 결과 값을 전송 |
명칭 | 변수 | 데이터 타입 | 필수 | 설명 |
---|---|---|---|---|
유저 ID | usercode | VARCHAR(50) | O | 유저 ID(유니크 값) |
서비스 측에서 생성한 Token | token | VARCHAR | O | 사용자가 GET 방식을 통해 Online Contact에 로그인 시, Online Contact으로 전달하는 token |
로그인:
{
"login": "true",
"usercode":"usercodeXXX"
}
로그아웃:
{
"login": "false",
"usercode": null
}