소식
제목QR code 자동생성 API 베타 서비스 안내.
엠큐알(mqr.kr)에서 수동으로 생성하는 QR 코드를 귀사에서 운영중인 홈페이지에 자동생성 할수 있게
자동생성 API 베타 테스트에 들어 갔습니다.
mqr.kr 에 방문하여 내용을 입력하여 수동으로 생성하는 코드는 기존과 동일합니다.
API서비스를 위해 자동생성을 위해 일부 알고리즘이 변경되었습니다.
업데이트에도 공지한바와 같이 변경된 내용은 아래와 같습니다.
변경된 알고리즘은 "http://mqr.kr/qr/?t={text}&...&sign={signature}" 인증된 도메인에 한하여 사용 가능합니다. 그렇지 않을경우에는 아래과 같은 경고 메세지가 나타납니다.
서명(signature) 를 생성하기 위해 HMAC SHA256 알고리즘을 적용 하였습니다.
서명(signature)을 생성하기 위한 순서는 다음과 같습니다.
1. 먼저 http://mqr.kr/dashboard/register/ 에서 회원가입후 계정을 활성화 합니다. 회원가입은 이메일과 비밀번호만 받고 있습니다.
2. 등록한 이메일을 확인합니다.
3. 이메일을 확인후 URL를 클릭하여 계정활성화 합니다. 반드시 계정이 활성화되어야만 로그인이 가능합니다. http://mqr.kr/dashboard/login/ 로그인하면 대시보드를 확인할수 있습니다.
4. 대시보드에서 자동생성하고자 하는 URL를 My referrers (hosts) 에 등록합니다 (예: http://www.must.or.kr)
5. 도메인을 등록하면 16-byte의 키가 생성됩니다.
6. 키를 생성한다음 서명(signature)을 생성합니다. 서명(signature) 생성 절차는
a. 16 바이트 키를 사용하여 HMAC SHA256 개체 인스턴스를 초기화 합니다.
b. QR 코드를 생성하는 데 사용하고자하는 모든 매개 변수와 쿼리 문자열을 만듭니다. 예를 들어 "t=sample&r=10&j=1"
c. 문자열에서 얻은 ASCII 바이트에 HMAC SHA256 객체를 사용하여 해시를 계산 합니다.
d. HEX 형식의 쿼리 문자열 (64 자)의 끝 부분에 서명(signature)을 추가합니다. 그러면 "t=sample&r=10&j=1&sign={signature}" 쿼리를 얻을 것입니다.
e. 순서 d 에서 만들어진 퀴리를 이용하여 <img src="http://mqr.kr/qr/?t=sample&r=10&j=1&sign={signature}"/> 와 같이 자동생성 QR코드를 사용할수 있습니다.
서명(signature)는 회원가입후 등록한 URL마다 발행되는 고유 KEY값과 연계되어 큐알코드마다 고유의 서명(signature)이 자동으로 생성되므로 수동으로 만들 수 없습니다.
서명(signature) 생성을 쉽게하기 위해 추후 홈페이지를 통해 각 언어별(.Net, ASP, jsp, PHP) 샘플 소스코드를 공개할 계획입니다.
* 참고 mqr.kr 에서 변경된 HMAC SHA256 알고리즘에 의한 서명(signature) 과정
QR코드 자동생성 API 서명(signature) 에 대해 다시한번 알려 드립니다.
머스트 유시시가 새롭게 변경되었습니다.
