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 Monofor Identity 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

• Database authentication type and permissions

  • monosigndb_user authentican method must be SQL Authentication

  • monosigndb_user has db_owner rights on the monosigndb

New SQL Server Requirement

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

Hardware Requirement

• SQL Service port must be open on the 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

• Database authentication type and permissions

  • monosigndb_user authentican method must be SQL Authentication

  • monosigndb_user has db_owner rights on the monosigndb

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

• Database permissions

  • monosigndb_user has db_owner rights on the monosigndb

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

• Database permissions

  • monosigndb_user has db_owner rights on the monosigndb

Disk Space Calculation

Monofor stores all data within the database. Therefore, it requires disk capacity on the database server. In the table below, you can see the necessary database amount suitable for the example user numbers.

1 User Authentication Request Size : 52 KB

1 User and Profile Data Size : 2.6 MB = 2662,4 KB

Calculation = (User * User/Profile Data Size) + (User * Authentication Size * Day Count * Authentication Count)

Example 1

User Authentication Request per Day = 5

Example 2

User Authentication Request per Day = 10

Performance Metrics

Monofor products database performance is related to user authentication request. When 1 user trying to authenticate 20 SELECT and 15 INSERT operation done in the database. In the below table it can be find how many process handled by the database for number of users