Gerenciar Canais
Este tópico contém informações sobre como gerenciar os canais em sua rede, como criar e exibir canais, como ingressar em colegas e designar e ancorar pares, como trabalhar com políticas e listas de controle de acesso e como associar solicitantes a um canal.
O que São Canais?
Os canais particionam e isolam pares e dados contábeis para fornecer transações privadas e confidenciais na rede blockchain.
- Pares
- Um razão compartilhado
- Chaincodes implantados no canal
- Um ou mais nós de serviço de solicitação
- Definições de política de canal e ACLs nas quais as definições são aplicadas
Cada par que se junta a um canal tem sua própria identidade que o autentica para os pares e serviços do canal. Embora os pares possam pertencer a vários canais, as informações sobre transações, estado do razão e associação ao canal são restritas a pares dentro de cada canal.
Você pode usar o console do Oracle Blockchain Platform ou o SDK do Hyperledger Fabric para criar canais na sua rede blockchain. Consulte Exibir Canais.
Exibir Canais
Os membros da sua rede usam canais para comunicar informações de transações blockchain de forma privada.
Criar um Canal
Você pode adicionar canais à rede e especificar quais membros podem usar o canal e quais colegas podem se associar ao canal. Não é possível excluir canais.
Você deve ser um administrador para concluir esta tarefa.
-
Implante um chaincode no canal. Consulte Implantar um Chaincode.
-
Se a rede contiver participantes, esses participantes usarão seus consoles para se juntar aos colegas membros no canal. Consulte Entrar em um Par com um Canal.
Exibir a Atividade do Razão de um Canal
Use o razão para localizar informações resumidas e estatísticas de tempo de execução para transações em um canal específico.
Exibir ou Atualizar a Lista de Organizações de um Canal
Você pode exibir a lista das organizações que têm acesso ao canal. Se você criou o canal, poderá alterar as permissões de uma organização no canal e poderá adicionar ou remover organizações do canal
Associar-se a um Canal
Você pode adicionar um nó de mesmo nível a um canal para que o nó possa usá-lo para trocar informações de transação privada com outros nós de mesmo nível no canal.
-
Ao criar um canal, você especifica quais nós de mesmo nível locais podem se associar ao canal.
-
Se você estiver criando uma rede que contenha um participante, poderá selecionar o participante como membro no canal. Ou você pode adicionar o participante após a criação do canal.
-
Sua instância tem vários domínios de disponibilidade ou domínios de falha, e a Oracle recomenda que você junte um par de cada partição ao canal. Isso ocorre porque, se um nó de trabalho estiver indisponível, o canal ainda estará disponível para endossos e confirmações. Para determinar em qual domínio um par está localizado, no menu Mais Ações, selecione Mostrar Informações do AD para ver as informações do domínio de disponibilidade.
- Você pode participar de um máximo de sete pares de cada domínio.
Consulte Criar um Canal.
Você deve ser administrador para executar esta tarefa.
Adicionar um Par de Âncora
Cada membro usando um canal deve designar pelo menos um ponto de ancoragem. Os pares de âncora são pontos de contato de rede principais e são usados para descobrir e se comunicar com outros pares de rede no canal.
Você pode designar um ou mais pares em sua organização como um ponto de ancoragem em um canal. Para uma rede de alta disponibilidade, você pode especificar dois ou mais pares de âncora. Todos os membros que usam o canal de rede devem usar sua console para designar um ou mais de seus nós pares como pontos de ancoragem.
Você deve ser administrador para executar esta tarefa.
Alterar ou remover um par de âncora
Você pode alterar ou remover os pares de âncora de um canal. Os pares de âncora são pontos de contato de rede principais e são usados para descobrir e se comunicar com outros pares de rede no canal.
Antes de alterar ou remover os pares de âncora do canal, observe as seguintes informações:
- Para se comunicar no canal, você deve designar um ou mais pares em sua organização como um ponto de ancoragem.
- Para uma rede de alta disponibilidade, você pode especificar dois ou mais pares de âncora.
- Todos os membros que usam o canal de rede devem usar sua console para designar um ou mais de seus nós pares como pontos de ancoragem.
Você deve ser administrador para executar esta tarefa.
Exibir Informações sobre Chaincodes Implantados
Você pode exibir informações sobre os chaincodes implantados nos diferentes canais da sua rede.
- Vá para a console e selecione a guia Canais.
- Na tabela de canais, clique no nome do canal com o chaincode cujas informações você deseja exibir.
- Na página Informações do Canal, confirme se o painel Códigos de Cadeia Implantados está selecionado
- Na tabela chaincode, é possível:
- Clique no ID pacote chaincode para ir até a guia Chaincodes para obter mais informações sobre ele. Por exemplo, os pares nos quais o chaincode está instalado e os canais nos quais o chaincode está implantado.
- No menu Mais Ações de um chaincode, clique em Exibir Definição de Chaincode para localizar detalhes sobre a definição do chaincode, incluindo a política de endosso.
- (Opcional) Se você vir uma listagem de canais sem um chaincode, poderá ir até a guia Chaincodes e implantar um chaincode no canal. Consulte Implantar um Código de Cadeia.
Acesso a ACLs e Políticas de Canal
Este tópico contém informações sobre as políticas de um canal e as listas de controle de acesso (ACLs). Ele fornece uma visão geral de quais políticas são, tipos de política e como modificá-las, bem como como como usar ACLs para gerenciar quais organizações e atribuições podem acessar os recursos de um canal.
O que são políticas de canal?
Uma política define um conjunto de condições. As partes requeridas devem cumprir as condições da política antes que suas assinaturas sejam consideradas válidas e a solicitação correspondente ocorra na rede.
A rede blockchain é gerenciada por essas políticas. As políticas verificam a identidade associada a uma solicitação na política associada ao recurso necessário para atender à solicitação. As políticas estão localizadas na configuração do canal.
Depois de configurar as políticas do canal, designe-as aos recursos de ACLs do canal para determinar quais membros devem assinar para que uma alteração ou ação possa acontecer no canal. Por exemplo, suponha que você tenha modificado a política Writers para incluir membros da Organização A ou da Organização B. Em seguida, você designou a política Writers ao recurso de ACL cscc/GetConfigBlock do canal. Agora, somente um membro da Organização A ou da Organização B pode chamar GetConfigBlock no componente cscc.
Quais são os tipos de política?
Há dois tipos de política: Assinatura e ImplicitMeta.
- Assinatura — Especifica uma combinação de regras de avaliação. Ele suporta combinações de AND, OR e NOutOf. Por exemplo, você pode definir algo como "Um administrador da org A e 2 outros administradores" ou "11 de 20 administradores da org".
Quaisquer novas políticas que você criar serão políticas de assinatura.
- ImplicitMeta — Esse tipo de política só é válido no contexto da configuração. Ele agrega o resultado da avaliação de políticas mais profundas na hierarquia de configuração, que são definidas por políticas de Assinatura. Ele suporta regras padrão, por exemplo, "A maioria das políticas de administração da organização".
Quando as Políticas São Criadas?
Quando você adiciona um canal à rede, o Oracle Blockchain Platform cria políticas padrão. As políticas padrão são: Administradores, Gravadores, Leitores, Endosso, LifecycleEndorsement (políticas ImplicitMeta) e Criador (política de Assinatura). Você pode modificar essas políticas conforme necessário ou criar políticas.
Observe o seguinte problema importante sobre políticas de canal:
-
Você pode usar a console para criar um canal e definir a ACL da sua organização como ReaderOnly. Depois de salvar o novo canal, você não poderá atualizar essa definição de ACL na opção Editar Organização do canal.
No entanto, você pode usar a funcionalidade Gerenciar Políticas de Canal da console para adicionar sua organização à política de Gravadores, que substitui a definição de ACL ReaderOnly do canal.
Adicionar ou Modificar as Políticas de um Canal
Você pode adicionar ou modificar a política de um canal para especificar quais membros são necessários para executar uma ação específica no canal. Depois de definir políticas, designe-as às ACLs do canal.
Antes de adicionar ou atualizar políticas, você precisa entender como o Oracle Blockchain Platform cria políticas de canal padrão. Consulte O Que São Políticas de Canal?.
Você deve ser administrador para executar esta tarefa.
- Vá para a console e selecione a guia Canais.
A guia Canais é exibida e a tabela de canais contém uma lista de todos os canais da sua rede.
- Na tabela de canais, clique no nome do canal ao qual você deseja adicionar políticas ou modificar políticas.
A página Informações do Canal é exibida.
- Na página Informações do Canal, clique no painel Políticas do Canal.
- Execute uma das seguintes etapas:
- Para adicionar uma nova política, clique no botão Criar uma Nova Política. A caixa de diálogo Criar Política é exibida. Informe um nome no campo Nome da Política e selecione Assinatura no campo Tipo de Política. Expanda a seção Política de Assinatura.
- Para modificar uma política existente, clique no nome de uma política. A caixa de diálogo Atualizar Política é exibida.
- Clique no botão Adicionar Identidade para adicionar uma organização. Ou modifique uma política de assinatura existente conforme necessário. Observe as seguintes informações:
Campo Descrição ID MSP No menu suspenso, selecione a organização que deve assinar a apólice. Atribuição Selecione a atribuição de mesmo nível correspondente exigida pela política. Normalmente, este será um membro. Você pode encontrar a atribuição de um par exibindo suas informações de configuração. Modo de Expressão da Política Na maioria dos casos, você usará o Básico. Selecione Avançado para escrever uma string de expressão usando AND, OR e NOutOf. Para obter informações sobre como gravar uma string de expressão de política válida, consulte Políticas de endosso na documentação do Hyperledger Fabric. Assinado por Selecione quantos membros devem assinar a política para atender à solicitação. - Se você estiver adicionando uma nova política, clique em Criar. Se você estiver modificando uma política, clique em Atualizar.
Excluir as Políticas de um Canal
Você pode excluir políticas de canal que criou.
Não é possível excluir as políticas padrão: Administradores, Criador, Leitores, Gravadores, Endosso e LifecycleEndorsement. Além disso, não será possível excluir uma política de canal se ela estiver designada a uma ACL. Antes de tentar excluir uma política de canal, confirme se a política não foi designada.
Você deve ser administrador para executar esta tarefa.
- Vá para a console e selecione a guia Canais.
A guia Canais é exibida e a tabela de canais contém uma lista de todos os canais da sua rede.
- Na tabela de canais, clique no canal do qual deseja excluir uma política.
A página Informações do Canal é exibida.
- Na página Informações do Canal, clique no painel Políticas do Canal.
- Localize a política que você deseja excluir e clique no botão Mais Opções.
- Clique em Remover e confirme a exclusão.
O Que São ACLs de Canal?
As listas de controle de acesso (ACLs) usam políticas para gerenciar quais organizações e atribuições podem acessar os recursos de um canal.
Os usuários interagem com a rede blockchain direcionando componentes como o chaincode do sistema de consulta (qscc), chaincode do sistema de ciclo de vida (_lifecycle), chaincode do sistema de configuração (cscc), peer e evento. Esses componentes são associados a recursos específicos (por exemplo, GetConfigBlock ou GetChaincodeData) aos quais você pode designar políticas no nível do canal. Essas políticas fazem parte da configuração do canal.
Uma política define quais organizações e atribuições podem solicitar um recurso. Quando uma solicitação é feita, a política solicita ao sistema que verifique a identidade do solicitante e determine se ele está autorizado a fazer a solicitação. Quando você cria um canal, o Oracle Blockchain Platform inclui as ACLs padrão do Hyperledger Fabric com o canal. O Oracle Blockchain Platform também cria políticas padrão (Admin, Criador, Gravadores, Leitores, Endosso e LifecycleEndorsement) para o canal. Você pode modificar essas políticas ou criar políticas conforme necessário. Consulte O Que São Políticas de Canal?.
Atualizar ACLs do Canal
Você pode atualizar as ACLs do canal designando políticas aos recursos do canal. Uma política define quais organizações e atribuições podem solicitar um recurso
Você deve compreender quais políticas e ACLs são antes de atualizar as ACLs de um canal. Para obter mais informações, consulte O Que São ACLs de Canal?.
- Vá para a console e clique na guia Canais.
A página Canais é exibida e a tabela de canais contém uma lista de todos os canais da sua rede.
- Na tabela de canais, clique no nome do canal cujas ACLs você deseja atualizar.
A página Informações do Canal é exibida.
- Na página Informações do Canal, clique no painel ACLs.
- Na tabela Recursos, localize o recurso que deseja atualizar. Clique no botão Expandir do recurso e selecione a política que você deseja designar ao recurso.
- Modifique as políticas do outro recurso conforme necessário.
- Clique em Atualizar ACLs.
Adicionar ou remover solicitantes de ou para um canal
A organização administrativa do solicitante pode adicionar ou remover solicitantes de um canal.
- Na console do fundador, abra a guia Canais e selecione o canal para ver sua exibição de detalhes.
- Abra a subaba Pedidos. Todos os nós do solicitante atualmente unidos ao canal são listados.
- Clique em Participar do Canal. Selecione um OSN ainda não presente neste canal e clique em Participar.
- Na console do fundador, abra a guia Canais e selecione o canal para ver sua exibição de detalhes.
- Abra a subaba Pedidos. Todos os nós do solicitante atualmente unidos ao canal são listados.
- Selecione o ordenador que deseja remover do canal e, no menu Mais Ações, selecione Remover.
Definir a Organização do Administrador do Solicitante
Você pode designar a administração de OSNs em um canal a qualquer organização. Normalmente, o fundador ou o criador do canal seriam designados.
- No console do fundador, abra a guia Canais.
- Selecione o canal para o qual você deseja definir a organização do administrador do ordenador e, no menu Ação, selecione Gerenciar Admin de OSNs.
- Selecione na lista de organizações disponíveis e clique em Enviar.
Editar Configurações de Serviço de Pedido para um Canal
Você pode atualizar as definições do serviço de solicitação de um canal específico.
- Você pode atualizar as definições do serviço de solicitação para toda a rede, conforme descrito em Editar Definições do Serviço de Solicitação para a Rede.
- Se você alterar as configurações do serviço de solicitação e houver aplicativos em execução na rede, esses aplicativos deverão ser atualizados manualmente para usar as configurações revisadas do serviço de solicitação.
- Não é comum, mas em algumas situações, você pode expor um serviço de pedidos diferente a alguns dos participantes da rede. Nesse caso, você exportará o bloco de configuração de rede atualizado e os participantes necessários importarão as configurações revisadas. Consulte Participar do Participante ou OSNs Escalonados para o Serviço de Pedidos do Fundador.