|
|
|
# Uso avanzado del cliente
|
|
|
|
|
|
|
|
## Parámetros obligatorios
|
|
|
|
|
|
|
|
Los siguientes atributos son obligatorios por lo que deberán ser siempre suministrados.
|
|
|
|
|
|
|
|
* **data-fva = "true"** Este atributo siempre debe existir y ser true
|
|
|
|
* **data-url** Corresponde a la URL de solicitud de firma o autenticación, a ella siempre se le envía peticiones POST
|
|
|
|
* **data-successurl** Url para redireccionar cuando la autenticación o firma se realice adecuadamente.
|
|
|
|
* **data-mensajedeerror** Mensaje de error en caso de algún problema de comunicación
|
|
|
|
|
|
|
|
Adicionalmente en la autenticación se debe proporcionar
|
|
|
|
|
|
|
|
* **data-parautenticarse** Nombre de la aplicación que hace uso de la autenticación.
|
|
|
|
|
|
|
|
Además es altamente recomendable agregar
|
|
|
|
|
|
|
|
* **data-dominio** Corresponde a la base de las peticiones, cuando se forman las solicitudes automáticas
|
|
|
|
|
|
|
|
|
|
|
|
## Personalizando archivos solicitados
|
|
|
|
Algunos elementos como imágenes y referencias a archivos css tienen por defecto una ruta predefinida, pero puede ser sobreescrita si se desea utilizando la propiedad **data** de HTML.
|
|
|
|
|
|
|
|
Por ejemplo si quisiéramos obtener las imágenes del sitio demostrativo del BCCR en lugar de nuestro servidor podríamos utilizar
|
|
|
|
|
|
|
|
```html
|
|
|
|
<button id="BotonDeAutenticar"
|
|
|
|
data-fva = "true"
|
|
|
|
data-img_ayuda="https://www.firmadigital.go.cr/ClienteInternoFva/Imagenes/Ayuda.png"
|
|
|
|
data-img_autenticador="https://www.firmadigital.go.cr/ClienteInternoFva/Imagenes/Autenticador-v2.png"
|
|
|
|
data-img_firma="https://www.firmadigital.go.cr/ClienteInternoFva/Imagenes/Firmador-v2.png"
|
|
|
|
data-urlcss="https://www.firmadigital.go.cr/ClienteInternoFva/Content/Bccr.Fva.ClienteInterno.Firmador-1.0.5.css"
|
|
|
|
data-url="/autenticar"
|
|
|
|
data-dominio = "http://localhost:8000"
|
|
|
|
data-successurl = "http://localhost:8000/autenticado"
|
|
|
|
data-parautenticarse = "al Sitio de Verificación"
|
|
|
|
data-mensajedeerror = "No se pudo realizar la autenticación en el sitio de verificación."
|
|
|
|
type="button" class="botonVerificacion botonVerificacion-Inicio">Ingresar</button>
|
|
|
|
```
|
|
|
|
|
|
|
|
Adicionalmente si se desea modificar la ruta de consulta del estado de la firma se debe usar por ejemplo
|
|
|
|
|
|
|
|
```html
|
|
|
|
<button id="BotonDeAutenticar"
|
|
|
|
data-fva = "true"
|
|
|
|
data-urlconsultafirma="http://localhost:8000/Firmador/ConsulteLaFirma"
|
|
|
|
data-url="/autenticar"
|
|
|
|
data-dominio = "http://localhost:8000"
|
|
|
|
data-successurl = "http://localhost:8000/autenticado"
|
|
|
|
data-parautenticarse = "al Sitio de Verificación"
|
|
|
|
data-mensajedeerror = "No se pudo realizar la autenticación en el sitio de verificación."
|
|
|
|
type="button" class="botonVerificacion botonVerificacion-Inicio">Ingresar</button>
|
|
|
|
```
|
|
|
|
|