튜토리얼
튜토리얼
Python 개발환경에서 바로써트 SDK를 추가하여 간편로그인 요청(requestLogin) 함수를 구현하는 예시입니다.
1. BaroCert SDK 추가
Python 바로써트 SDK와 암호화 통신에 필요한 외부 라이브러리(pycryptodome, cffi)를 pip install 명령어를 사용하여 설치합니다.
※ Python v3.10 부터는 OPENSSL v1.1.1 이상이 필요합니다.
$ pip install barocert pycryptodome cffi
2. BaroCert SDK 설정
Django 프로젝트의 settings.py 파일에 연동신청시 발급받은 API Key와 연동환경 설정값을 선언합니다.
# 링크아이디
LinkID = "TESTER"
# 비밀키
SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="
# 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
IPRestrictOnOff = True
# 통신 고정 IP, true-사용, false-미사용, (기본값:false)
UseStaticIP = False
3. RequestLogin 기능 구현
① Django App에 생성된 views.py 파일에 패스써트 서비스 클래스 객체 생성과 RequestLogin 함수 코드를 추가합니다.
# -*- coding: utf-8 -*-
from django.shortcuts import render
from config import settings
from barocert import PassCMS, PassIdentity, PassLogin, PassSign, \
PassCMSVerify, PassIdentityVerify, PassLoginVerify, PassSignVerify, \
PasscertService, BarocertException
# config/settings.py API Key(LinkID, SecretKey)를 이용해 설정
# PasscertService 객체 인스턴스 생성
passcertService = passcertService(settings.LinkID, settings.SecretKey)
# 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
passcertService.IPRestrictOnOff = settings.IPRestrictOnOff
# 통신 고정 IP, true-사용, false-미사용, (기본값:false)
passcertService.UseStaticIP = settings.UseStaticIP
# 패스 이용자에게 간편로그인을 요청합니다.
# https://developers.barocert.com/reference/pass/python/login/api#RequestLogin
def requestLoginHandler(request):
try:
# 이용기관코드, 파트너 사이트에서 확인
clientCode = '023070000014'
# 간편로그인 요청정보 객체
requestObj = PassLogin(
# 수신자 휴대폰번호 - 11자 (하이픈 제외)
receiverHP = passcertService._encrypt('01012341234'),
# 수신자 성명 - 80자
receiverName = passcertService._encrypt('홍길동'),
# 수신자 생년월일 - 8자 (yyyyMMdd)
receiverBirthday = passcertService._encrypt('19700101'),
# 요청 메시지 제목 - 최대 40자
reqTitle = '간편로그인 요청 메시지 제목',
# 요청 메시지 - 최대 500자
reqMessage = passcertService._encrypt('간편로그인 요청 메시지'),
# 고객센터 연락처 - 최대 12자
callCenterNum = '1600-9854',
# 인증요청 만료시간 - 최대 1,000(초)까지 입력 가능
expireIn = 1000,
# 서명 원문 - 최대 40자 까지 입력가능
token = passcertService._encrypt('간편로그인 요청 원문'),
# 사용자 동의 필요 여부
userAgreementYN = True,
# 사용자 정보 포함 여부
receiverInfoYN = True,
# AppToApp 인증요청 여부
# true - AppToApp 인증방식, false - 푸시(push) 인증방식
appUseYN = False,
)
result = passcertService.requestLogin(clientCode, requestObj)
return render(request, 'passcert/requestLogin.html', {'result': result})
except BarocertException as PE:
return render(request, 'exception.html', {'code': PE.code, 'message': PE.message})
② 함수 호출결과 코드와 메시지를 출력하는 "/requestLogin.html" 파일을 추가합니다.
{% extends "base.html" %}
{% block contents %}
<div id="content">
<p class="heading1">Barocert Django Example</p>
<br />
<fieldset class="fieldset1">
<legend>{{ request.path }}</legend>
<ul>
<li>접수아이디 (ReceiptID) : {{ result.receiptID }}</li>
<li>앱스킴 (Scheme) : {{ result.scheme }}</li>
<li>앱다운로드URL (MarketURL) : {{ result.marketUrl }}</li>
</ul>
</fieldset>
</div>
{% endblock contents %}
4. 결과 확인
함수 호출이 정상적으로 처리되면 "푸시(Push) 인증" 방식은 접수아이디(32자리 숫자)가 반환되며, "앱투앱 인증" 방식은 접수아이디와 AppScheme 이 함께 반환됩니다. 실패인 경우 BarocertException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드]