YubiKey en Gitea: Error al registrar llave


Descripción

Al intentar añadir una YubiKey como método 2FA en Gitea, puede aparecer el error:

Could not read your security key.
An unknown error occurred. Please retry.

Y en los logs:

Unable to finish registration due to error: Error validating origin
DevInfo: Expected Values: [http+unix://gitea.tudominio.org], Received: https://gitea.tudominio.org
CreateCredential: Error validating origin

Este error ocurre cuando Gitea genera automáticamente la variable ROOT_URL de forma incorrecta (por ejemplo, con el prefijo http+unix://).


Solución

Editar el archivo de configuración dentro del contenedor:

nano /data/gitea/conf/app.ini

o, según la ruta interna del contenedor:

nano /gitea/conf/app.ini

Modificar la línea correspondiente a la URL base de la instancia:

ROOT_URL = https://gitea.tudominio.org/

Importante: asegúrate de incluir la barra final /.

Con esto, Gitea podrá validar correctamente el origen (origin) durante el registro de la YubiKey y permitirá añadirla sin errores. Probado con una Yubikey 5C NFC.


Referencias


Revision #1
Created 2025-11-01 17:41:18 UTC by Juan Francisco
Updated 2025-12-22 20:27:50 UTC by Juan Francisco