IIS Konfiguration

Diese Seite beschreibt die aktuelle IIS-Konfiguration für Windows-Installationen mit:

• der Legacy Website ROOMS
• der RoomsPro API

Beide Rollen können auf demselben Server oder getrennt betrieben werden. Wenn beide Rollen auf einer Maschine installiert werden, müssen auch beide Voraussetzungen erfüllt sein.

Voraussetzungen

• Windows Server x64 mit IIS 10 oder neuer
• Für die Legacy Website ROOMS: .NET Framework 4.8
• Für die RoomsPro API: ASP.NET Core Hosting Bundle für .NET 10 (x64)

Wichtige Hinweise:

• WebDAV auf der ROOMS Website nicht aktivieren
• Die RoomsPro API ist keine klassische ASP.NET-4.x-Anwendung und benötigt stattdessen AspNetCoreModuleV2
• Die Legacy Website verwendet weiterhin klassische ASP.NET-4.x-Komponenten

Empfohlene IIS-Rollen und Features

Für die Legacy Website ROOMS

• Common HTTP Features
  • Default Document
  • HTTP Errors
  • Static Content
  • HTTP Redirection
• Health and Diagnostics
  • HTTP Logging
• Performance
  • Static Content Compression
  • Dynamic Content Compression
• Security
  • Request Filtering
  • Anonymous Authentication
  • Windows Authentication oder Basic Authentication nur für explizite Legacy-Sonderfälle
• Application Development
  • .NET Extensibility 4.8
  • ASP.NET 4.8
  • ISAPI Extensions
  • ISAPI Filters
• Windows Features
  • .NET Framework 4.8 Features

Für die RoomsPro API

• IIS mit eigenem Site- oder Application-Eintrag
• installiertes ASP.NET Core Hosting Bundle für .NET 10 (x64)
• AspNetCoreModuleV2 verfügbar
• Anonymous Authentication aktiviert

Berechtigungen

Wenn ein Service-Domänen-Account für Application Pools verwendet wird:

1. Den Account auf dem Webserver in die Gruppe IIS_IUSRS aufnehmen oder äquivalente Rechte vergeben.
2. Dem Account Lese- und Ausführungsrechte auf die jeweiligen Installationsverzeichnisse geben.
3. Falls Konfigurationsdateien oder Logs ausserhalb der Standardpfade liegen, auch dort die nötigen NTFS-Rechte vergeben.

Legacy Website ROOMS konfigurieren

1. Im IIS einen eigenen Application Pool für die Legacy Website anlegen, zum Beispiel ROOMS.

2. Als Identity den vorgesehenen Service-Account verwenden.

3. Die Website auf das Installationsverzeichnis der Legacy Website zeigen lassen, standardmässig:

   C:\inetpub\wwwroot\ROOMS
   

4. Bindings, Hostname und SSL-Zertifikate gemäss Umgebung setzen.

5. Authentifizierung passend zur Umgebung konfigurieren.

Typische Variante:

• Anonymous Authentication aktiviert
• Windows Authentication deaktiviert
• Basic Authentication deaktiviert

Für die aktuelle Standardinstallation wird die Legacy Website anonym betrieben; die eigentliche Authentisierung erfolgt über die API beziehungsweise den IdentityServer/OpenIddict-Flow. Von dieser Default-Konfiguration sollte nur abgewichen werden, wenn bewusst ein spezieller Legacy-Authentifizierungsweg betrieben wird.

Hinweis:

• Frühere Hinweise zu einem separaten Unterverzeichnis WebServices betreffen Altinstallationen. Für die aktuelle RoomsPro API wird eine eigene IIS-Site oder Application verwendet.

RoomsPro API konfigurieren

1. Im IIS eine eigene Site oder Application für die RoomsPro API anlegen.

2. Als Physical Path das API-Verzeichnis verwenden, standardmässig:

   C:\inetpub\wwwroot\API
   

3. Für die API einen separaten Application Pool verwenden.

4. Anonymous Authentication aktivieren.

5. Sicherstellen, dass das ASP.NET Core Hosting Bundle korrekt installiert ist und AspNetCoreModuleV2 geladen werden kann.

6. Die API-Konfiguration und Datenbankverbindung vor dem ersten Start prüfen.

SSL und Betrieb

• Für produktive Umgebungen ist HTTPS für Legacy Website und RoomsPro API empfohlen.
• DNS-Namen und Zertifikate für beide Sites sauber trennen und dokumentieren.
• Nach Änderungen an IIS, Bindings oder Hosting Bundle die Sites neu starten und die Logs prüfen.

Deinstallation

• IIS-Sites, Application Pools und Bindings bei Bedarf manuell löschen oder umkonfigurieren.
• Installierte Dateien werden über das MSI entfernt; die IIS-Konfiguration ist anschliessend separat zu bereinigen.