HISTÓRICO
Versão | Data da Publicação | Alterações |
---|---|---|
v1.0 | 06/03/2025 | - Versão inicial |
ÍNDICE
- Introdução
- Criar conta
- Provisionar infraestrutura
- Criar Organização e nó
- Receber convite para Grupo de Negócios
- Pedir para se juntar ao canal
- ANEXO 1 - Infraestrutura AWS
Introdução
Este documento apresenta os procedimentos que o cartório deverá providenciar para a ativação de um nó na rede Notarchain, o blockchain dos notários.
Para se juntar ao Notarchain, deve-se seguir os seguintes passos:
- Criar conta
- Provisionar infraestrutura
- Criar organização e nó
- Receber convite do Colégio Notarial
- Pedir para se juntar ao canal
Criar conta
Para criar uma conta basta navegar para https://chain.goledger.io/signup e preencher os dados de acordo com o formulário:
- Nome
- Nome de Usuário
- Senha
- Confirmação de Senha
Cheque seu e-mail e confirme sua conta com o código recebido.
Com a conta criada, envie um e-mail com assunto “Ativação Notarchainˮ para [email protected], informando o endereço de e-mail da conta criada. Esse passo é fundamental para a liberação de acesso completo à plataforma.
Provisionar infraestrutura
Crie um ambiente com os seguintes requisitos:
Requisito de Hardware
Recurso | Mínimo | Recomendado |
---|---|---|
vCPUs | 2 vCPUs | 4 vCPUs |
RAM | 4 GB | 8 GB |
Armazenamento | 500 GB | 1 TB |
Requisitos de Rede
A máquina virtual precisa ter um IP público ou FQDN configurado e também precisa ter acesso à internet.
Gere uma chave SSH para sua máquina virtual; ela será necessária posteriormente.
Portas
As seguintes portas devem estar liberadas para entrada:
Porta | Serviço |
---|---|
17054 | CA Operations |
7054 | Certificate Authority |
7051 | Peer Node |
9090 | Prometheus Monitoring |
443 | HTTPS |
17051 | Peer Operations |
5894 | CouchDB |
7052 | Chaincode Service |
1695 | Grafana Monitoring |
2376 | Docker Daemon |
7050 | Orderer Node |
8000 | Network API |
8080 | GoInitus Service |
9443 | Orderer Admin Interface |
22 | SSH |
17050 | Orderer Operations |
80 | HTTP |
Origens
A portas deve estar liberadas para as seguintes origens:
- 52.45.33.215 - IP da Plataforma GoChain
- IPs presentes na rede
- Podem ser visualizados em Business Group > Channels > Selecionar Channel > Nodes
Criar Organização e nó
Inicie o processo fazendo login na plataforma. Caso sua conta seja nova, você encontrará uma tela de boas-vindas. Para iniciar, clique em “Get Started”.
Configuração de infraestrutura
Como primeiro passo, você irá realizar a configuração da máquina virtual provisionada anteriormente. Para isso selecione a opção “External Provider” e nomeie o recurso. Clique em “Create Infra” para continuar.
Para um guia de configuração de provedor AWS, consulte o ANEXO 1.
Na etapa de configuração de VM, selecione o recurso de infra já criado e preencha o formulário com as informações da sua máquina virtual: usuário SSH, chave SSH e IP público ou FQDN.
Aguarde a configuração ser finalizada.
Configuração de organização
Com a máquina virtual configurada, é hora de criar a organização. Para isso preencha o formulário com as seguintes informações:
- Organization Name: Um nome para sua organização que seja descritivo e represente sua entidade na rede blockchain. Exemplo: TabeliaoXPTO.
- Domain: O domínio da sua organização. Esse domínio é usado para gerar identidades digitais e definir os endereços de comunicação dos peers e orderers na rede. Exemplo: org.br.
- Network API Host: Selecione a VM configurada anteriormente.
- Organization Type: Selecione a opção “Full Organization”. Caso essa opção não esteja disponível entre em contato com [email protected]
- CA Host: Selecione a VM configurada anteriormente.
- CA User: Escolha um nome de usuário de administração CA para criação de recursos.
- CA Password: Escolha uma senha para o usuário de administração CA. Guarde essa informação em lugar seguro.
Clique em “Create Organization” para continuar.
Aguarde o processo de criação da organização.
Após essa etapa, você terá a opção de convidar usuários para serem membros da organização. Clique em “Skip” para acessar o dashboard da organização.
Criação de nó (peer)
Para criar um nó Peer, clique em “Create Peer” e preencha as informações:
- Peer Host: Seleciona a VM configurada.
- CA User: Usuário do CA criado anteriormente.
- CA Password: Senha para o usuário do CA criado anteriormente.
Clique em “Submit” para criar o nó.
Receber convite para Grupo de Negócios
Com a organização e nó criados, é necessário informar o ID de sua organização, presente como subtítulo da sua organização na tela de dashboard. Basta clicar no código para copiá-lo para sua área de transferência.
Informe o ID de sua organização ao Colégio Notarial do Brasil ou via email para [email protected].
Após isso, aguarde o envio de um convite para integrar o grupo de negócios Notarchain que ficará disponível para aceite no dashboard da sua organização.
Pedir para se juntar ao canal
Uma vez parte do grupo de negócios, navegue para a aba de Channels do Business Group Notarchain. Escolha um dos canais e clique no submenu de opções representado pelos 3 pontos verticais. Selecione “Request to Join Channel”
Por último, selecione a opção Application Channel e selecione o peer exibido. Clique em "Submit" para continuar. Isso irá gerar uma proposta para se juntar ao canal que será aprovada pelos outros membros. O status da proposta pode ser visto em Proposals, acessível via barra lateral.
ANEXO 1 - Infraestrutura AWS
Criando um provedor AWS
Se você escolher o provedor AWS, será necessário informar as seguintes informações:
- Nome: O nome da sua infraestrutura
- Região: A região da AWS onde sua infraestrutura será criada
- Chave de Acesso: Sua AWS Access Key
- Chave Secreta: Sua AWS Secret Key
- Nome do Grupo de Segurança: O nome do grupo de segurança que será criado. Este grupo não deve existir em sua conta AWS. O GoInfra configurará as regras de firewall para os recursos da blockchain.
- Nome da Chave SSH: O nome da chave SSH que será criada. Esta chave não deve existir em sua conta AWS. O GoInfra criará a chave SSH que será usada para conectar às máquinas virtuais (VMs).
Para criar um AWS IAM e emitir suas chaves de acesso, acesse os seguintes guias: 1. https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html 2. https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html
Garanta que sua AWS Access Key esteja associada a um usuário IAM com no mínimo as seguintes permissões:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeVpcs", "ec2:CreateSecurityGroup", "ec2:AuthorizeSecurityGroupIngress", "ec2:DeleteSecurityGroup", "ec2:CreateKeyPair", "ec2:DeleteKeyPair", "ec2:CreateTags", "ec2:RunInstances", "ec2:TerminateInstances", "ec2:DescribeInstances", "ec2:DescribeInstanceStatus" ], "Resource": "*" } ] } |
Depois, basta clicar no botão "Create Infra" para criar sua infraestrutura.
Provisionando Infraestrutura AWS
Agora você pode seguir para a próxima etapa, que é a configuração das suas máquinas virtuais (VMs).
Para configurar suas VMs, você precisará informar as seguintes informações:
Material de Onboarding para novas Organizações 15
- Tipo de Instância: O tipo da VM que será criada
- Chave SSH: A chave SSH que será usada para conectar às VMs. Esta chave foi criada na etapa anterior.
- Nome da Instância: O nome da VM que será criada
- Imagem da Instância: A imagem da VM que será criada. Atualmente, apenas Ubuntu 20 é suportado.
- Quantidade de Instâncias: O número de VMs que serão criadas
- Tamanho do Armazenamento: O tamanho do armazenamento que será criado
- Nome do Grupo de Segurança: O nome do grupo de segurança que será utilizado. Este grupo foi criado na etapa anterior.
Durante a configuração, você poderá acompanhar o progresso da criação das VMs.
Você também poderá visualizar os detalhes das VMs que foram criadas em sua conta AWS.
Após a configuração das suas VMs, você poderá seguir para a próxima etapa, que é a configuração da sua primeira organização.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo