본문으로 건너뛰기

BSA-JS

BSA를 사용하여 인증을 하기 위한 BSA-JS 에 대한 설명입니다.
BSA-JS 는 web에서 쉽게 인증 기능을 구현하기 위해 만들어진 script 기반 library 입니다.

BSA-JS 시작하기#

최신 버전의 BSA-JS 를 사용할 수 있습니다.

<script type="text/javascript" src="https://developers.fnsvalue.co.kr/bsa-js/bsa.js"></script>

특정 버전 사용하기#

특정 버전을 사용할 경우 BSA-JS URL 에 VERSION 을 기입합니다.

<script type="text/javascript" src="https://developers.fnsvalue.co.kr/bsa-js/{VERSION}/bsa.js"></script>
  • Example
<script type="text/javascript" src="https://developers.fnsvalue.co.kr/bsa-js/1.0.12/bsa.js"></script>

지원기능#

BSA-JS 에서 제공하는 method

NameDescription
constructorBSA-JS 생성자입니다.
requestAuthBSA 인증 요청을 진행하며, 인증 성공 후 설정 URL 로 redirect 합니다.
requestAuthCallbackBSA 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다.
onCancelBSA 인증 요청을 취소합니다.
setAuthTimer남은 인증 시간을 제공합니다.
setAuthMessage인증 진행 메시지를 제공합니다.
requestQrBSA QR 인증 요청을 진행하며, 인증 성공 후 설정 URL 로 redirect 합니다.
requestQrCallbackBSA QR 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다.
onQrCancelBSA QR 인증 요청을 취소합니다.
setQrTimer남은 QR 인증 시간을 제공합니다.
setQrMessageQR 인증 메시지를 제공합니다.
requestOtpBSA OTP 인증 요청을 진행하며, 인증 성공 후 URL 로 redirect 합니다.
requestOtpCallbackGuardianCCS OTP 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다.
onOtpCancelBSA OTP 인증 요청을 취소합니다.
setOtpTimer남은 OTP 인증 시간을 제공합니다.
setOtpMessageOTP 인증 메시지를 제공합니다.
requestTotpCallbackBSA TOTP 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다.

기능 설명 및 예시#

constructor#

BSA-JS 를 사용하기 위한 생성자이며, 필수 요소 입니다. BSA-JS 를 사용하기 위해 clientKey가 필요합니다.
BSA-JS 에서 사용하는 clientKey 는 BSA 관리자에게 문의 또는 BSA Portal 에서 확인 할 수 있습니다.

constructor(clientKey)

Parameter#

NameTypeDescription
clientKeyStringBSA 를 사용하는 Client Key

Example#

const bsa = new BSA("{Client Key}");