KAS 콘솔
이 페이지는 KAS 콘솔이 제공하는 기능에 대해 안내합니다.
Dashboard
대시보드는 여러분의 KAS API 사용량을 확인할 수 있으며 CoinGecko를 통해 KLAY 시세를 확인할 수 있는 KAS 콘솔의 메인 화면입니다.
Tutorial
튜토리얼은 KAS 콘솔의 어떤 기능들이 있는지, API를 어떻게 사용하여 개발에 적용할 수 있는지 알려주는 교육 영상들입니다.
Security
KAS 콘솔 - Security에는 Credential과 IP Whitelist 메뉴가 있습니다.
Credential
Credential 메뉴에서는 API를 호출할 때 필요한 인증 키를 생성, 삭제할 수 있습니다. API 인증 키는 API 사용자가 KAS 회원 본인이 맞는지 증명하기 위해 사용합니다. KAS에서 API 인증은 HTTP Basic 인증 방식을 사용하며 인증 키는 인증 ID(AccessKey ID)와 인증 비밀번호(Secret AccessKey)로 구성됩니다.
API 인증 키에서 인증 비밀번호인 Secret AccessKey와 Authorization은 최초 생성 시 한 번만 확인할 수 있습니다. 따라서, 최초 생성 시 반드시 Secret AccessKey와 Authorization을 안전한 곳에 복사 또는 다운로드해 관리해야 합니다. 인증 키 생성시 확인할 수 있는 Authorization (예: Basic S0FTS1A2WkRaSjh...)은 Basic 인증 방식을 이용하여 AccessKey ID와 Secret AccessKey를 인코딩한 값이며 API 호출 시 호출 헤더에 사용합니다.
API 인증 키가 있으면 모든 KAS 서비스를 사용할 수 있으며 Wallet API를 호출해 만든 Klaytn 계정에 대한 모든 권한을 소유합니다. 모든 권한에는 Klaytn 계정의 자산(KLAY 등) 이동이나 트랜잭션 전송 및 실행 권한이 포함됩니다. 만약 API 인증 키에 타인이 접근한다면 Klaytn 계정 권한을 탈취당해 원치 않는 트랜잭션이 발생할 수 있습니다.
KAS/Klaytn 계정 보안을 위해 KAS API 인증 키(Secret Access Key)를 타인과 함부로 공유하지 말고 주의해 관리하십시오.
인증 키는 KAS 콘솔 - Security - Credential 메뉴에서 생성할 수 있습니다. 인증 키는 최대 2개까지 생성 가능합니다. 인증 키를 교체하려면 기존 키를 삭제하고 새 인증 키를 만들어야 합니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
IP Whitelist
IP Whitelist 메뉴에서 KAS를 사용할 수 있는 IP 주소를 관리할 수 있습니다.
첫 계정 생성 시에는 등록된 IP가 없기 때문에 모든 IP를 허용할 수 있지만, 특정 클라이언트 또는 서버의 IP로만 KAS API를 사용하고 싶을 경우 해당 페이지에서 관리할 수 있습니다.
IP는 최대 50개까지 등록할 수 있으며, CIDR(Classless Inter-Domain Routing)로 입력하여 등록할 수 있습니다. IP 저장 후 입력하지 않은 IP로 KAS API를 호출하게 되면 Whitelist 권한 에러를 확인할 수 있습니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
Service
KAS 콘솔 - Service에는 Klaytn Node, Token History, Wallet, Anchor, KIP 메뉴가 있습니다.
Klaytn Node
Klaytn Node 메뉴는 Klaytn Node API를 이용하는 방법을 소개합니다. 여러분은 Klaytn Node API로 Klaytn Endpoint Node (EN)를 구축, 운영하지 않고도 클레이튼에 JSON-RPC 함수들을 호출하거나 클레이튼 블록체인의 다양한 정보를 조회할 수 있습니다.
Klaytn Node 메뉴에서는 Klaytn Node API가 지원하는 JSON-RPC API를 확인할 수 있으며 API를 호출하는 방법도 간단히 안내합니다. JSON-RPC API에 관한 자세한 내용은 JSON-RPC API Reference를 확인하십시오.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
Token History
Token History 메뉴에서는 Preset을 생성하고 라벨링된 토큰들을 조회할 수 있습니다.
Preset
Preset 메뉴에서는 Preset을 등록, 삭제, 업데이트, 확인할 수 있습니다. Preset이란 KAS에서 1개 이상의 토큰 송/수신 기록을 조회하기 위해 필요한 정보입니다. Preset을 생성함으로 KAS에 여러분의 클레이튼 계정 주소(EOA), FT 주소, NFT 주소, MT 주소를 등록합니다. 등록한 Preset을 Token History API와 함께 사용하면 토큰 전송 기록에서 여러분이 원하는 정보만을 골라 조회할 수 있습니다.
Labeled Tokens
라벨링(Labeling)이란, 여러분의 토큰 정보와 토큰 전송 기록을 Token History API가 추적하도록 토큰 정보를 KAS에 등록하는 것입니다. KAS에서는 KIP-7, KIP-17 표준 인터페이스를 따르는 토큰 정보를 자동으로 추적합니다. 즉, KIP-7, KIP-17 토큰은 KAS에 의해 이미 자동으로 라벨링(Labeling)된 토큰들입니다.
하지만 KAS는 ERC-20, ERC-721 토큰 정보의 변동을 자동으로 추적하지 않습니다. KAS가 여러분이 만든 ERC-20, ERC-721 토큰 정보의 변동 사항, 토큰 전송 기록을 자동으로 추적하려면 여러분이 직접 여러분이 만든 ERC-20, ERC-721을 KAS에 등록(라벨링)해야 합니다.
토큰을 KAS에 등록하려면 아래와 같이 KAS 콘솔 - My Page - My ERC Tokens 메뉴에서 토큰을 등록해야 합니다.
ERC-20, ERC-721 토큰을 라벨링하는 방법에 관한 자세한 내용은 다음을 확인하십시오.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
Wallet
Wallet 메뉴에서는 Wallet API 호출 시 필요한 클레이튼 계정을 보관하고 관리하는 계정 저장소를 만들 수 있습니다. 계정 저장소에는 일반적인 계정 저장소와 수수료 대납 계정 저장소가 있으며 수수료 대납 계정 저장소에서는 수수료 대납 계정을 API 호출 없이 직접 만들 수 있습니다.
계정 저장소(Account Pool)
여러분이 블록체인 애플리케이션을 개발한다면 아마도 그 애플리케이션은 블록체인에 트랜잭션을 보낼 것입니다. KAS로 블록체인 애플리케이션을 개발한다면 여러분의 애플리케이션은 하나 이상의 클레이튼 계정(Account)으로 클레이튼에 트랜잭션을 보낼 것입니다. KAS에서는 하나의 KAS 계정이 여러 클레이튼 계정들을 쉽게 관리할 수 있도록 계정 저장소를 제공합니다. 계정 저장소는 간단히 말하면 특정 클레이튼 계정들의 그룹이며, 여러분의 애플리케이션에서 여러 형태의 트랜잭션을 보낼 때 클레이튼 계정들을 용도/역할에 따라 그룹별로 사용하도록 고안되었습니다.
Account Pools
Account Pools 메뉴에서는 클레이튼 계정을 보관하고 관리하는 계정 저장소를 만들거나 삭제할 수 있습니다. 여기서 만든 계정 저장소는 KRN이라는 값으로 표현되며 이 KRN값을 x-krn이라는 API 호출 헤더에 입력하면 이 계정 저장소를 사용할 수 있습니다.
사용자가 자신만의 계정 저장소를 만들지 않아도 사용자가 API를 호출할 때 KAS는 기본 계정 저장소를 제공합니다. KAS에서 기본 제공하는 계정 저장소를 사용하지 않고, 자신만의 계정 저장소를 만들어 이 저장소에 있는 클레이튼 계정을 골라 API를 호출하려면 Accounts 메뉴에서 여러분의 계정 저장소를 먼저 만들어야 합니다.
Fee-payer Pools
Fee-payer Pools 메뉴에서는 KAS API로 클레이튼에 트랜잭션을 보낼 때 보내는 클레이튼 계정을 대신해 트랜잭션 수수료를 납부하는 계정을 만들 수 있습니다. Fee-payer Pools 메뉴에서는 수수료 대납 계정 저장소를 생성하거나 삭제할 수 있습니다.
또 생성한 수수료 대납 계정 저장소를 클릭하고 상세 화면으로 들어가면 이 계정 저장소에 수수료 대납 계정을 KAS 콘솔상에서 바로 생성할 수 있습니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
Anchor
Anchor 메뉴에서는 서비스 체인 데이터를 클레이튼 메인 체인에 앵커링하는 클레이튼 계정인 오퍼레이터를 생성할 수 있습니다. Anchor - Operators 메뉴에서는 오퍼레이터 계정을 만들거나 삭제할 수 있습니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
KIP
KIP-7, KIP-17 메뉴에서는 KIP-7, KIP-17 컨트랙트를 쉽게 배포하고 관리할 수 있으며, API를 통해 토큰 발행, 소각, 정지, 재개 등의 많은 기능을 사용하실 수 있습니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
My Page
KAS 콘솔 - My Page에는 My Info, Change Password, My ERC Tokens 메뉴가 있습니다.
My Info
My Info 메뉴에서는 여러분의 계정 정보를 확인하고 이를 업데이트하거나 계정을 삭제할 수 있습니다.
Account Security
Account Security 메뉴에서는 KAS 회원 계정의 비밀번호를 변경할 수 있는 메뉴와 2단계 인증을 할 수 있는 MFA(Multi-factor Authentication) 설정 기능이 있습니다.
My ERC Tokens
My ERC Tokens 메뉴에서는 여러분의 ERC-20, ERC-721 토큰을 라벨링(Labeling)할 수 있습니다. 라벨링이란, 여러분의 ERC-20, ERC-721 토큰 정보와 토큰 전송 기록을 Token History API가 추적하도록 토큰 정보를 KAS에 등록하는 것입니다.
이 메뉴에서는 토큰 등록 신청, 등록 신청한 토큰 목록 조회, 그리고 삭제 기능을 제공합니다.
KIP-7, KIP-17 토큰은 정보를 KAS에서 자동으로 추적하므로 라벨링할 필요가 없습니다.
등록을 요청하려면 등록할 토큰 컨트랙트 주소(SCA)와 여러분이 컨트랙트 배포 주체임을 입증할 서명값을 입력하고, 배포할 때 사용한 옵션과 컨트랙트 소스코드를 제출해야 합니다.
서명값:
caver.klay.accounts.sign({contract_address}, {private_key})실행으로 얻은 값옵션: 토큰 타입(ERC-20, ERC-721), 솔리디티 컴파일러 버전, Optimize 여부
컨트랙트 소스코드: 토큰 컨트랙트를 솔리디티로 작성한 소스코드 파일(.sol 확장자)
위 서명값을 얻으려면 다음 작업이 필요합니다.
배포된 토큰 컨트랙트의 주소(
{contract_address})토큰 컨트랙트를 배포하는 트랜잭션을 보낼 때 사용한 개인키(
{private_key})
서명값을 얻는 방법에 관한 자세한 내용은 KAS 콘솔 - My Page - My ERC Tokens 메뉴를 확인하십시오.
KAS는 서명값을 이용해 토큰 컨트랙트를 클레이튼에 배포한 주체와 KAS 콘솔에서 이 토큰 컨트랙트 등록을 신청한 주체가 동일한지를 확인하며 제출된 컨트랙트 소스코드가 표준 인터페이스를 따르는지 확인합니다. 만약 모든 조건에 부합하다면 토큰 등록이 시작됩니다.
토큰 등록에는 몇 분 내외가 소요되며 등록 여부는 화면에서 목록 상태값으로 확인할 수 있습니다. 등록 신청 과정에서 토큰 타입이나 컴파일러 버전, Optimize 여부를 잘못 입력했거나 잘못된 컨트랙트 소스코드를 제출한 경우 다시 신청할 수 있는 페이지를 제공합니다.
이 문서 혹은 KAS에 관한 문의는 개발자 포럼을 방문해 도움을 받으십시오.
Billing
Billing 메뉴에는 KAS 사용자의 서비스 사용량과 금액을 확인할 수 있습니다. KAS 유료 사용자는 KAS 서비스 사용량에 대한 금액을 확인할 수 있으며, 수동 결제 또는 Toss Payment 서비스를 통한 신용카드 자동결제를 등록할 수 있습니다.
Project
Project 메뉴에서는 KAS 리소스에 대한 액세스 권한을 제어할 수 있는 기능을 제공합니다. KAS 계정을 통해 발급받은 Credential을 통해 KAS 서비스에 완전하게 접근할 수 있지만, Project 서비스를 사용하면 API 호출을 제한하고, 구체적인 가용 액션, API 및 하위 액션을 정의할 수 있습니다. Account Security 메뉴에는 KAS 회원 계정의 비밀번호를 변경할 수 있는 메뉴와 2단계 인증을 할 수 있는 MFA(Multi-factor Authentication) 설정 기능이 있습니다.
Project에 관한 자세한 내용은 다음을 확인하십시오.
Last updated
