Integrity Control

This document in Russian / Перевод этого документа на русский язык

• README.ru.md

Contents

• Application description
• Build and use features
• Installation and build
• Screenshots
• Use cases
• Known errors
• Compatibility
• Project Structure
• Terms of Use and Participation

Application description

The Integrity Control application demonstrates the transfer of package files to the periodic integrity check by Integrityd service.

Files of this application, that were submitted for integrity control, are specified in ru.auroraos.IntegrityControl.json. This configuration file must be installed to a special directory /etc/integrityd/config.d/.

At the moment, there is one way to look through the log for integrity violation of the third-party package files events:

• The "Log Viewer" system application.

Build and use features

The project is built using the CMakeLists.txt file.

Installation and build

The project is built in the usual way using the Aurora SDK.

Screenshots

Use cases

The package files integrity violation check.

1. After installing the application, the developer can manually delete one or more package files (for example, /usr/share/icons/hicolor/128x128/apps/ru.auroraos.IntegrityControl.png) that are specified in the configuration file.
2. In order not to wait for the automatic integrity check by Integrityd service, rewind the device's system time (Settings -> Time and date) to 23:59, then wait for the integrity check until 00:01.
3. If the integrity of files was violated, the corresponding message "Third-party files integrity compromised" will appear in the "Log Viewer" application, as well as the list of files that did not pass verification.

Known errors

• In some cases, it may be necessary to restart the device after installing the application in order for the configuration files to be reloaded. Otherwise, the Integrityd service will not automatically report the package files integrity violation.

Compatibility

The project is compatible with all current versions of the Aurora OS.

Project structure

The project has a standard structure of an application based on C++ and QML for Aurora OS.

• qml directory contains the QML source code and the UI resources.
  • cover directory contains the application cover implementations.
  • pages directory contains the application pages.
  • IntegrityControl.qml file provides the application window implementation.
• src directory contains the C++ source code.
  • main.cpp file is the application entry point.
• CMakeLists.txt file describes the project structure for the CMake build system.
• ru.auroraos.IntegrityControl.desktop file defines the display and parameters for launching the application.
• translations directory contains the UI translation files.
• rpm directory contains the rpm-package build settings.
  • ru.auroraos.IntegrityControl.spec file is used by rpmbuild tool.
• files directory contains the configuration file required to add package files for periodic integrity monitoring.

Terms of Use and Participation

The source code of the project is provided under the license, which allows its use in third-party applications.

The contributor agreement documents the rights granted by contributors of the Open Mobile Platform.

Information about the contributors is specified in the AUTHORS file.

Code of conduct is a current set of rules of the Open Mobile Platform which informs you how we expect the members of the community will interact while contributing and communicating.