Skip to main content
Version: 9.2605.x RR

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.RegistrationResponseServiceImpl
  • ch.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.

Example: Debugging HTTP requests
Loggers:
Logger:
- name: org.springframework.web.filter.CommonsRequestLoggingFilter
level: DEBUG