> For the complete documentation index, see [llms.txt](https://metastar.gitbook.io/daopass-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://metastar.gitbook.io/daopass-doc/auth-widget/using.md). # 사용법 인증 위젯 JavaScript SDK의 사용법에 대해서 알아보겠습니다. ## 📘 설치하기 클라이언트 측 HTML 파일의 `` 태그 내에 아래의 스크립트를 추가합니다. ```html ``` ## 📘 인증 위젯 출력 인증 위젯을 출력시키는 방법을알아보겠습니다. 먼저 설정하신 인증 위젯 상세 페이지에서 API 키를 확인해주세요. 그리고 아래의 스크립트 예시를 참고하여 인증위젯을 초기화시켜주세요. 초기화가 진행되면 기기별 인증 위젯 화면이 출력됩니다. ```javascript AuthWidget.init({ apiKey: "api_e73ad1019060bd340358", // (required) 인증위젯API 키 requestId: "afg3ad101asdzhlkq0", // (option) 클라이언트 서버에서 요청 유저를 확인하기 위한 고유 키 successEventName: "SUCCESS_EVENT", // (option) 인증 성공 시 실행할 post message failEventName: "FAIL_EVENT" // (option) 인증 실패 시 실행할 post 이벤트 }); ``` {% hint style="success" %} API Key는 인증 위젯 추가 시 자동으로 생성됩니다. [준비](/daopass-doc/auth-widget/get-started.md#undefined-2) {% endhint %} ### 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	클라이언트 측에서 설정한 커스텀데이터

{% code title="인증 성공 시 응답" %} ```json { "clientId": "ce8b7a7e5c845a", "status": "success", "message": "인증이 완료되었습니다.", "address": "0xf5e9c6355291b421632a66dbfb5b7186df05ccfc", "nickname": "홍길동", "nft": { "chainId": 137, "contract": "0xda398051c4cd9efb19e50f710225d74397d508f3", "tokenId": "5" }, "userData": { "customKey": "6fbb74d2fcd981d52f08" } } ``` {% endcode %} {% code title="인증 실패 시 응답" %} ```json { "clientId": "ce8b7a7e5c845a, "status": "fail", "message": "인증에 필요한 NFT를 보유하고 있지 않습니다.", "address": "0xf5e9c6355291b421632a66dbfb5b7186df05ccfc" } ``` {% endcode %} ### Callback 응답 클라이언트 서버에서는 해당 URL이 호출되었을 때 응답 JSON 데이터를 통해 사용자에게 최종적으로 인증 결과를 전달할 수 있습니다.

이름	타입	설명
code	Integer	상태 코드 - 정상: 100 - 그 외(ex: 500)	필수
message	String	결과 메시지	필수
secret_key	String	인증위젯 설정정보에 배정된 비밀 키	필수
custom_data	Object	사용자 화면에 인증 데이터와 함께 전달할 추가 데이터	옵션

{% code title="인증 성공 처리 데이터 예시" %} ```json { "code": 100, "message": "OK", "secret_key": "secret_ab4315cd157b6100bbda", "custom_data": { "redirect_url": "https://partner.daopass.net/api/login" } } ``` {% endcode %} {% code title="인증 실패 처리 데이터 예시" %} ```json { "code": 500, "message": "NFT에 해당하는 유저 정보가 존재하지 않습니다.", "secret_key": "secret_ab4315cd157b6100bbda" } ``` {% endcode %}