📖사용법
인증 위젯 JavaScript SDK의 사용법에 대해서 알아보겠습니다.
📘 설치하기
클라이언트 측 HTML 파일의 <body> 태그 내에 아래의 스크립트를 추가합니다.
<script src="https://assets.daopass.info/auth/widget.js"></script>
📘 인증 위젯 출력
인증 위젯을 출력시키는 방법을알아보겠습니다.
먼저 설정하신 인증 위젯 상세 페이지에서 API 키를 확인해주세요.
그리고 아래의 스크립트 예시를 참고하여 인증위젯을 초기화시켜주세요.
초기화가 진행되면 기기별 인증 위젯 화면이 출력됩니다.
AuthWidget.init({
apiKey: "api_e73ad1019060bd340358", // (required) 인증위젯API 키
requestId: "afg3ad101asdzhlkq0", // (option) 클라이언트 서버에서 요청 유저를 확인하기 위한 고유 키
successEventName: "SUCCESS_EVENT", // (option) 인증 성공 시 실행할 post message
failEventName: "FAIL_EVENT" // (option) 인증 실패 시 실행할 post 이벤트
});
API Key는 인증 위젯 추가 시 자동으로 생성됩니다.
PC
인증용 QR코드가 출력되고 사용자가 다오패스 APP으로 스캔 시 인증이 진행됩니다.
MOBILE
다오패스 APP 내 웹페이지 혹은 모바일 브라우저에서는 인증하기 버튼이 출력되고 사용자가 해당 버튼 클릭 시 인증이 진행됩니다.
📘 인증 결과 처리
인증 결과 Callback
사용자가 진행한 인증 결과는 인증위젯 설정에 추가하신 Callback URL로 전송됩니다.
전송되는 데이터의 정보는 다음과 같습니다.
clientId
String
인증 키(인증내역 고유 ID)
status
String
인증 결과 - 성공: success - 실패: fail
message
String
인증 결과 메시지
address
String
인증 요청 지갑주소
nft
Object
인증에 사용된 NFT 정보 - chainId: 블록체인 네트워크 ID - contract: 컨트랙트 주소 - tokenId: NFT ID
userData
Object
클라이언트 측에서 설정한 커스텀데이터
Callback 응답
클라이언트 서버에서는 해당 URL이 호출되었을 때 응답 JSON 데이터를 통해 사용자에게 최종적으로 인증 결과를 전달할 수 있습니다.
code
Integer
상태 코드 - 정상: 100 - 그 외(ex: 500)
message
String
결과 메시지
secret_key
String
인증위젯 설정정보에 배정된 비밀 키
custom_data
Object
사용자 화면에 인증 데이터와 함께 전달할 추가 데이터
Last updated