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
| Name | Description |
|---|---|
| constructor | BSA-JS 생성자입니다. |
| requestAuth | BSA 인증 요청을 진행하며, 인증 성공 후 설정 URL 로 redirect 합니다. |
| requestAuthCallback | BSA 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다. |
| onCancel | BSA 인증 요청을 취소합니다. |
| setAuthTimer | 남은 인증 시간을 제공합니다. |
| setAuthMessage | 인증 진행 메시지를 제공합니다. |
| requestQr | BSA QR 인증 요청을 진행하며, 인증 성공 후 설정 URL 로 redirect 합니다. |
| requestQrCallback | BSA QR 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다. |
| onQrCancel | BSA QR 인증 요청을 취소합니다. |
| setQrTimer | 남은 QR 인증 시간을 제공합니다. |
| setQrMessage | QR 인증 메시지를 제공합니다. |
| requestOtp | BSA OTP 인증 요청을 진행하며, 인증 성공 후 URL 로 redirect 합니다. |
| requestOtpCallback | GuardianCCS OTP 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다. |
| onOtpCancel | BSA OTP 인증 요청을 취소합니다. |
| setOtpTimer | 남은 OTP 인증 시간을 제공합니다. |
| setOtpMessage | OTP 인증 메시지를 제공합니다. |
| requestTotpCallback | BSA TOTP 인증 요청을 진행하며, 인증 성공 후 설정 CallBack 으로 결과를 리턴합니다. |
기능 설명 및 예시#
constructor#
BSA-JS 를 사용하기 위한 생성자이며, 필수 요소 입니다.
BSA-JS 를 사용하기 위해 clientKey가 필요합니다.
BSA-JS 에서 사용하는 clientKey 는 BSA 관리자에게 문의 또는 BSA Portal 에서 확인 할 수 있습니다.
constructor(clientKey)Parameter#
| Name | Type | Description |
|---|---|---|
| clientKey | String | BSA 를 사용하는 Client Key |
Example#
const bsa = new BSA("{Client Key}");