Callbacks

En esta sección se gestionarán los distintos callbacks almacenados en el sistema y utilizados en distintas integraciones. Dichos callbacks pueden ser de tipo GET o POST, así como tener o no autenticación. Al acceder al menú podremos ver todos los callbacks creados en el sistema:

En el listado de callbacks existentes se dispone de una serie de acciones disponibles:

• Búsqueda: filtrará el listado de callbacks por nombre o código. Para ello introduciremos una cadena de texto y pulsaremos el botón Buscar. Si queremos volver a tener el listado completo deberemos pulsar el enlace Mostrar todos.
• Marcar/Desmarcar como predeterminado: el callback que esté marcado como predeterminado será la opción empleada en la redacción simple y la opción seleccionada por defecto en la redacción avanzada. Se puede cambiar su valor pulsando en el valor actual.
• Cambiar estado: Se puede activar o desactivar el callback pulsando sobre su estado actual.
• Editar (lápiz): mostrará el formulario con los datos del callback seleccionado. Además de poder ver la información, también podremos editarla.
• Eliminar (cruz): se eliminará el callback seleccionado.

Creación y edición de un callback

Tanto si se ha seleccionado la opción Añadir o si se ha seleccionado Editar sobre un callback, se accederá a la pantalla de edición de callbacks. En el caso de estar editando, los datos saldrán precargados con los del callback seleccionado. En caso de estar añadiendo un nuevo callback, estos datos aparecerán sin rellenar, o con sus valores por defecto.

Los campos a cumplimentar en este formulario son los siguientes:

• Nombre: Nombre del callback (obligatorio).
• Activo: Indica el estado del callback.
• Disponible en redacción: Si marcamos esta opción el callback estará disponible en la sección Redactar mediante un desplegable.
• Timeout en segundos: Timeout de la conexión.
• Tipo: Tipo de callback. Puede ser de tipo POST o de tipo GET.
• URL: URL a la que haremos el callback (obligatorio).
• Enviar sólo al finalizar: Si marcamos esta opción el callback sólo se enviará al finalizar la petición (terminada o rechazada).
• Autenticación: Autenticación necesaria en el callback. Las opciones disponibles son Ninguna, Basic Auth o Bearer Token. Campos:
  • Usuario (Basic Auth): Credencial usuario de Basic Auth.
  • Contraseña (Basic Auth): Credencial contraseña de Basic Auth.
  • Bearer Token.
• Certificado TLS: Indica si la conexión requiere autenticación con certificado. En caso de activarse se mostrarán los campos para indicar el alias y la contraseña del certificado. Este certificado deberá estar alojado en el fichero cacert.jks que se encuentra en la carpeta /home de la custodia de viafirma inbox.

Al crear un callback, a éste se le asignará un código (QGC9WESMMH, por ejemplo) que podrá ser utilizado en su uso mediante llamadas al servicio rest de creación de peticiones.