REST 프록시 노드 관리

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

REST 프록시 사용 방법

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

Oracle Blockchain Platform은 네이티브 Hyperledger Fabric API를 사용하는 대신 REST 프록시를 사용하여 Hyperledger Fabric 네트워크와 상호 작용할 수 있습니다. 네이티브 Hyperledger Fabric API를 사용하는 경우 피어 및 주문자에 직접 연결할 수 있습니다. 그러나 REST 프록시를 사용하면 RESTful 프로토콜을 통해 Fabric 체인 코드를 쿼리하거나 호출할 수 있습니다.

REST 프록시에 등록 추가

등록을 통해 사용자는 등록 인증서 없이 REST 프록시를 호출할 수 있습니다. 등록하려면 인증 서버에 새 사용자 그룹을 정의해야 합니다.

Microsoft Active Directory를 인증 서버로 사용할 때 등록 추가

REST 프록시에 등록을 추가하려면 새 사용자 그룹을 Active Directory에 추가해야 합니다(<Rest Proxy Client Users group name>_<custom enrolment name>). 그런 다음 Blockchain Platform 콘솔을 사용하여 등록을 이 그룹에 매핑할 수 있습니다.

  1. <Rest Proxy Client Users group name>_<custom enrolment name>이라는 새 Active Directory 그룹을 만듭니다.
  2. 이 그룹에 사용자정의 등록을 사용해야 하는 사용자를 추가합니다.
  3. Blockchain Platform 콘솔로 이동하여 Nodes(노드) 탭을 선택합니다.
  4. 노드 탭에서 등록을 추가할 REST 프록시 노드를 찾아 작업 더 보기 메뉴를 엽니다.
  5. 노드의 현재 등록 목록을 보려면 등록 보기 또는 생성을 누릅니다.
  6. 새 등록 생성을 누릅니다.
  7. 사용자 이름 필드에 첫번째 단계의 <custom enrolment name>를 입력합니다. 대소문자를 구분하며 생성한 유저 그룹과 일치해야 합니다. 등록을 누릅니다.
    • 등록이 생성되고 등록 테이블에 표시됩니다.
    • 새 등록이 네트워크의 각 REST 프록시 노드에 복사됩니다.

OpenLDAP 또는 Oracle Internet Directory를 인증 서버로 사용할 때 등록 추가

REST 프록시에 등록을 추가하면 LDAP 서버의 OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> 그룹에 새 사용자 롤이 생성됩니다.

콘솔에 등록이 생성된 후 관리자는 LDAP 서버를 사용하여 필요한 사용자를 이 역할에 지정합니다.

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

  1. 콘솔로 이동하여 노드 탭을 선택합니다.
  2. 노드 탭에서 등록을 추가할 REST 프록시 노드를 찾아 작업 더 보기 메뉴를 엽니다.
  3. 노드의 현재 등록 목록을 보려면 등록 보기 또는 생성을 누릅니다.
  4. 새 등록 생성을 누릅니다.
    새 등록 생성 대화상자가 표시됩니다.
  5. 사용자 이름 필드에 등록에 대한 이름을 입력합니다. 등록을 누릅니다.
    등록을 누른 후 다음을 수행합니다.
    • 등록이 생성되고 등록 테이블에 표시됩니다.
    • 새 등록이 네트워크의 각 REST 프록시 노드에 복사됩니다.
    • LDAP 서버의 OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> 그룹에 있는 새 사용자 역할입니다.

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

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

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