Venta al por mayor de páginas y parámetros comunes de CBDC
Utilice las páginas comunes de la aplicación para configurar la presentación orientada al cliente, la autenticación, las conexiones de servicio y las vistas de cuenta y transacción.
Configuración y personalización del administrador
Antes de comenzar: Inicie sesión como administrador del banco central.
- Abra el menú de perfil.
- Seleccione Configuración para abrir la página Configuración.
- Seleccione el área que contiene la configuración que desea actualizar:
- Personalizaciones: controla el texto de bienvenida, los colores, las imágenes, los nombres de token y cuenta, los nombres y logotipos de organización, las etiquetas de transacción, las etiquetas de grupo de aplicaciones y las etiquetas de rol.
- Configuración de la aplicación: mantiene los valores de token, red, autenticación, API de envoltorio, contrato inteligente, cartera y servicio de historial enriquecido.
Nota:
El control Guardar cambios dentro de una tarjeta de personalización guarda los valores solo en el borrador de la página Configuración. Para publicar el borrador, seleccione el nivel de página Aplicar cambios. Al aplicar cambios, se guarda la configuración completa y se reinicia o se vuelve a desplegar la aplicación según sea necesario. Espere hasta que la aplicación esté disponible, vuelva a conectarse y verifique la página afectada.Para el desarrollo local, la aplicación almacena la configuración propiedad de la aplicación en el archivo de entorno local. No incluya secretos de cliente, credenciales de base de datos, claves privadas, tokens portadores ni URL de clientes en la documentación, las capturas de pantalla ni el control de origen.
Personalizar la página de conexión
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, abra la tarjeta Página de conexión.
- Introduzca el mensaje de conexión en Mensaje de bienvenida o Mensaje de página de conexión. El mensaje de inicio de sesión puede tener hasta 300 caracteres.
- Seleccione una imagen:
- Seleccione la imagen incorporada para ampliar su vista previa.
- Seleccione Cargar imagen para elegir un archivo PNG, JPG, WEBP o SVG que no supere los 80 KB. Para obtener mejores resultados, utilice una imagen horizontal.
- Seleccione Usar valor por defecto para restaurar la imagen incorporada.
- Seleccione Guardar cambios para guardar los valores de la tarjeta en el borrador de Configuración.
- Seleccione Cerrar para volver a Configuración y, a continuación, seleccione el nivel de página Aplicar cambios.
- Después de reiniciar la aplicación, abra la página de conexión y verifique el mensaje y la imagen.
Cambio del color de fondo de la aplicación
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, abra Color de fondo.
- Elija un valor predefinido (Valor por defecto, Azul suave, Sana suave, Sand cálido o Gris frío) o abra el selector de color personalizado para elegir un color.
- Revise la vista previa inmediata en la tarjeta. Para restaurar el color original, seleccione Usar valor por defecto.
- Seleccione Guardar cambios y, a continuación, Cerrar.
- En la página Configuración, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, inicie sesión y verifique el color de fondo en las páginas de la aplicación.
La vista previa en la tarjeta no publica el color. El cambio en toda la aplicación solo se aplica después de seleccionar Aplicar cambios.
Cambiar nombres mostrados de token y cuenta
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, seleccione Token.
- En Nombre mostrado de token, introduzca el nombre que se mostrará en las páginas relacionadas con la cabecera y el token.
- En Nombre mostrado de cuenta, introduzca el nombre que se mostrará en las secciones de la cuenta y los detalles de la cuenta.
- Seleccione Guardar cambios para guardar el borrador de la tarjeta y, a continuación, seleccione Cerrar.
- En la página Configuración, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, inicie sesión y verifique ambos nombres en las vistas correspondientes.
El cambio de estos nombres sólo afecta a la presentación. No cambia el token desplegado ni los permisos de contrato inteligente.
Configurar visualización de moneda
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, seleccione Moneda.
- Revise el campo ID de token para confirmar el token asociado a la configuración de visualización. Los controles de presentación de moneda no cambian este identificador.
- En Símbolo de moneda, seleccione una moneda de la lista de monedas ISO estandarizadas.
- En Formato numérico, seleccione el formato regional, que determina los separadores de miles y decimales. Al seleccionar un formato numérico, también se carga su posición de símbolo habitual.
- Revise el campo Lugares decimales. La precisión se carga desde el token seleccionado y no se puede cambiar aquí.
- En Posición de símbolo de moneda, seleccione si el símbolo aparece antes o después de la cantidad.
- Marque Vista previa actual para verificar el símbolo de moneda, los separadores, las posiciones decimales y la posición del símbolo.
- Seleccione Guardar cambios y Cerrar y, a continuación, seleccione Aplicar cambios en la página Configuración.
- Después de reiniciar la aplicación, inicie sesión y verifique los valores monetarios en las vistas de cuenta y transacción.
Actualizar presentación y secuencia de organización
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración. La organización ya debe estar registrada.
- En Personalizaciones, seleccione Organización.
- En el selector de organizaciones, seleccione la organización registrada. El selector muestra su nombre y secuencia.
- Revise los campos ID de organización registrada y Secuencia. El ID registrado es de solo lectura. La secuencia
1está reservada para el fundador. - Introduzca el nuevo nombre orientado al cliente en Nombre mostrado. Actualice la secuencia según sea necesario.
- Si el nombre mostrado o la secuencia han cambiado, seleccione Actualizar organización para enviar el cambio al registro de la organización.
- Para personalizar la imagen del Logotipo de organización, cargue un archivo PNG, JPG, WEBP o SVG que no supere los 80 KB o seleccione Usar valor por defecto.
- Seleccione Guardar cambios para guardar el borrador de personalización y, a continuación, seleccione Cerrar.
- En la página Configuración, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, inicie sesión y verifique el nombre, el logotipo y la secuencia de la organización en las tarjetas de organización, los selectores, las cabeceras, las vistas de cuenta y las listas que muestran el orden de la organización.
El registro mantiene la identidad y la secuencia de la organización. El cambio del nombre mostrado no sustituye su ID de organización registrada. Las actualizaciones de registro realizadas mediante el control Actualizar organización son distintas de la publicación del borrador de personalización mediante el comando Aplicar cambios.
Cambiar etiquetas de grupo de aplicaciones
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, seleccione Grupo de aplicaciones.
- En el selector Grupo de aplicaciones, seleccione el grupo que desea personalizar.
- Revise el valor de autorización fijo. No cambie la asignación de autorización subyacente.
- En Etiqueta de visualización, introduzca el nombre del grupo orientado al cliente.
- Seleccione Guardar cambios y Cerrar y, a continuación, seleccione Aplicar cambios en la página Configuración.
- Después de reiniciar la aplicación, inicie sesión y verifique la etiqueta en cabeceras, filas de cuentas, selectores y menús de perfil.
El cambio de la etiqueta no afecta a los permisos de usuario, el acceso al espacio de trabajo, los roles de libro mayor ni las asignaciones de cuentas.
Cambiar etiquetas de tipo de transacción
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, seleccione Etiquetas de transacción.
- En la lista Tipo de transacción, seleccione la asignación de transacción que desea personalizar.
- Revise el campo Etiqueta de transacción de API. Este valor de servicio es fijo.
- En Etiqueta mostrada, introduzca la etiqueta que se mostrará a los usuarios.
- Seleccione Guardar cambios y Cerrar y, a continuación, seleccione Aplicar cambios en la página Configuración.
- Después de reiniciar la aplicación, inicie sesión y verifique la etiqueta en las vistas de transacción aplicables.
La etiqueta de visualización cambia, pero el valor de transacción de API no lo hace.
Cambiar etiquetas de rol de token
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración.
- En Personalizaciones, seleccione Roles.
- En la lista Rol de token, seleccione el rol que desea personalizar.
- Revise el rol de autorización fija utilizado por la cadena de bloques. No cambie este valor.
- En Etiqueta de visualización, introduzca el nombre del rol orientado al cliente.
- Seleccione Guardar cambios y Cerrar y, a continuación, seleccione Aplicar cambios en la página Configuración.
- Después de reiniciar la aplicación, inicie sesión y verifique la etiqueta en las vistas de cuenta y perfil.
Cambiar la etiqueta no otorga, elimina ni cambia los permisos de blockchain de un usuario.
Configuración de la Aplicación
La configuración de la aplicación mantiene los valores de conexión y tiempo de ejecución utilizados por la aplicación. Normalmente, estos valores los proporciona el administrador de despliegue. Cámbielas solo cuando cambie el entorno de despliegue, el contrato, el proveedor de identidad o el servicio correspondiente.
Antes de editar la configuración de la aplicación, registre a qué despliegue pertenecen los valores. Confirme los valores de sustitución con el administrador de despliegue y mantenga todos los secretos enmascarados. Cuando un campo secreto ya contiene un valor enmascarado, déjelo en blanco si se debe conservar el secreto existente.
Configuración de Valores de Aplicación
Antes de comenzar: inicie sesión como administrador del banco central y seleccione Configuración. Confirme los valores de tiempo de ejecución para el despliegue.
- En Configuración de la aplicación, busque Valores de la aplicación.
- En ID de token, introduzca o verifique el identificador de token proporcionado durante el despliegue de Besu. El ID selecciona el token utilizado para las vistas de saldos, transferencias, emisión, baja y cuenta.
- Revise el campo Network (Red). Esta versión utiliza Besu. El despliegue corrige el tiempo de ejecución del libro mayor.
- Defina Seguridad de conexión en HTTPS para entornos seguros. Utilice HTTP solo cuando el despliegue local esté configurado intencionalmente para HTTP.
- Establezca Debug Mode (Modo de depuración) en Off (Desactivado) para uso normal. Active esta opción temporalmente solo para diagnosticar una prueba controlada o un problema de soporte. La depuración agrega detalles de autenticación y solicitud de backend a los logs del servidor.
- Revise la configuración y seleccione Aplicar cambios.
- Espere a que la aplicación se reinicie, vuelva a conectarse y verifique las operaciones de cuenta y token aplicables.
Configurar Valores de Autenticación
El proveedor de identidad se configura como parte del despliegue o la instalación de Oracle Blockchain Platform. Al seleccionar un método de inicio de sesión en la página Configuración, no se crean cuentas ni se cambia la política de autenticación multifactor (MFA) del proveedor.
- Inicie sesión como administrador del banco central y abra Configuración.
- En Configuración de la aplicación, busque Autenticación.
- En Método de conexión, seleccione el método configurado para el despliegue: LDAP o OpenID Connect (OIDC).
- Si selecciona OpenID Connect, complete los valores de OIDC en la siguiente sección antes de aplicar la configuración.
- Después de completar los campos aplicables, seleccione Apply Changes (Aplicar cambios), espere el reinicio y pruebe un nuevo inicio de sesión.
Configuración de los valores de Connect de OpenID
Antes de empezar: Obtenga los metadatos del emisor de OIDC y los valores de registro del cliente para el despliegue de la aplicación. Los siguientes campos se muestran solo cuando se selecciona OpenID Connect como método de conexión.
- En URL de emisor, introduzca el emisor protegido proporcionado por el proveedor de identidad. Verifique los metadatos de detección de OIDC del proveedor. La aplicación mayorista CBDC utiliza esta autoridad para detectar puntos finales clave de autorización, token, desconexión y firma y para verificar el emisor del token. No utilice la URL de aplicación, la URL de punto final de token ni un emisor copiado de otro entorno.
- En ID de cliente, introduzca el ID de cliente o aplicación de la aplicación CBDC mayorista creada para la URL de este despliegue.
- Cuando el registro del cliente lo necesite, introduzca la credencial en el campo Secreto de cliente enmascarado. Si el secreto existente no se debe modificar, deje el campo de edición en blanco.
- Para el URI de redirección, introduzca la dirección de devolución de llamada exacta registrada con el proveedor de identidad. Para el puerto local por defecto, utilice
http://localhost:3000/api/auth/oidc/callback. El esquema, el host, el puerto y la ruta deben coincidir. Registre un URI correspondiente cuando utilice un puerto local diferente. - Para URI de redirección posterior a la desconexión, introduzca el destino del explorador registrado después de la desconexión del proveedor. Para una configuración local por defecto, utilice
http://localhost:3000/u otra página posterior a la desconexión local registrada explícitamente. Registre este URI por separado de la devolución de llamada de conexión. - En Ámbitos, introduzca los ámbitos separados por espacios. La línea base normal es
openid profile email. Agregue ámbitos específicos del proveedor solo cuando lo requiera el despliegue. - En Reclamación de ID de usuario, introduzca la reclamación cuyo valor coincida exactamente con el ID de usuario utilizado por la API de envoltorio y los datos de cuenta del libro mayor. El valor por defecto local normal es
preferred_username; utilice otra reclamación solo cuando el proveedor de identidad y los datos de la aplicación lo utilicen de forma coherente. - Revise todos los valores y, a continuación, seleccione Aplicar cambios en la página Configuración.
- Espere a que la aplicación se reinicie y, a continuación, desconéctese y vuelva a conectarse. Confirme que la devolución de llamada se realiza correctamente, que se carga la cartera correcta y que están disponibles los permisos de cuenta y persona esperados.
OpenID Terminología de Connect
- OpenID Connect
- Protocolo de conexión en el que un proveedor de identidad autentica a un usuario mientras la aplicación mayorista CBDC verifica la identidad devuelta antes de crear una sesión de aplicación.
- Proveedor de identidad
- Servicio que mantiene cuentas de usuario, contraseñas, páginas de conexión y políticas de MFA. La aplicación CBDC mayorista no recibe la contraseña del usuario.
- Código de autorización
- Valor de corta duración enviado a la devolución de llamada registrada después de que el usuario se conecte. La aplicación de CBDC al por mayor la intercambia por tokens.
- PKCE
- Clave de prueba para el intercambio de código. Protección en el flujo de redireccionamiento del explorador que ayuda a evitar que un cliente diferente utilice un código de autorización interceptado.
- Token de acceso
- Credencial de corta duración utilizada por el backend para obtener o autorizar el acceso a los servicios descendentes configurados. No lo copie en mensajes de documentación o soporte.
- Reclamaciones
- Atributos de identidad incluidos en un token verificado, como ID de usuario, correo electrónico o grupos. El valor Reclamación de ID de usuario identifica el atributo que se asigna al usuario de la aplicación mayorista CBDC.
- MFA
- Autenticación multifactor realizada por el proveedor de identidad cuando su política requiere verificación adicional. El cambio del campo Configuración de una aplicación CBDC mayorista no activa la MFA en el proveedor.
Flujo de Conexión Local de OIDC
- El usuario abre la aplicación CBDC mayorista local e inicia el proceso de inicio de sesión.
- La aplicación CBDC mayorista redirige el explorador al proveedor de identidad configurado mediante el emisor, el ID de cliente y los ámbitos solicitados.
- El proveedor de identidad autentica al usuario y realiza MFA cuando su política lo requiere.
- El proveedor redirige el explorador al URI de redirección registrado exacto con un código de autorización.
- El backend de la aplicación CBDC mayorista intercambia el código para los tokens, verifica la respuesta de autenticación, lee la reclamación de ID de usuario configurada y crea la sesión de la aplicación.
- La aplicación carga el contexto de cartera, organización, cuenta y rol elegibles del usuario.
- Cuando el usuario cierra la sesión, la aplicación mayorista CBDC llama al cierre de sesión del proveedor cuando está soportada y envía el explorador al URI de redirección posterior a la desconexión registrado.
Verificar registro de proveedor de identidad para configuración local
Antes de empezar: obtenga acceso al registro de la aplicación del proveedor de identidad y a los valores de la página Configuración de la aplicación CBDC mayorista.
- Verifique que el issuer configurado coincida con los metadatos de detección y el emisor de OIDC del proveedor.
- Verifique que el backend local de la aplicación CBDC mayorista local admita el tipo de cliente y el método de autenticación de cliente registrados.
- Verifique que el URI de redirección coincida exactamente con
http://localhost:3000/api/auth/oidc/callbackpara el puerto local predeterminado o con el URI registrado correctamente para otro puerto. - Verifique que el URI de redirección posterior a la desconexión esté registrado por separado y coincida con la dirección configurada, como
http://localhost:3000/. - Verifique que el proveedor devuelva los ámbitos configurados y la reclamación de ID de usuario seleccionada.
- Verifique que el usuario existe en el proveedor de identidad, pertenece a los grupos esperados y puede completar la política de MFA configurada.
- Aplique los valores coincidentes en la página Configuración de la aplicación CBDC mayorista, espere a que la aplicación se reinicie y vuelva a conectarse para verificar el contexto de devolución de llamada, cartera, cuenta y rol.
Configurar la API de envoltorio
El envoltorio conecta la aplicación web a los servicios de Oracle Blockchain Platform y la integración de libros mayores desplegada.
Antes de empezar: conéctese como administrador del banco central, seleccione Configuración y obtenga los puntos finales y las credenciales para el despliegue de destino.
- En Configuración de aplicación, busque Configuración de API de envoltorio.
- En Punto final de servicio, introduzca el punto final de servicio proporcionado por el despliegue.
- En URL de API de envoltorio, introduzca la URL base de envoltorio accesible que se utiliza para las operaciones de cuenta, token, organización, cartera y transacción.
- En URL de token de acceso, introduzca el punto final de token proporcionado por la autenticación de servicio configurada.
- En ID de cliente de instancia de OBP, introduzca el identificador de cliente creado para esta instancia de Oracle Blockchain Platform.
- Cuando sea necesario, introduzca la nueva credencial en el campo Secreto de cliente de instancia de OBP enmascarado. Déjelo en blanco para conservar el secreto existente. No exponga el secreto en la documentación, las capturas de pantalla, el control de origen ni los mensajes de soporte.
- Verifique que los puntos finales, los identificadores y las credenciales pertenecen al mismo despliegue y, a continuación, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, inicie sesión y verifique la carga de la cartera, la carga de la cuenta, una operación de lectura y una transacción permitida.
Configuración de direcciones de contratos inteligentes
Antes de empezar: confirme las direcciones de contrato de Besu para el despliegue con el administrador de despliegue.
- Inicie sesión como administrador del banco central y abra Configuración.
- En Configuración de la aplicación, busque Configuración de contratos inteligentes.
- En Dirección de contrato de cuenta, introduzca el contrato desplegado que proporciona el registro de la cuenta, el estado, los límites, los roles y otras operaciones de libro mayor relacionadas con la cuenta.
- Para Dirección de contrato de token, introduzca el contrato desplegado que se utiliza para saldos de token, emisión, transferencias, retenciones, bajas y operaciones de token relacionadas.
- Confirme que ambas direcciones pertenecen al mismo despliegue Besu que la aplicación y, a continuación, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, inicie sesión y verifique la información de cuenta esperada, los saldos, los roles y los resultados de la transacción.
No utilice direcciones de contrato copiadas de otro entorno. Un contrato no coincidente puede hacer que la aplicación parezca conectada al devolver datos incorrectos de cuenta, saldo, rol o transacción.
Configuración de Valores del Servicio de Cartera
Antes de empezar: Obtenga los detalles del servicio de cartera para el despliegue de destino.
- Inicie sesión como administrador del banco central y abra Configuración.
- En Configuración de aplicación, busque Configuración de cartera.
- En URL de API de cartera, introduzca la URL de servicio utilizada para cargar carteras disponibles para el usuario autenticado.
- En ID de organización, introduzca el identificador utilizado por el servicio de cartera para definir el ámbito de la carga de cartera y la creación de cuentas en la organización.
- En ID de instancia de servicio de cartera, introduzca la instancia de servicio que posee el contexto de organización y usuario seleccionado.
- Confirme que todos los valores coinciden con el despliegue y, a continuación, seleccione Aplicar cambios.
- Después de reiniciar la aplicación, vuelva a conectarse y verifique que se cargan las carteras de la organización esperada. Si el usuario no tiene una cartera o una cuenta CBDC elegibles, la aplicación puede detener el proceso de inicio de sesión para la persona correspondiente.
Configuración de la Base de Datos de Historial Enriquecido
El historial enriquecido utiliza el servicio ORDS configurado para admitir lecturas de historial y cuentas de Besu.
Antes de empezar: Obtenga la configuración de ORDS OAuth para el despliegue de destino.
- Inicie sesión como administrador del banco central y abra Configuración.
- En Configuración de la aplicación, busque Configuración de la base de datos del historial enriquecido.
- En URL de token OAuth de ORDS, introduzca el punto final de ORDS en el que el backend obtiene su token de servicio.
- En ID de cliente ORDS, introduzca el identificador de cliente utilizado para la solicitud de token de servicio.
- Si la credencial debe cambiar, introdúzcala en el campo Secreto de cliente ORDS enmascarado. Deje el campo en blanco para conservar el secreto almacenado.
- Revise la configuración y seleccione Aplicar cambios.
- Después de reiniciar la aplicación, vuelva a iniciar sesión y verifique la lectura de una cuenta y la lectura de un historial de transacciones.
El backend obtiene el token de servicio ORDS y lo envía al envoltorio para las lecturas de historial y cuenta de Besu. No exponga el token de portador de ORDS al explorador ni lo copie en la documentación del cliente.
Aplicación y verificación de los cambios de configuración
Antes de comenzar: Inicie sesión como administrador del banco central.
- Cambie la configuración en la página Configuración.
- Revise las URL, los identificadores, las direcciones de contratos inteligentes y los campos secretos enmascarados. Confirme que todos los valores pertenecen al mismo despliegue y que las credenciales existentes no se han sustituido ni borrado involuntariamente.
- Cuando se modificó una tarjeta de personalización, seleccione Guardar cambios para guardar el borrador de la tarjeta.
- Seleccione el control de nivel de página Aplicar cambios. Se guarda la configuración completa y se inicia el reinicio o la implementación de la aplicación necesaria.
- Cuando la aplicación vuelva a estar disponible, inicie sesión.
- Verifique la autenticación, la carga de cartera, la carga de cuentas, los saldos, una lectura de historial y la acción de persona afectada.
Los cambios en el nombre mostrado y la etiqueta solo afectan a la presentación. Los cambios en las direcciones de contrato, los ID de organización, las instancias de servicio de cartera, la configuración de autenticación, los valores de envoltorio o las credenciales de ORDS pueden afectar a todas las personas y deben seguir los procedimientos de control de cambios de despliegue.
Mi cuenta
La página Mi cuenta muestra información de la cartera y la cuenta seleccionadas al iniciar sesión.
- Inicie sesión con una cuenta autorizada.
- En el panel de navegación, seleccione Mi cuenta.
- Revise el ID o la dirección de la cuenta, el usuario, la organización, los detalles del token, el estado de la cuenta, los saldos y los importes retenidos.
- Revise los límites y el uso diario de las transacciones, los grupos de aplicaciones, el historial de configuración y el historial de estados según lo permita su rol.
Revisar transacciones y registros de auditoría
Utilice la página Transacciones para buscar en el historial e inspeccionar los detalles disponibles para el contexto de conexión. Los auditores también pueden utilizar sus espacios de trabajo de auditoría autorizados.
- Inicie sesión y abra Transacciones desde el panel de navegación.
- Permite buscar el historial disponible mediante filtros aplicables, como el identificador de transacción, el tipo de transacción, la organización o el usuario, el texto de cuenta o contraparte, la finalidad o la nota, el importe, el saldo o la fecha. La disponibilidad de los filtros depende de los datos.
- Revise las transacciones coincidentes y abra una entrada para inspeccionar sus detalles.
- Abra la página
/auditautenticada para un espacio de trabajo de auditor. - Seleccione Auditoría del sistema o Auditoría de organización, según los datos de auditoría que necesite y el rol de auditor que tenga asignado.