도매 CBDC 샘플 애플리케이션에 대한 Oracle Blockchain Platform 구성

Oracle Blockchain Platform의 모든 필수 인스턴스 및 필수 제품을 만든 후에는 사용자 및 역할을 구성하고, 참가자 조직을 설립자 조직에 추가하고, 풍부한 기록 데이터베이스를 사용으로 설정해야 합니다.

Oracle Blockchain Platform 인스턴스에 대한 IDCS 그룹 구성

내장된 Oracle Blockchain Platform 롤 및 롤에 사용자를 지정하는 방법에 대한 자세한 내용은 사용자 및 애플리케이션 롤 설정을 참조하십시오.

도매 CBDC 샘플 애플리케이션 역할에 대한 자세한 내용은 도매 CBDC 애플리케이션 워크플로우를 참조하십시오.

Oracle Blockchain Platform에서 다음 애플리케이션 롤 지정을 구현해야 합니다.

시스템 소유자 그룹: 시스템 소유자 Oracle Blockchain Platform Digital Assets Edition 인스턴스의 REST_CLIENT 애플리케이션 롤에 결합된 단일 시스템 소유자 IDCS 그룹(모든 시스템 소유자 페르소나 포함)을 지정합니다. 개별 개인별 그룹을 Oracle Blockchain Platform Digital Assets Edition 인스턴스에 직접 지정하지 마십시오.
참가자 조직 그룹: 각 참가자 조직에 대해 결합된 단일 참가자 조직 IDCS 그룹(해당 조직에 대한 모든 개인별 그룹 포함)을 해당 Oracle Blockchain Platform Digital Assets Edition 인스턴스의 REST_CLIENT 애플리케이션 롤에 지정합니다.
관리 역할: 관련 관리 그룹(예: System_Admins 및 Org1_Admins)을 해당 Oracle Blockchain Platform Digital Assets Edition 인스턴스의 ADMIN 애플리케이션 역할에 지정합니다.

이 구성을 통해 시스템 소유자 및 참여 조직 그룹 모두 REST_CLIENT 롤을 통해 필요한 액세스 권한을 가지며, 관리 권한은 ADMIN 롤을 통해 적절하게 관리됩니다.

다음 단계에 따라 애플리케이션 롤에 그룹을 지정합니다.

Oracle Cloud Infrastructure 계정에 사인인합니다.
콘솔에서 왼쪽 상단 모서리에 있는 탐색 메뉴를 누릅니다.
ID에서 도메인을 선택합니다.
[도메인] 페이지에서 Oracle Identity Cloud Service를 누릅니다.
Oracle Identity Cloud Service 탐색 메뉴에서 Oracle Cloud Services를 선택합니다. 그룹 롤을 지정할 Oracle Blockchain Platform 인스턴스를 찾습니다. 해당 인스턴스의 세부 정보 페이지를 엽니다.
[애플리케이션 롤] 페이지로 이동하여 리소스 네비게이터에 나열된 Oracle Identity Cloud Service 애플리케이션 롤을 봅니다.
지정하려는 롤을 선택하고 롤을 확장합니다. 역할에 대한 More 메뉴를 누르고 Assign Groups를 선택합니다.
그룹 지정 대화상자에서 역할에 지정할 그룹을 선택하고 지정을 누릅니다.

ClientId 및 ClientSecret 인출

Oracle Blockchain Platform ClientID 및 ClientSecret는 Visual Builder에서 사용됩니다. Visual Builder 백엔드 구성에 설명된 대로 나중에 Visual Builder에서 해당 매개변수를 업데이트해야 합니다.

Oracle Blockchain Platform 인스턴스에 대한 클라이언트 ID 및 클라이언트 암호를 검색하려면 다음 단계를 완료하십시오.

Oracle Cloud Infrastructure 계정에 사인인합니다. OAuth 설정을 관리할 수 있는 충분한 관리 권한이 있는지 확인합니다.
콘솔에서 왼쪽 상단 모서리에 있는 탐색 메뉴를 누릅니다.
ID에서 도메인을 선택합니다.
[도메인] 페이지에서 Oracle Identity Cloud Service를 누릅니다.
Oracle Identity Cloud Service 탐색 메뉴에서 Oracle Cloud Services를 선택합니다. 클라이언트 ID 및 클라이언트 암호를 인출할 Oracle Blockchain Platform 인스턴스를 찾습니다. 해당 인스턴스의 세부 정보 페이지를 엽니다.
인스턴스 세부정보 페이지를 열면 표시되는 기본 탭이 OAuth 구성 탭이 됩니다. 이 탭에는 Oracle Blockchain Platform 인스턴스의 OAuth 설정과 관련된 필수 정보가 포함되어 있습니다.
General Information 섹션에 Client ID 및 Client Secret이라는 필드가 있습니다. 이러한 인증서는 Oracle Blockchain Platform에 대한 API 요청을 인증하는 데 사용됩니다.

다중 조직 구성

여러 조직이 포함된 복잡한 Oracle Blockchain Platform 네트워크를 만드는 경우 설립자에 참가자를 추가하십시오. 이 프로세스에 대한 개요는 Oracle Blockchain Platform 관리 설명서: 네트워크에 OBCS 참가자 조직 추가에서 제공됩니다.

Oracle Blockchain Platform용 Rich History Database 구성

리치 내역 데이터베이스 구성 및 사용에 대한 자세한 내용은 리치 내역 데이터베이스 생성을 참조하십시오.

이 단계를 완료하기 전에 Oracle Blockchain Platform에 대한 풍부한 기록 데이터베이스를 사용으로 설정하려면 Autonomous Database 프로비저닝에 설명된 대로 Autonomous Database 인스턴스를 생성해야 합니다.

일반 모드에서 Oracle Blockchain Platform의 시스템 소유자 인스턴스에 대해 Oracle Autonomous Database의 단일 인스턴스를 구성합니다. 기밀 모드에서는 각 참가자 조직 및 시스템 소유자를 별도의 Oracle Autonomous Database 인스턴스로 구성해야 합니다.

네트워크 인스턴스에 대한 Oracle Blockchain Platform 콘솔을 엽니다.
오른쪽 상단 모서리에 있는 추가 작업 메뉴를 누르고 서식 있는 내역 구성을 선택합니다.
Oracle 데이터베이스에 액세스하고 쓸 수 있는 접속 문자열과 인증서를 제공하여 Oracle 데이터베이스 접속을 지정합니다. 제공하는 인증서는 데이터베이스의 인증서이며 Oracle Blockchain Platform은 이를 관리하지 않습니다.
저장을 눌러 리치 내역 데이터베이스를 구성합니다.

등록 생성

System_Admins 및 Org_Admins 그룹의 사용자에 대한 등록을 수동으로 생성해야 합니다.

Oracle Blockchain Platform의 REST 프록시 등록은 사용자가 등록 인증서 없이 블록체인과 상호 작용할 수 있는 메커니즘을 제공하여 애플리케이션 ID를 블록체인 멤버에 매핑하여 API 호출을 간소화합니다. 체인코드 호출을 시작하려면 Oracle Blockchain Platform에서 등록을 설정해야 합니다.

도매 CBDC 애플리케이션은 계정 설정 중 사용자에 대한 등록 생성을 관리합니다. 그러나 시스템 관리자가 처음 로그인할 때 등록이 존재하지 않습니다. 따라서 이 사용자가 계정을 만들려고 시도하면 RestProxy 호출이 실패합니다. 따라서 System_Admins 그룹에 대한 등록을 생성해야 합니다.

계정을 설정할 때 해당 조직에 대한 등록이 생성됩니다. 예를 들어, 시스템 소유자에 대한 계정이 설정되면 해당 등록이 생성됩니다. 그러나 시스템 관리자 페이지를 통해 가입자 조직 계정이 생성된 경우 해당 조직에 대한 등록이 자동으로 생성되지 않습니다. 이 도매 CBDC 워크플로우에서는 시스템 관리자 페이지에서 조직 관리자 계정을 설정해야 합니다. 따라서 중앙 은행과 금융 기관 간의 고유한 조직 구조로 인해 해당 등록이 자동으로 생성되지 않으므로 조직 관리자 그룹에 대한 등록을 수동으로 생성해야 합니다.

등록 생성 방법에 대한 자세한 내용은 REST 프록시에 등록 추가를 참조하십시오.

RestproxyId 가져오기

RestproxyId 값은 Visual Builder에서 사용됩니다. Visual Builder 백엔드 구성에 설명된 대로 나중에 Visual Builder에서 업데이트해야 합니다.

Oracle Blockchain Platform 인스턴스에 대한 RestProxyId을 검색하려면 관리 사용자 계정을 사용하여 Oracle Blockchain Platform 콘솔 API를 호출해야 합니다. 인증은 기본 인증 또는 OAuth 2.0을 사용하여 수행할 수 있습니다.

인증 방식

OAuth 2.0의 경우 OAuth 2.0 액세스 토큰 기반 인증의 설명서를 참조하여 필요한 인증 플로우를 구현하십시오.

RestProxyId 인출을 위한 API 끝점

다음 끝점으로 요청을 전송하여 Oracle Blockchain Platform 콘솔 API를 사용하여 RestProxyId를 가져옵니다.

GET <oracleblockchainplatform_url>/console/admin/api/v2/nodes

이 API 호출은 인스턴스에 구성된 REST 프록시에 대한 세부정보를 포함하는 응답을 반환합니다.

콘솔 API에 대한 자세한 내용은 다음 설명서를 참조하십시오. Get Node List

응답 세부정보

응답에서 RESTProxies라는 섹션을 찾습니다. 여기서 해당하는 RestProxyId을 찾을 수 있습니다. 응답 구조에는 각 REST 프록시 노드와 연관된 다양한 속성이 포함됩니다.

"RESTProxies": [
        {
            "status": "up",
            "extInfo": [],
            "displayName": "restproxy",
            "RESTProxyId": "48021a2c-e62b-40cd-b7ca-71dda883521d-restproxy",
            "url": "https://bank3-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy",
            "mspId": "Bank3"
        }
    ]

도매 CBDC 샘플 애플리케이션에 대한 체인 코드 배포

이제 채널을 생성하고 샘플 애플리케이션 체인코드를 여기에 배치할 수 있습니다.

채널 생성.
1. 조직 요구사항에 따라 필요한 참가자와 함께 새 채널을 정의합니다.
2. 채널 생성 프로세스 중 서식 있는 기록 사용이 선택되어 있는지 확인합니다. 이 옵션은 이전에 구성된 리치 내역 기능을 활성화합니다.
3. 기밀 모드만 해당: 개인 데이터 수집의 경우 모든 개인 데이터 수집에 대한 액세스를 허용하려면 별표(*)를 입력합니다.
  이 단계를 완료하지 않으면 개인 데이터 수집에서 반환된 데이터가 정확하지 않습니다.
4. Confidential 모드만 해당: 네트워크의 다른 모든 참여자 조직에 대해 이전 두 단계(이전에 생성된 채널의 풍부한 기록 및 전용 데이터 수집에 대한 액세스 사용)를 반복합니다.
체인 코드를 배치합니다.
- 일반 모드: 도매 CBDC 체인코드 패키지를 다운로드하고 그 안에 있는 아카이브 파일(WholesaleCBDC.zip)을 새 채널에 배포하여 도매 CBDC 체인코드를 배포합니다. 패키지 이름은 Wholesale CBDC입니다.
- 기밀 모드: 기밀 도매 CBDC 체인코드 패키지를 다운로드하고 그 안에 아카이브 파일(WholesaleCBDC-Confidential.zip)을 새 채널에 배포하여 기밀 도매 CBDC 체인코드를 배포합니다. 패키지 이름은 WholesaleCBDCConfidential입니다.
체인코드를 배포하는 방법에 대한 자세한 내용은 체인코드를 배포하는 일반적인 워크플로우를 참조하십시오.
도매 CBDC 체인코드 패키지에 제공된 도매 CBDC Postman 컬렉션 또는 기밀 도매 CBDC 체인코드 패키지의 기밀 도매 CBDC Postman 컬렉션을 적절하게 사용하여 init API에 전화하십시오. 이 단계에서는 초기화 프로세스를 완료하여 체인코드를 사용할 준비가 되었는지 확인합니다.
도매 CBDC 체인코드 패키지 또는 기밀 도매 CBDC 체인코드 패키지를 참조하십시오.
복제 상태를 확인합니다.
1. Channels(채널) 탭으로 이동합니다.
2. 채널을 찾고 채널 항목 오른쪽에 있는 More Actions(추가 작업) 메뉴를 누릅니다.
3. 복제 상태를 보려면 서식 있는 내역 상태를 선택합니다.
  - 상태가 REPLICATING인 경우 채널 데이터가 풍부한 기록 데이터베이스에 적극적으로 복제됩니다.
  - 복제 상태가 USER_DISABLED인 경우 다음 작업을 완료합니다.
    1. 피어 다시 시작: 채널과 연관된 피어 노드를 다시 시작합니다.
    2. 트랜잭션 시작: 채널에서 모든 트랜잭션을 트리거하여 데이터 복제를 시작합니다.
    3. 복제 상태를 다시 검사하여 데이터가 리치 내역 데이터베이스로 복제되고 있는지 확인합니다.

채널 이름 및 체인코드 이름을 확인합니다. 샘플 애플리케이션을 사용하려면 Visual Builder를 구성해야 합니다.

서식 있는 내역 데이터베이스 뷰 생성

Oracle Blockchain Platform 인스턴스에 대한 풍부한 기록 데이터베이스를 생성한 후 데이터베이스 뷰 생성 스크립트를 실행하여 풍부한 기록 데이터베이스에 뷰를 생성하고 ORDS 엔드포인트를 생성할 수 있습니다.

ORDS(Oracle REST Data Services) 스크립트는 풍부한 기록 데이터베이스에서 계정 트랜잭션 세부정보를 검색하기 위해 ORDS 엔드포인트를 노출하도록 설계된 TypeScript로 작성된 Node.js 애플리케이션입니다. 사용자가 풍부한 기록 데이터베이스에서 체인코드 트랜잭션 데이터(TypeScript 및 Go 체인코드 모두)를 인출할 수 있는 RESTful 끝점을 생성합니다. 또한 끝점 인증 및 액세스를 위해 ORDS 끝점, clientId, clientSecret 및 Bearer 토큰과 같은 필수 인증서를 제공합니다.

데이터베이스 뷰 생성 스크립트를 다운로드합니다.
1. Oracle Blockchain Platform 콘솔을 엽니다.
2. 디지털 자산 페이지로 이동합니다.
3. 왼쪽 사이드바에서 도매 CBDC 응용 프로그램으로 이동합니다.
4. WholesaleCBDC에 대한 Oracle Database 뷰 정의 영역에서 스크립트를 다운로드합니다.
스크립트를 다운로드한 후 실행 방법에 대한 자세한 내용은 Oracle Database View Definitions for Wholesale CBDC를 참조하십시오.

이 스크립트는 ORDS 끝점, 클라이언트 ID, 클라이언트 암호 및 Bearer 토큰을 반환합니다.

일반 모드에서는 모든 조직이 단일 ORDS 끝점 구성을 사용합니다. 이 스크립트는 개별 계정, 조직 레벨 계정 및 모든 계정의 세 가지 범위에서 계정에 대한 끝점을 반환합니다.

{
  ORDSEndpoint: 'https://<base_URL>ords/<user_name|alias>/<resource_link>',
 {
  "ORDSEndpoint": {
    "Accounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERN",
    "OrgAccounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERNOrgAccounts",
    "AllAccounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERNAllAccounts"
  },
  clientId: '<clientId>',
  clientSecret: '<clientSecret>',
  bearerToken: {
    access_token: '<BearerToken>',
    token_type: 'bearer',
    expires_in: 3600
  }
}

기밀 모드에서는 시스템 소유자를 포함한 모든 조직에 고유한 ORDS 구성이 있습니다. 시스템 소유자 끝점에는 모든 계정에 대한 액세스가 포함됩니다. 가입자 조직은 자신의 조직 레벨 계정에만 액세스할 수 있습니다.

시스템 소유자:

{
  ORDSEndpoint: 'https://<base_URL>ords/<user_name|alias>/<resource_link>',
 {
  "ORDSEndpoint": {
    "Accounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERN",
    "OrgAccounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERNOrgAccounts",
    "AllAccounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERNAllAccounts"
  },
  clientId: '<clientId>',
  clientSecret: '<clientSecret>',
  bearerToken: {
    access_token: '<BearerToken>',
    token_type: 'bearer',
    expires_in: 3600
  }
}

참가자 조직:

{
  ORDSEndpoint: 'https://<base_URL>ords/<user_name|alias>/<resource_link>',
 {
  "ORDSEndpoint": {
    "Accounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERN",
    "OrgAccounts": "https://<base_URL>ords/ALIAS_NAME/BASE_PATH/PATTERNOrgAccounts"
  },
  clientId: '<clientId>',
  clientSecret: '<clientSecret>',
  bearerToken: {
    access_token: '<BearerToken>',
    token_type: 'bearer',
    expires_in: 3600
  }
}

RESTful 서비스에 액세스하기 위한 ORDS 끝점은 다음 구조를 따릅니다.

ORDS_REST_BASE_URL/ords/ALIAS_NAME/BASE_PATH/PATTERN

ORDS_REST_BASE_URL: ORDS 서비스의 기본 URL입니다.
ALIAS_NAME: ORDS에 구성된 데이터베이스 또는 스키마 별칭입니다.
BASE_PATH: RESTful 서비스의 기본 경로입니다.
PATTERN: RESTful 서비스에 대한 특정 끝점 패턴입니다.

인증을 위해 Bearer 토큰을 생성하려면 OAuth2 토큰 끝점을 사용합니다.

ORDS_REST_BASE_URL/ords/ALIAS_NAME/oauth/token

풍부한 내역 데이터베이스에서 데이터를 검색하려면 Visual Builder의 백엔드에서 ORDS와 관련된 다음 매개변수를 업데이트해야 합니다. 이 작업은 나중에 Visual Builder 백엔드 구성에서 완료됩니다.

clientId
clientSecret
ORDS 끝점(Accounts 끝점만 해당, OrgAccounts 및 AllAccounts 끝점은 내부적으로 파생됨)
OAuth 기본 URL: ORDS_REST_BASE_URL/ords/<userName|aliasName>