Configurações e Páginas Comuns de CBDC por Atacado

Use as páginas comuns do aplicativo para configurar apresentações voltadas para o cliente, autenticação, conexões de serviço e exibições de conta e transação.

As páginas e as opções de navegação disponíveis dependem das permissões atribuídas.

  1. Acesse o aplicativo usando sua conta de usuário designada.
  2. Use o painel de navegação para abrir as páginas disponíveis para sua função.
  3. Selecione Minha Conta para revisar o contexto do token e da conta, o status da conta, o saldo, os valores em retenção, os limites e o uso diários, os grupos de aplicativos, o histórico de configuração e o histórico de status.
  4. Para encerrar uma sessão, abra o menu do usuário e selecione Sair.

A saída limpa a sessão do aplicativo. Se o log-out do provedor de identidades for configurado, o browser continuará na página de log-out do provedor de identidades.

Definições e Personalização do Administrador

Antes de começar: Entre como administrador do banco central.

  1. Abra o menu de perfil.
  2. Selecione Configurações para abrir a página Configuração.
  3. Selecione a área que contém as configurações a serem atualizadas:
    • Personalizações: Controla texto de boas-vindas, cores, imagens, nomes de token e conta, nomes e logotipos de organizações, rótulos de transação, rótulos de grupo de aplicativos e rótulos de função.
    • Configuração do Aplicativo: Mantém definições de serviço de token, rede, autenticação, API de encapsulador, contrato inteligente, wallet e histórico avançado.

Observação:

O controle Salvar Alterações dentro de um cartão de personalização salva os valores apenas no rascunho da página Configuração. Para publicar o rascunho, selecione o nível de página Aplicar Alterações. A aplicação de alterações salva a configuração completa e reinicia ou reimplanta o aplicativo conforme necessário. Aguarde até que o aplicativo fique disponível, acesse novamente e verifique a página afetada.

Para desenvolvimento local, o aplicativo armazena a configuração de propriedade do aplicativo no arquivo de ambiente local. Não coloque segredos de cliente, credenciais de banco de dados, chaves privadas, tokens de portador ou URLs de cliente na documentação, capturas de tela ou controle de origem.

Personalizar a Página de Login

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, abra o cartão Página de Login.
  2. Informe a mensagem de acesso em Mensagem de boas-vindas ou Mensagem da Página de Log-in. A mensagem de acesso pode ter até 300 caracteres.
  3. Escolha uma imagem:
    • Selecione a imagem incorporada para ampliar sua visualização.
    • Selecione Fazer Upload de Imagem para escolher um arquivo PNG, JPG, WEBP ou SVG com no máximo 80 KB. Para obter melhores resultados, use uma imagem de paisagem.
    • Selecione Usar Padrão para restaurar a imagem incorporada.
  4. Selecione Salvar Alterações para salvar os valores do cartão no rascunho Configuração.
  5. Selecione Fechar para retornar à Configuração e, em seguida, selecione a página Aplicar Alterações.
  6. Depois que o aplicativo for reiniciado, abra a página de acesso e verifique a mensagem e a imagem.

Alterar a Cor de Fundo do Aplicativo

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, abra Cor de Fundo.
  2. Escolha uma predefinição (Padrão, Soft Blue, Soft Teal, Warm Sand ou Cool Gray) ou abra o seletor de cores personalizado para escolher uma cor.
  3. Revise a visualização imediata no cartão. Para restaurar a cor original, selecione Usar Padrão.
  4. Selecione Salvar Alterações e Fechar.
  5. Na página Configuração, selecione Aplicar Alterações.
  6. Depois que o aplicativo for reiniciado, efetue sign-in e verifique a cor de fundo nas páginas do aplicativo.

A visualização no cartão não publica a cor. A alteração em todo o aplicativo só entra em vigor depois que você seleciona Aplicar Alterações.

Alterar Nomes de Exibição de Token e Conta

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, selecione Token.
  2. Para Nome para Exibição do Token, informe o nome a ser mostrado nas páginas relacionadas ao cabeçalho e ao token.
  3. Para Nome de Exibição da Conta, informe o nome a ser mostrado nas seções da conta e nos detalhes da conta.
  4. Selecione Salvar Alterações para salvar o rascunho do cartão e selecione Fechar.
  5. Na página Configuração, selecione Aplicar Alterações.
  6. Depois que o aplicativo for reiniciado, efetue sign-in e verifique os dois nomes nas views aplicáveis.

Alterar esses nomes afeta apenas a apresentação. Ele não altera o token implantado ou as permissões de contrato inteligente.

Configurar Exibição de Moeda

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, selecione Moeda.
  2. Revise o campo ID do Token para confirmar o token associado às definições de exibição. Os controles de apresentação de moeda não alteram esse identificador.
  3. Para Símbolo da Moeda, selecione uma moeda na lista de moedas ISO padronizadas.
  4. Para Formato de Número, escolha o formato regional, que determina os separadores de milhares e decimais. Selecionar um formato de número também carrega sua posição de símbolo usual.
  5. Revise o campo Casas Decimais. A precisão é carregada do token selecionado e não pode ser alterada aqui.
  6. Para Posição do Símbolo da Moeda, escolha se o símbolo será exibido antes ou depois do valor.
  7. Marque Visualização Atual para verificar o símbolo da moeda, os separadores, as casas decimais e a posição do símbolo.
  8. Selecione Salvar Alterações e Fechar e, em seguida, selecione Aplicar Alterações na página Configurar.
  9. Depois que o aplicativo for reiniciado, efetue sign-in e verifique os valores monetários nas visualizações de conta e transação.

Atualizar Apresentação e Sequência da Organização

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações. A organização já deve estar registrada.

  1. Em Personalizações, selecione Organização.
  2. No seletor de organização, escolha a organização registrada. O seletor exibe seu nome e sua sequência.
  3. Verifique os campos ID da Organização Registrada e Sequência. O ID registrado é somente leitura. A sequência 1 é reservada para o fundador.
  4. Informe o novo nome voltado ao cliente em Nome para Exibição. Atualize a sequência conforme necessário.
  5. Se o nome de exibição ou a sequência forem alterados, selecione Atualizar Organização para enviar a alteração ao registro da organização.
  6. Para personalizar a imagem do Logotipo da Organização, faça upload de um arquivo PNG, JPG, WEBP ou SVG com no máximo 80 KB ou selecione Usar Padrão.
  7. Selecione Salvar Alterações para salvar o rascunho da personalização e, em seguida, selecione Fechar.
  8. Na página Configuração, selecione Aplicar Alterações.
  9. Depois que o aplicativo for reiniciado, efetue sign-in e verifique o nome da organização, o logotipo e a sequência em cartões de organização, seletores, cabeçalhos, exibições de conta e listas que mostram a ordem da organização.

O registro mantém a identidade e a sequência da organização. Alterar o nome de exibição não substitui seu ID de organização registrado. As atualizações do registro feitas usando o controle Atualizar Organização são diferentes da publicação do rascunho da personalização por meio do comando Aplicar Alterações.

Alterar Rótulos do Grupo de Aplicativos

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, selecione Grupo de Aplicativos.
  2. No seletor Grupo de Aplicativos, escolha o grupo a ser personalizado.
  3. Revise o valor de autorização fixo. Não altere o mapeamento de autorização subjacente.
  4. Em Rótulo de Exibição, informe o nome do grupo voltado ao cliente.
  5. Selecione Salvar Alterações e Fechar e, em seguida, selecione Aplicar Alterações na página Configurar.
  6. Depois que o aplicativo for reiniciado, conecte-se e verifique o rótulo em cabeçalhos, linhas de conta, seletores e menus de perfil.

A alteração do rótulo não afeta as permissões do usuário, o acesso ao espaço de trabalho, as funções do razão ou as atribuições da conta.

Alterar Rótulos do Tipo de Transação

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, selecione Etiquetas de transação.
  2. Na lista Tipo de transação, selecione o mapeamento de transação a ser personalizado.
  3. Revise o campo Rótulo de transação da API. Este valor de serviço é fixo.
  4. Para Label de Exibição, informe o label a ser exibido aos usuários.
  5. Selecione Salvar Alterações e Fechar e, em seguida, selecione Aplicar Alterações na página Configurar.
  6. Depois que o aplicativo for reiniciado, conecte-se e verifique o rótulo nas visualizações de transação aplicáveis.

O rótulo de exibição muda, mas o valor da transação da API não.

Alterar Rótulos de Função de Token

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações.

  1. Em Personalizações, selecione Funções.
  2. Na lista Atribuição de Token, escolha a atribuição a ser personalizada.
  3. Revise a atribuição de autorização fixa usada pelo blockchain. Não altere este valor.
  4. Em Rótulo de Exibição, informe o nome da função voltada ao cliente.
  5. Selecione Salvar Alterações e Fechar e, em seguida, selecione Aplicar Alterações na página Configurar.
  6. Depois que o aplicativo for reiniciado, efetue sign-in e verifique o label nas exibições de conta e perfil.

A alteração do rótulo não concede, remove ou altera as permissões de blockchain de um usuário.

Configuração do Aplicativo

A configuração do aplicativo mantém os valores de conexão e runtime usados pelo aplicativo. Esses valores são normalmente fornecidos pelo administrador de implantação. Altere-os somente quando o serviço, o contrato, o provedor de identidades ou o ambiente de implantação correspondentes forem alterados.

Antes de editar a configuração do aplicativo, registre a qual implantação os valores pertencem. Confirme os valores de substituição com o administrador de implantação e mantenha todos os segredos mascarados. Quando um campo de segredo já contiver um valor mascarado, deixe-o em branco se o segredo existente tiver que ser retido.

Configurar Definições da Aplicação

Antes de começar: faça sign-in como administrador do banco central e selecione Configurações. Confirme os valores de runtime para implantação.

  1. Em Configuração do Aplicativo, localize Definições do Aplicativo.
  2. Para ID do Token, informe ou verifique o identificador do token fornecido durante a implantação do Besu. O ID seleciona o token usado para saldos, transferências, emissão, baixa e visualizações de conta.
  3. Revise o campo Rede. Esta versão usa o Besu. O runtime do razão é corrigido pela implantação.
  4. Defina Segurança de Conexão para HTTPS para ambientes seguros. Use HTTP somente quando a implantação local for configurada intencionalmente para HTTP.
  5. Defina Modo de Depuração como Desativado para uso normal. Ative-o temporariamente apenas para diagnosticar um problema de teste ou suporte controlado. A depuração adiciona detalhes da solicitação de autenticação e back-end aos logs do servidor.
  6. Verifique as definições e selecione Aplicar Alterações.
  7. Aguarde a reinicialização do aplicativo, faça sign-in novamente e verifique as operações aplicáveis de token e conta.

Configurar Definições de Autenticação.

O provedor de identidades é configurado como parte da implantação ou da instalação do Oracle Blockchain Platform. A seleção de um método de acesso na página Configuração não cria contas nem altera a política de autenticação multifator (MFA) do provedor.

  1. Acesse como administrador do banco central e abra Configurações.
  2. Em Configuração do Aplicativo, localize Autenticação.
  3. Para Método de Acesso, selecione o método configurado para a implantação: LDAP ou OpenID Connect (OIDC).
  4. Se você selecionar OpenID Connect, preencha as configurações do OIDC na seção a seguir antes de aplicar a configuração.
  5. Depois de preencher os campos aplicáveis, selecione Aplicar Alterações, aguarde a reinicialização e teste um novo acesso.

Configurar configurações do OpenID Connect

Antes de começar: Obtenha os metadados do emissor OIDC e os valores de registro do cliente para a implantação do aplicativo. Os campos a seguir são exibidos somente quando o OpenID Connect é selecionado como o método de acesso.

  1. Para URL do Emissor, informe o emissor confiável fornecido pelo provedor de identidades. Verifique-o em relação aos metadados de descoberta do OIDC do provedor. O aplicativo CBDC de atacado usa essa autoridade para descobrir a autorização, o token, o logout e os pontos finais da chave de assinatura e para verificar o emissor do token. Não use o URL do aplicativo, o URL do ponto final do token ou um emissor copiado de outro ambiente.
  2. Para ID do Cliente, informe o ID do cliente ou do aplicativo do aplicativo CBDC de atacado criado para o URL desta implantação.
  3. Quando o registro do cliente exigir, informe a credencial no campo Segredo do Cliente mascarado. Se o segredo existente deve permanecer inalterado, deixe seu campo de edição em branco.
  4. Para URI de Redirecionamento, informe o endereço de callback exato registrado no provedor de identidades. Para a porta local padrão, use http://localhost:3000/api/auth/oidc/callback. O esquema, o host, a porta e o caminho devem corresponder. Registre um URI correspondente ao usar outra porta local.
  5. Para URI de Redirecionamento Pós-Log-out, informe o destino do browser registrado após o log-out do provedor. Para uma configuração local padrão, use http://localhost:3000/ ou outra página de pós-logout local explicitamente registrada. Registre este URI separadamente do callback de acesso.
  6. Para Escopos, informe escopos separados por espaços. A linha de base normal é openid profile email. Adicione escopos específicos do provedor somente quando exigido pela implantação.
  7. Para Reivindicação de ID de Usuário, informe a reivindicação cujo valor corresponde exatamente ao ID de usuário usado pela API do encapsulador e pelos dados da conta do razão. O padrão local normal é preferred_username; use outra reivindicação somente quando o provedor de identidades e os dados do aplicativo a usarem de forma consistente.
  8. Revise todos os valores e selecione Aplicar Alterações na página Configuração.
  9. Aguarde a reinicialização do aplicativo e, em seguida, saia e entre novamente. Confirme se o callback foi bem-sucedido, se a wallet correta foi carregada e se as permissões de conta e persona esperadas estão disponíveis.

Terminologia do OpenID Connect

OpenID Connect
Um protocolo de acesso no qual um provedor de identidades autentica um usuário enquanto o aplicativo CBDC de atacado verifica a identidade retornada antes de criar uma sessão de aplicativo.
Provedor de identidades
O serviço que mantém contas de usuário, senhas, páginas de acesso e políticas de MFA. O aplicativo CBDC de atacado não recebe a senha do usuário.
Código de autorização
Um valor de curta duração enviado para o callback registrado após o usuário se conectar. O back-end do aplicativo CBDC de atacado o troca por tokens.
Chave Primária
Chave de Prova para o Code Exchange. Uma proteção no fluxo de redirecionamento do navegador que ajuda a impedir que um código de autorização interceptado seja usado por outro cliente.
Token de acesso
Uma credencial de curta duração usada pelo back-end para obter ou autorizar o acesso a serviços downstream configurados. Não copie para a documentação ou mensagens de suporte.
Reivindicações
Atributos de identidade contidos em um token verificado, como ID do usuário, e-mail ou grupos. A configuração Reivindicação de ID do Usuário identifica o atributo que é mapeado para o usuário do aplicativo CBDC de atacado.
MFA
Autenticação multifator executada pelo provedor de identidades quando sua política exigir verificação adicional. A alteração do campo Configuração de um aplicativo CBDC de atacado não habilita a MFA no provedor.

Fluxo de Acesso do OIDC Local

  1. O usuário abre o aplicativo CBDC de atacado local e inicia o processo de conexão.
  2. O aplicativo CBDC de atacado redireciona o navegador para o provedor de identidades configurado usando o emissor, o ID do cliente e os escopos solicitados.
  3. O provedor de identidades autentica o usuário e executa a MFA quando sua política o exigir.
  4. O provedor redireciona o navegador para o URI de Redirecionamento registrado exato com um código de autorização.
  5. O back-end do aplicativo CBDC de atacado troca o código por tokens, verifica a resposta de autenticação, lê a Reivindicação de ID de Usuário configurada e cria a sessão do aplicativo.
  6. O aplicativo carrega a wallet, a organização, a conta e o contexto de atribuição elegíveis do usuário.
  7. Quando o usuário se desconecta, o aplicativo CBDC de atacado chama o logout do provedor quando suportado e envia o browser para o URI de Redirecionamento Pós-Logout registrado.

Verificar Registro do Provedor de Identidades para Configuração Local

Antes de começar: Obtenha acesso ao registro do aplicativo do provedor de identidades e aos valores da página Configuração do aplicativo CBDC de atacado.

  1. Verifique se o emissor configurado corresponde ao emissor OIDC do provedor e aos metadados de descoberta.
  2. Verifique se o tipo de cliente registrado e o método de autenticação do cliente são suportados pelo back-end do aplicativo CBDC de atacado local.
  3. Verifique se o URI de redirecionamento corresponde exatamente ao http://localhost:3000/api/auth/oidc/callback da porta local padrão ou ao URI registrado corretamente para outra porta.
  4. Verifique se o URI de redirecionamento pós-logout está registrado separadamente e corresponde ao endereço configurado, como http://localhost:3000/.
  5. Verifique se o provedor retorna os escopos configurados e a Reivindicação de ID de Usuário selecionada.
  6. Verifique se o usuário existe no provedor de identidades, pertence aos grupos esperados e pode concluir a política de MFA configurada.
  7. Aplique os valores correspondentes na página Configuração do aplicativo CBDC de atacado, aguarde a reinicialização do aplicativo e faça sign-in novamente para verificar o contexto de callback, wallet, conta e atribuição.

Configurar a API Wrapper

O wrapper conecta o aplicativo web aos serviços do Oracle Blockchain Platform e à integração do razão implantado.

Antes de começar: Efetue sign-in como administrador do banco central, selecione Definições e obtenha os pontos finais e as credenciais para a implantação de destino.

  1. Em Configuração do Aplicativo, localize Configuração da API do Encapsulador.
  2. Para Ponto Final do Serviço, informe o ponto final do serviço fornecido pela implantação.
  3. Para URL da API do wrapper, informe o URL base do wrapper acessível usado para operações de conta, token, organização, wallet e transação.
  4. Para URL do Token de Acesso, informe o ponto final do token fornecido pela autenticação de serviço configurada.
  5. Para ID do Cliente da Instância do OBP, informe o identificador do cliente criado para esta instância do Oracle Blockchain Platform.
  6. Quando necessário, informe a nova credencial no campo Segredo do Cliente da Instância do OBP mascarado. Deixe em branco para manter o segredo existente. Não exponha o segredo na documentação, capturas de tela, controle de origem ou mensagens de suporte.
  7. Verifique se os pontos finais, identificadores e credenciais pertencem à mesma implantação e selecione Aplicar Alterações.
  8. Depois que o aplicativo for reiniciado, faça sign-in e verifique o carregamento da wallet, o carregamento da conta, uma operação de leitura e uma transação permitida.

Configurar Endereços Inteligentes do Contrato

Antes de começar: Confirme os endereços do contrato Besu para a implantação com o administrador da implantação.

  1. Acesse como administrador do banco central e abra Configurações.
  2. Em Configuração do Aplicativo, localize Configuração do Contrato Inteligente.
  3. Para Endereço do Contrato da Conta, informe o contrato implantado que fornece registro de conta, status, limites, funções e outras operações do razão relacionadas à conta.
  4. Para Endereço do Contrato do Token, informe o contrato implantado usado para saldos de token, emissão, transferências, retenções, baixa e operações de token relacionadas.
  5. Confirme se os dois endereços pertencem à mesma implantação do Besu que o aplicativo e selecione Aplicar Alterações.
  6. Depois que o aplicativo for reiniciado, efetue sign-in e verifique as informações de conta, saldos, funções e resultados de transação esperados.

Não use endereços de contrato copiados de outro ambiente. Um contrato incompatível pode fazer com que o aplicativo pareça conectado ao retornar dados incorretos de conta, saldo, função ou transação.

Configurar Definições do Serviço Wallet

Antes de começar: Obtenha detalhes do serviço da wallet para a implantação de destino.

  1. Acesse como administrador do banco central e abra Configurações.
  2. Em Configuração do Aplicativo, localize Configuração da Wallet.
  3. Para URL da API de Wallet, informe o URL de serviço usado para carregar wallets disponíveis para o usuário autenticado.
  4. Para ID da Organização, informe o identificador usado pelo serviço da wallet para fazer o escopo do carregamento da wallet e da criação da conta para a organização.
  5. Para ID da Instância de Serviço de Wallet, informe a instância de serviço que possui a organização selecionada e o contexto do usuário.
  6. Confirme se todos os valores correspondem à implantação e selecione Aplicar Alterações.
  7. Depois que o aplicativo for reiniciado, efetue sign-in novamente e verifique se as carteiras da organização esperada são carregadas. Se o usuário não tiver uma carteira ou conta CBDC elegível, o aplicativo poderá interromper o processo de conexão para a persona aplicável.

Configurar o Rich History Database

O histórico avançado usa o serviço ORDS configurado para suportar leituras de conta e histórico do Besu.

Antes de começar: Obtenha a configuração do ORDS OAuth para a implantação de destino.

  1. Acesse como administrador do banco central e abra Configurações.
  2. Em Configuração do Aplicativo, localize Configuração do Banco de Dados de Histórico Avançado.
  3. Para URL do Token OAuth do ORDS, informe o ponto final do ORDS em que o back-end obtém seu token de serviço.
  4. Para ID do Cliente ORDS, informe o identificador do cliente usado para a solicitação de token de serviço.
  5. Se a credencial precisar ser alterada, informe-a no campo Segredo do Cliente ORDS mascarado. Deixe o campo em branco para manter o segredo armazenado.
  6. Verifique as definições e selecione Aplicar Alterações.
  7. Depois que o aplicativo for reiniciado, efetue sign-in novamente e verifique uma leitura de conta e um histórico de transações.

O backend obtém o token do serviço ORDS e o envia ao encapsulador para leituras de conta e histórico do Besu. Não exponha o token portador do ORDS ao navegador ou copie-o na documentação do cliente.

Aplicar e Verificar Alterações de Configuração

Antes de começar: Entre como administrador do banco central.

  1. Altere as configurações na página Configuração.
  2. Revise URLs, identificadores, endereços de contrato inteligente e campos de segredo mascarados. Confirme se todos os valores pertencem à mesma implantação e se as credenciais existentes não foram substituídas ou removidas involuntariamente.
  3. Quando um cartão de personalização for modificado, selecione sua opção Salvar Alterações para salvar o rascunho do cartão.
  4. Selecione o controle Aplicar Alterações no nível da página. A configuração completa é salva e o reinício ou rollout do aplicativo necessário é iniciado.
  5. Quando o aplicativo estiver disponível novamente, entre.
  6. Verifique a autenticação, o carregamento da wallet, o carregamento da conta, os saldos, uma leitura do histórico e a ação de persona afetada.

As alterações de nome de exibição e rótulo afetam somente a apresentação. Alterações nos endereços do contrato, IDs da organização, instâncias de serviço da wallet, definições de autenticação, valores do wrapper ou credenciais do ORDS podem afetar todas as personas e devem seguir os procedimentos de controle de alteração de implantação.

Minha Conta

A página Minha Conta exibe informações da wallet e da conta selecionadas no acesso.

  1. Entre com uma conta autorizada.
  2. No painel de navegação, selecione Minha Conta.
  3. Revise o ID ou endereço da conta, o usuário, a organização, os detalhes do token, o status da conta, os saldos e os valores em retenção.
  4. Revise o uso e os limites diários da transação, os grupos de aplicativos, o histórico de configuração e o histórico de status conforme permitido pela sua função.

Revisar transações e registros de auditoria

Use a página Transações para pesquisar o histórico e inspecionar os detalhes disponíveis para seu contexto conectado. Os auditores também podem usar seus espaços de trabalho de auditoria autorizados.

  1. Acesse o sistema e abra Transações no painel de navegação.
  2. Pesquise o histórico disponível usando filtros aplicáveis, como identificador da transação, tipo de transação, organização ou usuário, texto da conta ou da contraparte, finalidade ou aviso, valor, saldo ou data. A disponibilidade do filtro depende dos dados.
  3. Revise as transações correspondentes e abra uma entrada para inspecionar seus detalhes.
  4. Abra a página /audit autenticada para um espaço de trabalho do auditor.
  5. Selecione Auditoria do Sistema ou Auditoria da Organização, dependendo dos dados de auditoria necessários e da função de auditor atribuída a você.