RSG · Deep dive

Hvad RSG er, og hvorfor du har brug for det.

Revit Server Guard er en software-gateway, der installeres på samme host som Autodesk Revit Server. Den opsnapper TCP- og HTTP-trafik til RS-portene, læser metadata (hvilken användare, hvilket projekt, hvilken sektion, hvilken handling) og anvender åtkomstsregler, som ikke findes i Revit Server selv.

ÖversiktDen här skärmen hanterar Översikt: data, filter, åtgärder och export finns i RSG-panelen. ProjektDen här skärmen hanterar Projekt: data, filter, åtgärder och export finns i RSG-panelen. RollerDen här skärmen hanterar Roller: data, filter, åtgärder och export finns i RSG-panelen. AuditloggDen här skärmen hanterar Auditlogg: data, filter, åtgärder och export finns i RSG-panelen.

01 — Oversigt

Hvad RSG er, og hvorfor du har brug for det.

Revit Server Guard er en software-gateway, der installeres på samme host som Autodesk Revit Server. Den opsnapper TCP- og HTTP-trafik til RS-portene, læser metadata (hvilken användare, hvilket projekt, hvilken sektion, hvilken handling) og anvender åtkomstsregler, som ikke findes i Revit Server selv.

Revit Server erbjuder som standard inte transparenta åtkomsträttigheter per användare, projekt, avsnitt och åtgärd. Om en deltagare har åtkomst till servern finns det ingen inbyggd modell i RS som på ett tillförlitligt sätt begränsar deltagaren till dennes ansvarsområde. I ett litet team kan det vara acceptabelt. I projekt med många företag, tillfälliga deltagare och olika ansvarsnivåer räcker utbildning och interna regler inte; RSG tar bort denna tekniska begränsning.

Hvem har brug for dette

• Tegnestuer, der kører flere kundr parallelt og ikke ønsker, at kund A’s team ser arbejde for kund B.
• BIM-koordinatorer, der skal adskille rettigheder på sektionsniveau — konstruktion ser og redigerer konstruktion, MEP ser sin egen disciplin osv.
• Entreprenører og freelancere, der får midlertidig åtkomst til et bestemt projekt og en bestemt sektion og skal kunne låses ude med ét klik, når kontrakten slutter.
• Teams med regulatoriske krav, hvor en log over hvem-öppnade-hvad-og-hvornår er obligatorisk.

01 ÖversiktDen här skärmen hanterar Översikt: data, filter, åtgärder och export finns i RSG-panelen.

02 — Arkitektur

Fire komponenter, én Windows-host.

RSG är en monolit, men med fyra separata moduler som installeras tillsammans. Det är avsiktligt: varje komponent ansvarar för sitt eget område och kan vid behov startas om oberoende.

Hvad hver komponent gør

1. RSG.Proxy — en TCP/HTTP-proxy, der lytter på port 8086 i stedet for standard RS-porten. Den pakker Revit Server SOAP-envelopes ud, udtrækker metadata, spørger RSG.Server “er dette tillåten?” og videresender eller returnerer 403 til klienten.
2. RSG.Server — en Windows-tjeneste på.NET 8, der holder åtkomstsregler i lokal SQLite/SQL Server, driver auditloggen, validerer licensen og taler med License API. Løsningens “hjerne”.
3. RSG.AdminPanel — en React SPA på localhost:5080 eller i det interne netværk via HTTPS. Admin användare den til at oprette användare, projekt, regler og se auditloggen.
4. RSG.LicenseTool — et separat CLI-værktøj til offlineaktivering. Bruges kun i isolerede netværk; er ikke nødvendigt i en normal onlineinstallation.

Vigtigt

Revit Server forbliver præcis som den var. RSG ændrer ikke binære filer, omskriver ikke databasen og erstatter ikke konfigurationer. Den kører ved siden af og användare standardnetværksinterfaces.

02 RS-gatewaysDen här skärmen hanterar RS-gateways: data, filter, åtgärder och export finns i RSG-panelen.

03 — Åtkomstkontroll

Tre niveauer af rettigheder: projekt, sektion, handling.

RSG tildeler ikke rettigheder som “alt eller intet”, men granulært. Du giver ikke “serveråtkomst” — du giver “åtkomst til projekt X, sektion Arkitektur, read-only”. Under motorhjelmen sker det på SOAP-forespørgselsniveau i Revit Server, hvor RSG inspicerer operationstypen og træffer en beslutning.

Användare og AD-grupper knyttes til roller. En rolle er et sæt rettigheder for et bestemt projekt og dets sektioner. Én användare kan have forskellige roller i forskellige projekt: “koordinator” i ét, “observatør” i et andet og “ingen åtkomst” i et tredje.

Niveauer

• Projekt. Basenheten är projektets rotmapp på servern. Användaren ser projektet i listan, men kan inte öppna det.
• Modelldel. Arkitektur, konstruktioner, teknik, koordinering — varje del kan ha egna rättigheter. Entreprenörens ingenjör öppnar bara sin egen del; resten hämtas inte ens in i Revit-klienten.
• Åtgärd. read, edit. Visning utan redigering är en separat rättighet från redigering utan publicering.

03 ProjektDen här skärmen hanterar Projekt: data, filter, åtgärder och export finns i RSG-panelen.

Roller og grupper

Nedenfor vises, hvordan det ser ud i adminpanelet. Matrixen: projekt i rækker, roller i kolonner og rettighedstilstand i cellerne.

Forklaring: fuld åtkomst · kun læsning · blandet pr. sektion · ingen

Eksempel på regelopsætning

Hver regel er udtrykt som et JSON-dokument, der kan redigeres i UI’et eller importeres batchvis fra CSV/JSON ved migrering fra interne værktøjer.

04 RollerDen här skärmen hanterar Roller: data, filter, åtgärder och export finns i RSG-panelen.

04 — Adminpanel

Et web-adminpanel i stedet for CLI og registry.

Al administration foregår via en React SPA, der er tilgængelig lokalt på RSG-hosten. Ingen regedit, ingen gpedit, ingen manuel XML-redigering. Admin öppnar en side i browseren og ser dashboard, licens, audit og rettighedsmatrix. Hvis fjernåtkomst er nødvendig, serveres panelet bag en reverse proxy med TLS.

Startsiden er dashboardet. Fire tal øverst for dagen, en event-feed nedenunder og et licenspanel.

05 AnvändareDen här skärmen hanterar Användare: data, filter, åtgärder och export finns i RSG-panelen.

06 AvsnittDen här skärmen hanterar Avsnitt: data, filter, åtgärder och export finns i RSG-panelen.

05 — Audit

Hver handling — i loggen.

Audit er ikke en valgfri funktion, men en del af hovedflowet. Hver forespørgsel, der passerer gennem RSG.Proxy, efterlader en post: hvem, hvad, mod hvilket projekt/sektion, hvilken handling, hvilket resultat, fra hvilken IP og hvilken Revit-version. Logs gemmes lokalt og eksporteres til CSV/JSON/SIEM.

Adminpanelet har en tabel med filtre på hvert felt. Et klik på en række öppnar hele event-JSON’en.

Hvad registreres

• Identitet: AD-login, IP, Revit-klientversion og användarens maskinnavn.
• Mål: projekt-ID, filnavn, sektion/workset og element-ID hvor relevant.
• Handling: open, sync_to_central, reload_latest, create_local, publish, delete_local, borrow_workset osv.
• Resultat: allow / deny / warn (warn — ikke blokeret, men markeret til gennemgang).
• Kontekst: hvilken regel traf beslutningen, timestamp med TZ og operationens varighed.

Retention

Som standard gemmes loggen i 18 måneder. Det kan konfigureres. Logs kan streames til et SIEM-system via webhook (JSON-payload), skrives til företagens SQL Server eller eksporteres batchvis via CLI.

07 AuditloggDen här skärmen hanterar Auditlogg: data, filter, åtgärder och export finns i RSG-panelen.

08 BackuperDen här skärmen hanterar Backuper: data, filter, åtgärder och export finns i RSG-panelen.

06 — Licensering

En signeret licens bundet til maskinn.

En RSG-licens er en signeret envelope (LicenseEnvelope), der indeholder en payload med rettigheder og en signatur. Signaturen oprettes på vores side med en ECDSA P-256 privat nyckel og verificeres på klientsiden med en offentlig nyckel indlejret i RSG-binæren.

Det betyder: det er umuligt at forfalske en licens eller køre “din egen License API” på samme URL uden den private nyckel. En keygen kan ikke eksistere i praksis — man skulle enten bryde ECDSA P-256 eller stjæle den private nyckel fra vores HSM.

Machine fingerprint

Licensen bindes til en maskin via et fingerprint — SHA-256 af en deterministisk streng sammensat af maskinnavn og MAC-adresser på netværksinterfaces.

Netværksinterfaces sorteres — det er vigtigt. Hvis systemet har flere MAC-adresser, kan operativsystemet enumerere dem i forskellig rækkefølge, og sortering fjerner denne ustabilitet. Maskinnavnet konverteres til store bogstaver af samme grund.

Online- og offlineaktivering

Når hosten har udgående HTTPS til vores domæne, er aktivering ét klik i adminpanelet. RSG.Server sender en JSON med fingerprint og metadata, License API returnerer en signeret envelope, som anvendes med det samme.

Når der ikke er netværk (sluten perimeter, myndighedssegment, isoleret testmiljö), foregår aktivering via filer:

1. I adminpanelet → “Generate license request” → gem request.rsgreq på et USB-drev.
2. I det personlige kabinet på webstedet → “Activate offline” → upload .rsgreq → modtag license.rsglic.
3. Upload .rsglic tilbage i adminpanelet. Færdig.

Hvad sker der efter udløb

Når trial eller en tidsbegrænset licens udløber, skifter RSG til bypass-tilstand — beskyttelsen slås fra, og Revit Server fungerer som før RSG blev installeret. Når licensen gendannes, vender RSG automatisk tilbage til full.

09 KonfigurationDen här skärmen hanterar Konfiguration: data, filter, åtgärder och export finns i RSG-panelen.

07 — Installation

På én aften: fra installer til første rolle.

RSG installeres via en Windows-installer (MSI eller EXE). Ingen docker, ingen kubernetes, ingen eksterne afhængigheder bortset fra.NET 8 LTS Runtime — som enten allerede er installeret på Windows Server 2022/2025 eller hentes af installeren.

Hvad du skal bruge før installation

• Windows Server 2019 / 2022 / 2025 på samme host som Revit Server.
• En konto med administratorrettigheder på hosten.
• Read-only-åtkomst til RS-databasen (RSG skriver ikke til den, men læser kun projektmetadata).
• Én ledig TCP-port (8086 som standard) — RSG.Proxy binder til den.
• ~250 MB diskplads til installationen, ~5 GB til auditloggen over seks måneder.

Trin

1. Ladda ner RSG-Setup-1.0.0.exe fra dit personlige kabinet.
2. Kør installeren som administrator. Angiv proxyport og sti til RS-databasen.
3. Åbn http://localhost:5080 — first-run-guiden beder dig oprette en superanvändare til adminpanelet.
4. Importér användare fra AD med ét klik, eller tilføj dem manuelt.
5. Opret den første åtkomstsregel på et testprojekt.
6. Omdirigér Revit-klienter til den nye proxyport via DNS eller Group Policy.

Konfiguration

De fleste indstillinger ligger i appsettings.json for RSG.Server. De fleste administratorer rører aldrig filen — alt kan konfigureres gennem UI’et — men nogle gange er den nødvendig.

08 — Kompatibilitet

Fungerer med det, du allerede har.

RSG er designet til eksisterende installationer, ikke kun til nye miljöer. Der kræves ikke en ny Windows-version, en ny Revit Server-version eller en ren infrastruktur. Det fungerer med det, der allerede findes.

Ydeevne

Proxyen tilføjer typisk ~3–8 ms latency pr. forespørgsel under normal belastning (målt på Xeon E-2336, Windows Server 2022, 100 samtidige Revit-klienter). Användaren mærker det ikke — Revit er alligevel ikke kendt for at være lynhurtig over netværket.

• RAM: 200–400 MB resident med 100 aktive användare.
• CPU: <5% af én kerne ved spidsbelastning.
• Disk I/O: ~15 MB/time auditlog med 100 användare.
• Netværk: næsten ingen overhead — RSG buffer ikke, men streamer proxytrafikken igennem.

10 StatistikDen här skärmen hanterar Statistik: data, filter, åtgärder och export finns i RSG-panelen.

09 — Säkerhet

Hvad RSG beskytter — og hvad det ikke gør.

Ærligt: RSG er ikke en sølvkugle. Det løser én bestemt problemklasse — autorisation til åtkomst til Revit Server. Herunder ses, hvad der ligger inden for trusselsmodellen, og hvad der ligger udenfor.

I RSG’s trusselsmodel

• En insider med legitim AD-åtkomst, der prøver at læse andres projekt. Lukket: projekt + sektion + handling kontrolleres på hver forespørgsel.
• En entreprenør, hvis kontrakt er udløbet, men hvis AD-konto ikke er deaktiveret endnu. Lukket: regler med validUntil og denyOnExpired: true.
• Læk via falsk websted eller falsk License API. Lukket: licensen er signeret med ECDSA P-256, og nyckeln er indlejret i klienten. At erstatte webstedet uden den private nyckel er umuligt.
• Flytning af licens til en andens maskin. Lukket: machine fingerprint i payloaden valideres ved hver servicestart.

Uden for RSG’s trusselsmodel

• Kompromitteret AD-server. Hvis en angriber får DA-rettigheder, får de också åtkomst til RSG.AdminPanel. Det er et AD-säkerhetsproblem, ikke RSG’s.
• Fysisk åtkomst til RSG-hosten. Med lokal adminåtkomst kan servicen stoppes. Her kræves infrastrukturbeskyttelse — BitLocker og fysisk kontrol.
• Skærmbilleder og fotos af skærmen. Hvis användaren har legitim åtkomst til et projekt, kan de se det og fotografere det. RSG er ikke en DLP-løsning.
• Læk via lokale Revit-filer. Når Revit-klienten downloader en lokal kopi af et projekt, ligger den fysisk på användarens disk. Det kræver diskkryptering og DLP.

Kryptografi

• Licenssignering: ECDSA P-256 + SHA-256, format IEEE P1363, længde 64 bytes.
• Kommunikation med License API: TLS 1.2+, certifikatvalidering.
• Intern AdminPanel ↔ RSG.Server-trafik: HTTPS med selvsigneret certifikat som standard (kan erstattes af et corporate-certifikat).
• Opbevaring af den private signeringsnyckel på vores side: managed key vault med rotationspolitik.

10 — FAQ

Ofte spurgt — specifikt om RSG.

Hvad sker der, hvis RSG.Server crasher om natten?

I så fald skifter RSG.Proxy til fail_open eller fail_closed — konfigurerbart. Som standard fail_open: når “hjernen” ikke kan nås, sender proxyen trafikken til Revit Server uden kontroller.

Hvad hvis et netværkskorts MAC ændres?

Fingerprintet ændres, og licensen afvises. To løsninger: sæt quantity = 2 ved køb, eller anmod om genudstedelse fra dit personlige kabinet — det er gratis og øjeblikkeligt.

Kan RSG køre i HA-konfiguration med to noder?

Lige nu (v2.4.x) — nej, kun single-instance. HA-konfiguration er på roadmap for v3.0. Som workaround holder teams typisk en “kold” sekundær node med samme konfiguration og skifter DNS ved fejl.

Læser RSG .rvt-filer?

Nej. RSG arbejder på Revit Servers netværksprotokolniveau — den ser SOAP-forespørgsler, projektmetadata og sektionsnavne. Den parser eller gemmer ikke modelindhold.

Hvor mange licenser skal jeg bruge til to Revit Servers?

To — hver licens er bundet til ét fingerprint, og fingerprints for to hosts er forskellige. Rabatter for multi-server-konfigurationer beregnes individuelt, skriv til info@.

Kan jeg migrere fra en intern løsning?

Hvis du har en matrix “användare × projekt × rettighed” i Excel/CSV/SQL, understøttes import til RSG via rsg-import CLI. Hvis jeres interne løsning gør noget mere komplekst, dækker RSG ikke den del.

Klar til at prøve?

Installér RSG ved siden af Revit Server i dag.90 dages trial, intet kort.

Ladda ner installeren fra dit personlige kabinet, læg den på samme host som RS, og giv det en halv time. Om aftenen ser du, hvad RSG gør, som Revit Server ikke gør som standard.