Prepare your information system for REVIEWIT on-premises
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 prepare | Requirement |
|---|---|
| System | Windows Server 2022 or 2025, Standard or Datacenter, up to date with the latest cumulative update; full interface or Server Core |
| Machines | Virtual or physical, x64, according to the chosen scenario |
| Domain | Active 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 |
| Clock | Offset less than one second on all servers: proof sealing is timestamped |
| Antivirus | Exclusions for PostgreSQL data directories and the vault; binary scanning remains active |
03Network #sec_ff3ded81
| To prepare | Requirement |
|---|---|
| Access name | A 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 |
| Flows | The detailed matrix is in the architecture. No flow to the Internet is necessary |
| Declared networks | REVIEWIT 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 prepare | Requirement |
|---|---|
| Access certificate | Issued by your internal PKI for *.reviewit.<your-domain>, placed on the load balancer (or on the single server) |
| Server certificates | One certificate per application server (re-encryption from the load balancer), one for PostgreSQL, one for the key vault |
| Revocation | Your PKI's revocation list must be reachable from the servers |
| Key vault | Either 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 ceremony | Custodians 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 prepare | Requirement |
|---|---|
| Identity provider | OIDC: AD FS 2019 or newer, Entra ID, Keycloak, Okta, or any compliant OIDC provider |
| Application | A confidential OIDC application «REVIEWIT», with the return address https://auth.reviewit.<your-domain>/federation/callback |
| First administrator | The username of the person who will administer the installation |
| Directory to certify | A 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 prepare | Requirement |
|---|---|
| Backup | A 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 |
| Supervision | The /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
- The servers are installed, up to date, joined to the domain; certificates are issued; the generic DNS record responds.
- The installation account (local administrator of the servers, for the duration of the installation) is available.
- The vault custodians are present, or the HSM is reachable.
- The OIDC application exists at your identity provider; the SMTP relay is reachable.
- 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.