REST 프록시 노드 관리

이 항목에는 REST 프록시 사용 방법을 이해하고, REST 프록시에 등록을 추가하고, REST 프록시 노드를 보고 편집하는 데 도움이 되는 정보가 포함되어 있습니다.

REST 프록시 사용 방법

REST 프록시는 애플리케이션 ID를 블록체인 멤버에 매핑하여 사용자와 애플리케이션이 Oracle Blockchain Platform REST API를 호출할 수 있도록 합니다.

Oracle Blockchain Platform은 네이티브 Hyperledger Fabric API를 사용하는 대신 REST 프록시를 사용하여 Hyperledger Fabric 네트워크와 상호 작용할 수 있습니다. 고유 Hyperledger Fabric API를 사용하는 경우 피어 및 주문자에 직접 연결합니다. However, the REST proxy allows you to query or invoke a Fabric chaincode through the RESTful protocol.

REST 프록시에 등록 추가

REST 프록시에 Hyperledger Fabric 등록을 추가할 수 있습니다. 등록을 통해 사용자는 등록 인증서 없이 REST 프록시를 호출할 수 있습니다.

등록에 사용자를 추가하려면 IDCS에 이미 있고 REST_USER 롤에 지정되어 있어야 합니다.

블록체인 플랫폼 콘솔을 사용하여 새 등록을 추가하고 IDCS 사용자를 해당 등록과 연관시킵니다. 등록은 IDCS가 아닌 블록체인 플랫폼 내에서 전적으로 관리됩니다.

사용자가 REST 리소스에 액세스하는 방법에 대한 자세한 내용은 REST API for Oracle Blockchain Platform를 참조하십시오.

1. 콘솔로 이동하고 노드 탭을 선택합니다.
2. 노드 탭에서 등록을 추가할 REST 프록시 노드를 찾아서 이 노드에 대한 작업 메뉴를 누릅니다.
3. 등록 보기 또는 관리를 눌러 노드의 현재 등록 목록을 확인합니다.
   현재 등록 목록이 표시됩니다. 기존 등록을 삭제하고 이 페이지에서 신규 등록을 추가할 수 있습니다.
4. 새 등록 생성을 확장합니다.
5. 등록 ID 필드에 추가할 등록 이름을 입력합니다.
   등록 ID에는 영숫자, 하이픈(-) 및 밑줄(_)만 포함될 수 있습니다.
6. 선택적으로 사용자 ID 필드에 등록과 연계할 REST_USER 역할을 가진 사용자의 ID를 입력합니다. 등록을 누릅니다.
   등록을 누른 후 다음을 수행합니다.

   • 등록이 생성되고 등록 테이블에 표시됩니다.
   • 새 등록이 네트워크의 각 REST 프록시 노드에 복사됩니다.
   • 사용자 ID를 지정한 경우 해당 ID는 등록과 연계되며 연계된 REST 사용자 목록에서 제거할 수 없습니다. 사용자 ID가 적합한 REST 사용자가 아닌 경우 오류가 반환됩니다.
   • 사용자 ID를 지정한 경우 생성된 등록 인증서에 ID가 username 속성으로 포함됩니다.
   • 기본 인증을 사용하는 REST API 호출에 대해서는 콜론(:)이 포함된 사용자 ID가 지원되지 않습니다.
7. 연관된 REST 클라이언트 사용자 창에서 등록에서 사용자 삭제를 포함하여 현재 등록과 연관된 모든 사용자를 보고 관리할 수 있습니다.
8. 새 사용자 연관을 확장하여 등록에 다른 사용자를 추가합니다. 이미 REST_USER 역할이 지정된 사용자의 전자메일 또는 ID를 입력합니다. 연계를 누릅니다.

등록을 생성하고 사용자를 연관된 후 REST를 사용하여 블록체인에서 트랜잭션을 실행하면 블록 세부정보에 나열된 개시자가 원래 기본 사용자가 아닌 새 등록으로 나열됩니다.

REST 프록시 노드 구성 보기 및 편집

REST 프록시 노드의 구성에 따라 네트워크에서 노드가 수행되고 작동하는 방식이 결정됩니다.

관리자만 노드의 구성을 변경할 수 있습니다. 사용자 권한이 있는 경우 노드의 구성 설정을 볼 수 있습니다. REST 프록시 노드 속성을 참조하십시오.

1. 콘솔로 이동하고 노드 탭을 선택합니다.
2. 노드 탭에서 [노드] 테이블로 이동하고 구성 정보를 사용할 REST 프록시 노드를 찾은 다음 노드의 추가 작업 단추를 누릅니다.
3. 구성 옵션은 사용 권한에 따라 결정됩니다. 관리자인 경우 구성 편집을 찾아 누릅니다. 사용자인 경우 보기를 찾아 누릅니다.
   구성 대화상자가 표시됩니다.
4. 관리자인 경우 노드의 제안 대기 시간(밀리초), 트랜잭션 대기 시간(밀리초), 로그 레벨 및 트랜잭션 이벤트 로깅 속성을 필요에 따라 수정합니다.
5. 제출을 눌러 구성 변경사항을 저장하거나 X를 눌러 구성 대화상자를 닫습니다.

REST 프록시 노드에 대한 건전성 정보 보기

REST 프록시 노드의 측정지표를 확인하여 블록체인 네트워크에서 노드가 어떻게 작동하는지 확인할 수 있습니다. 이 정보를 통해 성능 문제를 발견하고 진단할 수 있습니다.

Health 창에는 CPU 활용률 및 메모리 활용률과 같은 성능 측정항목이 표시됩니다.

1. 콘솔로 이동하고 노드 탭을 선택합니다.
2. 노드 탭에서 건전성 정보를 볼 REST 프록시 노드를 누릅니다.
   노드 정보 페이지가 표시됩니다.
3. 건전성 창을 눌러 노드의 성능 측정항목을 봅니다.
   활용률 백분율이 지속적으로 높은 경우 Oracle Support에 문의하십시오.