Outdated documentation

The latest documentation was moved to docs.qfield.org

Autenticación

QField admite la conexión a servicios web protegidos por QAuth2. Al utilizar QAuth2 es posible proteger capas y servicios con una amplia variedad de esquemas de autenticación, como por ejemplo la autenticación mediante dos factores.

Para cargar con éxito en QField capas protegidas por QAuth2 el proyecto de QGIS debe estar configurado para usar QAuth2.

Preparar la autenticación en QGIS

Para establecer un WFS con QAuth2 en QGIS siga estos pasos en la configuración del proyecto de QGIS.

En la configuración de la capa WFS:

widgets

Añadir una configuración de autenticación nueva. Los parámetros tienen que ajustarse a la configuración del servidor de QAuth2:

widgets

Exportar la autenticación desde QGIS

Note

Exportar una configuración de autenticación requiere al menos QGIS 3.20. Es posible utilizar QGIS 3.20 solamente para preparar la configuración de autenticación y configurar el proyecto de QGIS con una versión

Note

Es importante que el ID de configuración de la configuración exportada y la configuración guardada en el proyecto de QGIS coincidan.

En este punto, verifique que es capaz de conectarse correctamente al servicio desde QGIS. Esta configuración de autenticación se debe exportar primero desde el propio QGIS.

Para hacer esto, los usuarios abren el diálogo de opciones de QGIS y seleccionan el panel de autenticación. Ahí, los usuarios seleccionan la configuración de QAuth2 utilizada por las capas del proyecto, haciendo clic en la fila adecuada en la tabla de configuraciones. Luego, utilizan el botón Utilidades de la parte inferior derecha para seleccionar la acción “Exportar la configuración de autenticación seleccionada a archivo”.

widgets

When prompted for a password, leave it blank. The user will be warned that he/she might be leaking sensitive information. In the case of OAuth2 configurations, it is safe to do so.

Once the user has exported the authentication configuration to an XML file, he/she copies that file onto the device(s) running QField. The file has to be copied to the device’s <main storage>/QField/auth/ directory. The /QField/auth/ path is created when first launching QField, look for it if you are not sure which storage (external or internal) is the right one.

Once the authentication configuration XML file is copied, users can copy the project file containing OAuth2-protected layer(s) onto the device(s) and open the project in QField. The user will be prompted for his/her user, password, and 2-step-verification authentication code within a browser panel that will pop up in QField itself.

Once authenticated, content will be rendered without the need to re-enter user information for the duration of the session.