REVIEWITDocumentation
ReferenceUp to date · verified on 14 October 2026

Prepare your information system for REVIEWIT on-premises

Machine translation, not yet reviewedThis page was translated by a model from the French version, which is authoritative. Read the French version.

01What you prepare, what REVIEWIT provides #sec_86b56fb2

An on-premises installation brings together several teams: infrastructure, network, security, databases, identity, messaging, backup. This page provides each team with the list of what they need to prepare before installation.

REVIEWIT provides everything else in a signed installation package, usable without Internet access: REVIEWIT services, .NET 10 runtime, PostgreSQL 17, OpenBao key vault, Java 21 (composition of signed PDFs), PowerShell 7, and deployment tools. Each component is verified against the package's signed manifest before installation.

02Infrastructure #sec_a4084a12

To prepareRequirement
SystemWindows Server 2022 or 2025, Standard or Datacenter, up to date with the latest cumulative update; full interface or Server Core
MachinesVirtual or physical, x64, according to the chosen scenario
DomainActive Directory: mandatory in 3-tier, recommended on a single server
High availability (S3, S4)Failover Clustering feature on the two data servers, and a shared storage (SAN) validated by the cluster validation wizard
ClockOffset less than one second on all servers: proof sealing is timestamped
AntivirusExclusions for PostgreSQL data directories and the vault; binary scanning remains active

03Network #sec_ff3ded81

To prepareRequirement
Access nameA generic DNS record ** *.reviewit.<your-domain> ** pointing to the access address. Adding a subscription afterward requires neither a DNS ticket, nor a certificate, nor a load balancer change
Load balancer (3-tier)Layer 7, in redundant pair: TLS, WebSocket, cookie affinity, HTTP probe on /healthz, idle timeout of at least 60 minutes; a second access point in TCP mode for the key vault (S3, S4). The assistant generates the configuration to hand over to your network team
FlowsThe detailed matrix is in the architecture. No flow to the Internet is necessary
Declared networksREVIEWIT only joins a private service in your network (SMTP relay, SIEM, object storage, directory) if its network is declared during installation: a closed list of narrow networks, never the local loop
Outbound proxy (optional)Only if collection targets online services: an HTTP proxy that authorizes REVIEWIT servers by their address

04Security and certificates #sec_afbdd744

To prepareRequirement
Access certificateIssued by your internal PKI for *.reviewit.<your-domain>, placed on the load balancer (or on the single server)
Server certificatesOne certificate per application server (re-encryption from the load balancer), one for PostgreSQL, one for the key vault
RevocationYour PKI's revocation list must be reachable from the servers
Key vaultEither a PKCS#11 compatible HSM (auto-unlock on restart), or custodians: five named individuals, three of whom are sufficient to unlock. See Your keys, your proofs
Root key ceremonyCustodians are present on installation day: the root sealing key is created on-site, once

Internal certificates between REVIEWIT services are issued by REVIEWIT's own PKI, created during installation: your team has nothing to do.

05Databases #sec_d9c7f5d7

Two possibilities:

  • PostgreSQL 17 installed by REVIEWIT, from the package — on the single server, or in a Windows failover cluster role on the data servers;
  • an already operated PostgreSQL 17 instance by your database administrators. REVIEWIT then requires an operational account capable of creating databases and roles (CREATEDB, CREATEROLE), nothing more.

Each subscription receives its own databases and roles, with no connection rights to those of another. No password is written in a configuration file.

06Identity #sec_52e626f6

To prepareRequirement
Identity providerOIDC: AD FS 2019 or newer, Entra ID, Keycloak, Okta, or any compliant OIDC provider
ApplicationA confidential OIDC application «REVIEWIT», with the return address https://auth.reviewit.<your-domain>/federation/callback
First administratorThe username of the person who will administer the installation
Directory to certifyA read account for the directory (LDAPS) on the organizational units covered by the reviews

07Messaging #sec_aa7f0e6f

An internal SMTP relay, encrypted mandatory: STARTTLS on port 587 or 25, or implicit TLS on port 465, under a certificate recognized by your PKI. The relay accepts the REVIEWIT servers by a sending account, or by their IP address. A sender address from your organization's domain completes the setup.

08Backup and operation #sec_d9091c4f

To prepareRequirement
BackupA tool capable of backing up files and triggering a script (or a PostgreSQL agent). REVIEWIT produces backups of databases and encrypted snapshots of the vault; your tool takes them away
SupervisionThe /healthz probe of each service and the Windows event log, one source per service
SIEM (optional)Splunk HEC, Elastic, or an HTTPS receiver, to receive the sealed audit trail
Object storage (optional)An S3-compatible storage in your network (path addressing, port 443 or 8088), to deposit the audit trail
Timestamping (optional)An RFC 3161 timestamping authority of your organization

09The day of installation #sec_b9a7a3ee

  1. The servers are installed, up to date, joined to the domain; certificates are issued; the generic DNS record responds.
  2. The installation account (local administrator of the servers, for the duration of the installation) is available.
  3. The vault custodians are present, or the HSM is reachable.
  4. The OIDC application exists at your identity provider; the SMTP relay is reachable.
  5. The license file provided by REVIEWIT is available.

The installation of a single server by a prepared team can be completed in one day; a high-availability architecture is deployed in a precise order — data servers first, then application servers.

Esc
↑↓ navigate↵ openSee all results →