Software Requirements - v2023.04

Software Requirements

Monofor server needs some software packages to work correctly. In the Monofor Server environment, required software packages and docker engine services must be installed or can be installed during the installation on the Linux server.

Operating System Packages

For Ubuntu/Debian

apt-get install -y build-essential traceroute ethtool dnsutils \
open-vm-tools net-tools tcpdump apt-transport-https ca-certificates \
curl software-properties-common unzip gnupg jq bash-completion netcat bc

For Redhat/Centos/Rocky

• YUM Package Manager

yum install -y yum-utils traceroute ethtool open-vm-tools net-tools bind-utils \
epel-release net-tools tcpdump ca-certificates curl unzip gnupg2 jq \
bash-completion netcat bc

• DNF Package Manager

dnf install -y yum-utils traceroute ethtool open-vm-tools net-tools bind-utils \
epel-release net-tools tcpdump ca-certificates curl unzip gnupg2 jq \
bash-completion netcat bc

• Bash Completion

curl https://raw.githubusercontent.com/docker/docker-ce/master/components/cli/contrib/completion/bash/docker -o /etc/bash_completion.d/docker.sh

Docker Packages

Monofor Server required docker engine services listed in the below.

Docker engine packages can be install from official docker repositories. Please check this page to install correct version for your Linux Server distros.

Docker engine packages list:

• docker-ce

• docker-ce-cli

• containerd.io

• docker-buildx-plugin

• docker-compose-plugin

Monofor PoC environment doesn’t require external databases. Monosign PoC installer has local database container and it will install during the PoC installation.

Operating System Firewall

Operating System firewall must be disabled.

Red Hat/Centos

systemctl disable firewall

system stop firewall

Debian/Ubuntu

systemctl disable ufw

systemctl stop ufw

DNS Requirements

Monosign application and services need domain names on the internal and external DNS system. In the table below, required domain names defined. These are the default values of the DNS names. However, if needed they can change to any values.

If the Monosign Authenticator Push Service wants to be used via the internet, the Account application must be published on the internet. For this access, monosign-account.domain.com domain name must be configured on the external DNS system, and firewall ports must be opened. For firewall requirements, you can check this page.

Timezone and the NTP configuration

Linux server timezone and the NTP configuration must be done on the Linux server.

It can be check with the below link

timedatectl

SSL Certificate Requirements

Monosign has multiple web services, and every service has different functionality. Monosign uses secure communications, internal services and external integrations. Due to this, Monosign services need a wildcard SSL certificate to work properly.

SSL Certificate Options

- Public certificate must be signed by one of Global Certificate Authorities
- Public certificate format must be base64 encoded CRT format
- Public certificate contains full chain certificate like root CA, and intermediate CA.
- Private key should not be exported password protected
- Private key format must be RSA format

During the installation, a self-signed certificate is generated by the installer. If wanted to use custom certificate it can be install later.

Database Requirements

Monosign application and services keep data on the database. Database server/service is the main component of the Monosign. Monosign has supported two types of database server/service, one of them must be chosen.

• Microsoft SQL Server

• PostgreSQL Server

All details are described below.

Microsoft SQL Server

Monosign needs a database server. This database contains all Monosign data and configurations.

Supported Microsoft Database Servers

Microsoft SQL Server Express Edition not supported.

Existing SQL Server Requirement

• If Monosign will be installed on an existing Microsoft SQL Server

• SQL Server collation must be chosen SQL_Latin1_General_CP1_CI_AS

• Specific database user

  • Example: monosigndb_user

• Database to be created

  • monosigndb – for Monosign Main Database

  • monosyncdb – for Monosync Main Database

• Database authentication type and permissions

  • monosigndb_user authentican method must be SQL Authentication

  • monosigndb_user has db_owner rights on the monosigndb, monosyncdb

New SQL Server Requirement

• If Monosign will be installed on a New Microsoft SQL Server Instance

Hardware Requirement

• SQL Server collation must be chosen SQL_Latin1_General_CP1_CI_AS

• Specific database user

  • Example: monosigndb_user

• Database to be created

  • monosigndb – for Monosign Main Database

  • monosyncdb – for Monosync Main Database

• Database authentication type and permissions

  • monosigndb_user authentican method must be SQL Authentication

  • monosigndb_user has db_owner rights on the monosigndb, monosyncdb

PostgreSQL Server Requirements

Monosign needs a database server. This database contains all Monosign data and configurations.

Supported PostgreSQL Server Version

Existing PostgreSQL Server Requirements

• If Monosign will be installed on an existing PostgreSQL Server

• Specific database user

  • Example: monosigndb_user

• Database to be created

  • monosigndb – for Monosign Main Database

  • monosyncdb – for Monosync Main Database

• Database permissions

  • monosigndb_user has db_owner rights on the monosigndb, monosyncdb

New PostgreSQL Server Requirements

• If Monosign will be installed on a New PostgreSQL Server Instance

Hardware Requirement

• Specific database user

  • Example: monosigndb_user

• Database to be created

  • monosigndb – for Monosign Main Database

  • monosyncdb – for Monosync Main Database

• Database permissions

  • monosigndb_user has db_owner rights on the monosigndb, monosyncdb