DID User Guide

DID 연동 가이드

DID 서비스 사용을 위해서는 다음과 같은 과정이 진행되어야 합니다. 이 문서에서는 각 단계에 대한 루니버스 콘솔 사용 및 연동 가이드를 제공합니다.

DID 프로젝트 생성
API Key 생성 및 IP 등록
Credential 템플릿 생성하기
Verification 시나리오 생성하기

DID 프로젝트 생성

프로젝트 생성하기

루니버스 콘솔 홈 좌측 메뉴에서 DID를 클릭하고 Dashboard로 이동한 뒤, 페이지 우측 상단의 [ + Create Project ] 버튼을 클릭합니다. (DID의 경우, Plan을 구매해야 이용이 가능하기 때문에 별도의 Plan을 구매하지 않은 경우, Contact Us 페이지로 이동하게 됩니다.

DID Project를 생성하기 위한 페이지로 이동합니다. 각 Field에 대한 설명은 다음과 같습니다.

Environment : 크리덴셜 발급 및 인증정보를 검증할 체인을 선택합니다. DID 서비스 도입 시 Luniverse가 제공하는 전용 Sidechain을 선택할 수 있습니다.
Project Name : DID Project 이름을 입력합니다.
Company Name : 회사 이름을 입력합니다. 입력한 회사 및 서비스 정보는 인증요청 과정에서 사용자에게 보여질 수 있습니다
Service Name : DID를 이용할 서비스 이름을 입력합니다.
Service URL : 제공하는 서비스의 URL을 입력합니다.
Service Icon : 서비스 정보와 아이콘은 인증서 발급 및 요청 과정에서 사용자에게 보여질 수 있습니다.
(PNG, JPG, 권장 640X640px, 최대 1Mb)
정보를 입력하고 [ Create ] 버튼을 클릭합니다.

Project 삭제하기

Project가 삭제되면 API를 사용할 수 없으며, 삭제된 데이터는 복구할 수 없습니다. 데이터 백업 여부를 꼭 체크하세요.

콘솔 홈 좌측 메뉴에서 DID를 클릭하고 DID Dashboard로 이동합니다.

프로젝트 이름 하단의 탭메뉴에서 Information 탭을 클릭한 뒤 페이지 우측의 [ Delete Project ] 버튼을 클릭합니다.

가이드와 안내문구를 확인하고, 제시한 문구를 동일하게 입력합니다. 올바르게 입력 경우 [ Delete ] 버튼이 활성화 됩니다. [ Delete ] 버튼을 클릭합니다.

❗️
프로그램 삭제가 안된다면
프로젝트에 생성한 Credential 템플릿을 사용중인 Verification 시나리오가 있을 경우 프로젝트를 삭제할 수 없습니다. 해당 시나리오로 크레덴셜 발급 및 인증을 시도하는 사용자에게 영향도가 있기 때문입니다. Verification 시나리오를 모두 삭제 후 프로젝트를 삭제를 진행하시기 바랍니다. 공개 템플릿을 만든 경우 모든 사용자에게 공개 되므로 다른 사용자가 시나리오에 이를 사용중이라면 삭제 할 수 없습니다.

API Key 생성 및 IP 등록

DID API를 호출하기 위해서는 API Key를 생성한 뒤 DID 서비스 사용 권한을 부여해야 합니다.

API Key 페이지를 참고하여 루니버스 API Key를 생성하고 IP를 등록하여 인증 토큰 발급에 사용하세요.

Credential 템플릿 생성하기

Credential은 검증가능한 자격증명(Verifiable Credential), 즉 크레덴셜이 변조나 훼손되지 않았음을 암호학적으로 검증할 수 있는 크레덴셜로서 발급자(Issuer)의 전자서명 값을 포함하게 됩니다. 다양한 유형의 자격증명 템플릿을 만들어 비즈니스에 활용하세요. 필요한 만큼의 필수 정보 조합으로 내가 나임을 증명하는 템플릿을 제공하세요.

Credential Template를 생성하기 위해서는 먼저 Project가 생성되어 있어야 합니다.

좌측 메뉴에서 DID를 클릭하고 Credential Template로 이동합니다.

페이지 우측 상단의 [ + Create Credential Template ] 버튼을 클릭합니다. Credential Template을 생성하기 위한 페이지를 확인할 수 있으며 각 Field 별 설명은 다음과 같습니다.

Template Name : 생성할 Credential Template의 이름입니다.
Expiration Date : Credential의 유효기간을 설정하세요. 최종 사용자의 발급일을 기준으로 유효기간을 설정하거나, 발급 여부와 상관없이 특정 시작일과 종료일을 설정할 수 있습니다.
Public Template Settings : DID 서비스를 이용할 네트워크의 다른 사용자들과 Credential Template을 공유할 수 있습니다. 공개된 Credential Template은 Verification 시나리오 생성에서 보여집니다.
Credential Integration Settings : 통합 Credential Template을 설정하면 여러 개의 Subject 요소들을 하나의 Credential Template으로 통합하여 발행합니다. 개별 Credential Template을 설정하면 각각의 Subject가 개별 선택 가능한 형태로 발행되어 Verification 시나리오에서 선택적으로 사용할 수 있습니다.
Multi-use Credential Settings : 해당 Credential Template의 증명 유효 기간을 다회성으로 설정할 것인지, 일회성으로 설정할 것인지 선택합니다.
- 기본값인 다회성 증명은 유효 기간 동안 발급받은 Credential Template으로 요청을 받을 때마다 증명을 제출할 수 있습니다.
- 일회성 증명은 유효 기간 안에 한번의 증명을 제출한 후 해당 Credential Template은 더 이상 사용할 수 없게 됩니다. 일회성 쿠폰이나 방문증 등에 활용할 수 있습니다.
Credential Subject : Credential Template에 포함될 검증 데이터의 속성을 정의합니다.
- Display Name : 속성의 이름입니다. (ex. 이름, 생일, 이메일 등)
- Subject Key : 실제 소스 코드에 반영될 키 값 입니다. (띄어쓰기 없는 영문으로 작성)
- 부가설명 : 옵션으로 부가 설명을 추가할 수 있습니다. (선택 사항)
- 하단의 [+] 버튼을 클릭하면 Subject 정의 그룹을 계속 추가할 수 있습니다.
작성이 완료되면 [ Create ] 버튼을 클릭하여 Credential Template을 생성할 수 있습니다.

Verification 시나리오 생성하기

사용자에게 인증을 요청할 시나리오를 생성합니다. 미리 작성된 Credential Template의 Subject들을 조합하여 사용할 수 있습니다.

인증 시나리오를 작성하기 위해서는 Project가 생성되어 있어야 합니다. Credential Template은 직접 생성하여 사용하거나, Public Template Settings를 Public으로 설정한 다른 사용자의 Credential Template을 사용할 수 있습니다.

좌측 메뉴에서 DID를 클릭하고 Verification Scenario로 이동합니다.

페이지 우측 상단의 [ + Create Veification Scenario ] 버튼을 클릭합니다. Verification Scenario를 생성하기 위한 페이지를 확인할 수 있으며 각 Field 별 설명은 다음과 같습니다.

Scenario Name : 인증 시나리오의 이름입니다. 시나리오 이름은 사용자에게 보이지 않으며, 후에 시나리오 리스트의 제목으로 사용됩니다.
Disclosure Properties : verification Scenario에서 사용할 Credential Template을 선택합니다.
- Credential Template을 선택합니다.
  선택할 수 있는 Credential Template은 내가 생성한 Credential Template과 Public Template Settings에서 Public을 선택한 다른 사용자의 Credential Template이 함께 표시됩니다. 템플릿 이름을 선택하면 하단에 속한 Subject 속성들이 표시됩니다.
- [ Add Disclosure Properties + ] 버튼을 클릭하여 Verification Scenario에 사용할 Credential Template을 추가할 수 있습니다.
작성이 완료되면 [ Create ] 버튼을 클릭하여 Verification Scenario를 생성합니다.

API 연동하기

이제 DID 서비스를 사용할 준비가 완료되었습니다! 다양한 DID API를 확인해보고, 새로운 신원 정보를 발행하거나 증명해보세요!

Luniverse DID API 바로가기