Installation

Runtime

webapi.forms basiert auf ASP.NET Core 6.0. Der Service wird inklusive der dazu notwendigen Runtime-Dateien ausgeliefert. Es ist somit keine .NET Core-Installation notwendig.

Installation IIS

• Internet Information Services (IIS) Manager öffnen
• Unter Application Pools einen neuen Application Pool hinzufügen
• Der Name des Application Pools kann frei gewählt werden
• .NET CLR Version muss No Managed Code sein
• Start application pool immediately aktivieren
• Mit Ok bestätigen
• Unter Sites eine neue Website hinzufügen
• Der Name der Site kann frei gewählt werden
• Den eben erstellten Application Pool auswählen
• Applikationspfad in Physical path hinterlegen
• Start Website immediately (optional, empfohlen aktiviert)
• Binding
  • Type: Entweder HTTP oder HTTPS (Empfohlen: HTTPS)
  • IP-Adresse: All Unassigned
  • Der Port ist frei wählbar
  • Domain in Hostname eintragen (bei HTTP optional)
  • SNI Server Name Indication (optional)
  • Bei HTTPS ein gültiges SSL Zertifikat auswählen

Installation Windows-Service

sc create <SERVICE_NAME> binPath= "<PATH_TO_SERVICE_EXECUTABLE>" --runAsWindowsService

• SERVICE_NAME: Name des Windows Services

• PATH_TO_SERVICE_EXECUTABLE: Vollständiger Pfad auf Cmi.Webapi.Forms.exe

Wichtig: nach binPath= muss ein Leerzeichen angegeben werden.

Konfiguration

Die Konfiguration erfolgt in der Datei appsettings.json. Siehe README.md

Test

Die API Swagger Dokumentation kann unter der URL "http|https://*/swagger" eingesehen werden.