Upcoming Events

Installation

Requirements

  • Icinga Web 2 (>= 2.5)
  • PHP (>= 5.6, preferably 7.x)
  • php-gmp
  • OpenSSL
  • MySQL or MariaDB
  • Icinga Web 2 modules:
  • reactbundle (>= 0.4) (Icinga Web 2 module)
  • Icinga PHP Library (ipl) (>= 0.1) (Icinga Web 2 module)

Database Setup

The module needs a MySQL/MariaDB database with the schema that’s provided in the etc/schema/mysql.schema.sql file.

Note that if you’re using a version of MySQL < 5.7 or MariaDB < 10.2, the following server options must be set:

innodb_file_format=barracuda
innodb_file_per_table=1
innodb_large_prefix=1

Example command for creating the MySQL/MariaDB database. Please change the password:

CREATE DATABASE x509;
GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON x509.* TO x509@localhost IDENTIFIED BY 'secret';

After, you can import the schema using the following command:

mysql -p -u root x509 < etc/schema/mysql.schema.sql

Installation

  1. Just drop this module to a x509 subfolder in your Icinga Web 2 module path.

  2. Log in with a privileged user in Icinga Web 2 and enable the module in Configuration -> Modules -> x509. Or use the icingacli and run icingacli module enable x509.

  3. Once you’ve set up the database, create a new Icinga Web 2 resource for it using the Configuration -> Application -> Resources menu.

  4. The next step involves telling the X.509 module which database resource to use. This can be done in Configuration -> Modules -> x509 -> Backend.

This concludes the installation. You should now be able to import CA certificates and set up scan jobs. Please read the Configuration section for details.