Menü der Dokumentation

Festlegen eines anderen Ports und HTTP-Protokolls

Standardmäßig wird der Port der App dynamisch ermittelt. Sie können den Port und das HTTP-Protokoll bei Bedarf auch ändern.

Angenommen, Sie möchten den Port festlegen und http für das Protokoll verwenden.

So geht's

  1. Erstellen Sie im Installationsverzeichnis der App einen Ordner mit dem Namen conf.

  2. Erstellen Sie eine Datei mit dem Namen appsettings.json.

  3. Geben Sie den Port an, indem Sie für die obere und untere Grenze jeweils denselben Wert eintragen.

  4. Geben Sie für protocol den Wert http an. Beispiel:

    {
      "port lower bound": "4100",
      "port upper bound": "5000",
      "protocol": "http"
    }
  5. Starten Sie die App neu.

Sie können jedoch auch die Suche nach einem freien Port konfigurieren:

  • port lower bound: Gibt die untere Grenze an, oberhalb derer die App nach einem freien Port suchen soll.

  • port upper bound: Gibt die obere Grenze an, unterhalb derer die App nach einem freien Port suchen soll.

  • protocol: Gibt das Protokoll an, über das die App die Verbindungen aufbauen soll. Die möglichen Werte sind http oder https.

Wenn Sie https verwenden, geben Sie das Zertifikat in der Datei appsettings.json an. Um ein Zertifikat aus dem Windows-Zertifikatsspeicher zu verwenden, können Sie z.B. folgende Angaben in der Datei festlegen:

{
  "port lower bound": 4100,
  "port upper bound": 4100,
  "protocol": "https",
  "Kestrel": {
    "Certificates": {
      "Default": {
        "Subject": "d3one1.dev.local",
        "Store": "My",
        "Location": "LocalMachine"
      }
    }
  }
}

Anhand der folgenden Tabelle können Sie nachvollziehen, wie die Einträge im Windows-Zertifikatsspeicher mit den Einträge in der Datei appsettings.json und den entsprechenden PowerShell-Skripten zusammenhängen:

Windows-Zertifikatsspeicher

"appsettings.json"

PowerShell

Local Computer

LocalMachine

get-childitem -path Cert:\LocalMachine

Current User

CurrentUser

get-childitem -path Cert:\CurrentUser

Personal

My

get-childitem -path Cert:\LocalMachine\My

Trusted Root Certification Authority

Root

get-childitem -path Cert:\LocalMachine\Root

Subject

Subject

Nicht vorhanden