Logging Configuration
The default logging configuration is located at /var/opt/nevisfido/<instance>/conf/logging.yml.
nevisFIDO will not start if the log4j2 configuration file does not exist or cannot be read.
You can replace the log4j2 configuration by specifying a custom --log-config location in the RUN_ARGS environment variable in the instance’s env.conf file.
Protocols
You can debug either FIDO UAF or FIDO2 related business logic by configuring ch.nevis.auth.fido at DEBUG level.
- The FIDO UAF API is in the package scope
ch.nevis.auth.fido.api.uaf - The FIDO2 / WebAuthn API is in the package scope
ch.nevis.auth.fido.api.webauthn
Loggers:
Logger:
- name: ch.nevis.auth.fido.api.webauthn
level: DEBUG
Client errors
When a FIDO UAF registration or authentication fails on the mobile device, nevisFIDO logs the client error code and the client error message sent by the client on INFO level. The default configuration of ch.nevis.auth.fido on INFO level is sufficient. The entries are written by the following loggers:
ch.nevis.auth.fido.core.businesslogic.uaf.fidouaf.impl.RegistrationResponseServiceImplch.nevis.auth.fido.core.businesslogic.uaf.fidouaf.impl.AuthenticationResponseServiceImpl
See Analyzing Client Errors in the Backend Logs in the mobile SDK documentation for examples and how to interpret these entries.
Requests
You can debug HTTP requests by configuring org.springframework.web.filter.CommonsRequestLoggingFilter at DEBUG
level.
Loggers:
Logger:
- name: org.springframework.web.filter.CommonsRequestLoggingFilter
level: DEBUG