Přesměrování nešifrované komunikace na protokol HTTPS - Historie editací

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-09-02T09:21:21Z

‎Konfigurace appsettings.json

EnTeamAdmin: /* Zjištění údajů certifikátu */

2025-08-29T10:43:45Z

‎Zjištění údajů certifikátu

EnTeamAdmin v 29. 8. 2025, 10:43

2025-08-29T10:43:21Z

EnTeamAdmin v 29. 8. 2025, 10:41

2025-08-29T10:41:30Z

EnTeamAdmin: /* =Přiřazení certifikátu k webové aplikaci */

2025-08-29T10:39:09Z

‎=Přiřazení certifikátu k webové aplikaci

EnTeamAdmin v 29. 8. 2025, 10:38

2025-08-29T10:38:53Z

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-08-29T10:25:54Z

‎Konfigurace appsettings.json

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-08-29T10:23:03Z

‎Konfigurace appsettings.json

EnTeamAdmin v 29. 8. 2025, 10:04

2025-08-29T10:04:16Z

EnTeamAdmin: Založena nová stránka s textem „==Přesměrování nešifrované komunikace na protokol HTTPS==“

2025-08-06T07:42:06Z

Založena nová stránka s textem „==Přesměrování nešifrované komunikace na protokol HTTPS==“

Nová stránka

==Přesměrování nešifrované komunikace na protokol HTTPS==

@@ Řádek 34: / Řádek 34: @@
      "Endpoints": {
        "Https": {
-         "Url": "https://*:5001",
+         "Url": "<nowiki>https://*:5001</nowiki>",
          "Certificate": {
            "Subject": "<... zjištěná hodnota Subject ...>",
@@ Řádek 50: / Řádek 50: @@
      "Endpoints": {
        "Https": {
-         "Url": "https://*:5001",
+         "Url": "<nowiki>https://*:5001</nowiki>",
          "Certificate": {
            "Thumbprint": "<... zjištěná hodnota Thumbprint ...>",

@@ Řádek 23: / Řádek 23: @@
 * <code>Thumbprint</code> – např. <code>AB12CD34EF56...</code>
-Tyto údaje je možné zjistit pomocí aplikace PowerShell:
+Tyto údaje je možné zjistit pomocí aplikace PowerShell:<br>
 {{Command|Get-ChildItem -Path Cert:\LocalMachine\My}}

@@ Řádek 24: / Řádek 24: @@
 Tyto údaje je možné zjistit pomocí aplikace PowerShell:
-<syntaxhighlight lang="powershell">
+{{Command|Get-ChildItem -Path Cert:\LocalMachine\My}}
 ====Konfigurace appsettings.json====

@@ Řádek 63: / Řádek 63: @@
+   }
-'''Poznámka:''' Klíč <code>AllowInvalid: false</code> zakazuje použití samo-podepsaných (self-signed) certifikátů. V neprodukčním prostředí lze jejich použití povolit nastavením hodnoty <code>true</code>.
+{{Note|Poznámka: Klíč <code>AllowInvalid: false</code> zakazuje použití samo-podepsaných (self-signed) certifikátů. V neprodukčním prostředí lze jejich použití povolit nastavením hodnoty <code>true</code>.}}
 ===Aplikace v rámci IIS===
@@ Řádek 83: / Řádek 83: @@
 ====Přiřazení certifikátu k webové aplikaci====
-* V IIS Manageru vyberte aplikaci enTeam.WebApi
+* V IIS Manageru vyberte aplikaci {{FileName|enTeam.WebApi}}
 * Vpravo klikněte na '''Bindings...'''
 * Zvolte '''Add...'''

@@ Řádek 81: / Řádek 81: @@
 Certifikát se objeví v seznamu serverových certifikátů.
-====Přiřazení certifikátu k webové aplikaci===
+====Přiřazení certifikátu k webové aplikaci====
 * V IIS Manageru vyberte aplikaci enTeam.WebApi

@@ Řádek 65: / Řádek 65: @@
 '''Poznámka:''' Klíč <code>AllowInvalid: false</code> zakazuje použití samo-podepsaných (self-signed) certifikátů. V neprodukčním prostředí lze jejich použití povolit nastavením hodnoty <code>true</code>.
-== 4. Přístupová práva ==
+===Aplikace v rámci IIS===
-Pokud je certifikát uložen v <code>LocalMachine\My</code>, aplikace musí mít odpovídající oprávnění:
+====Import certifikátu do IIS====
-Pro ladění můžeš použít <code>StoreLocation.CurrentUser</code>, kde oprávnění nejsou potřeba.
+Certifikát ve formátu <code>.pfx</code> importujte do IIS následujícím postupem:

@@ Řádek 33: / Řádek 33: @@
 <b>Varianta se Subject:</b>
 <br>
    "Kestrel": {
      "Endpoints": {
@@ Řádek 47: / Řádek 46: @@
+     }
+   }
 <b>Varianta s Thumbprint:</b>
-<syntaxhighlight lang="json">
+<br>
    "Kestrel": {
      "Endpoints": {
@@ Řádek 66: / Řádek 62: @@
+     }
+   }
 '''Poznámka:''' Klíč <code>AllowInvalid: false</code> zakazuje použití samo-podepsaných (self-signed) certifikátů. V neprodukčním prostředí lze jejich použití povolit nastavením hodnoty <code>true</code>.

← Starší verze		Verze z 29. 8. 2025, 10:04
Řádek 1:		Řádek 1:
−	==~~Přesměrování nešifrované~~ komunikace na ~~protokol HTTPS~~==	+	==Nastavení HTTPS==
		+	Pro zajištění bezpečnosti komunikace klientů s webovým rozhraním aplikace enTeam doporučujeme nastavit šifrovanou komunikaci pomocí protokolu HTTPS.<br>
		+	Nastavení HTTPS se liší dle způsobu provozování webového rozhraní (služba OS Windows vs. aplikace provozovaná v IIS).
		+
		+	===Předpoklady===
		+	Jediným předpokladem nastavení HTTPS je existence použitelného SSL certifikátu, který splňuje následující podmínky:
		+	* je platný (časově)
		+	* je vydaný na doménu, na které je provozováno webové rozhraní enTeam
		+	* obsahuje rozšíření "Server Authentication" (Extended Key Usage = Server Authentication)
		+	* je vydán uznávanou certifikační autoritou
		+	* obsahuje privátní klíč
		+
		+	Pro jednoduchost budeme dále v textu předpokládat, že certifikát je na serveru importován do úložiště certifikátů <code>LocalMachine\My</code> a je dostupný pro uživatele, pod kterým běží webový server s webovým rozhraním enTeam.
		+
		+	===Služba OS Windows===
		+	V případě, že webové rozhraní enTeam je provozováno jako služba operačního systému Windows, je pro jeho běh použit webový server Kestrel.<br>
		+	Kompletní dokumentaci nastavení webového serveru Kestrel lze nalézt na https://learn.microsoft.com/en-us/aspnet/core/fundamentals/servers/kestrel/endpoints?view=aspnetcore-8.0
		+
		+	====Zjištění údajů certifikátu====
		+
		+	Pro konfiguraci je třeba znát buď:
		+	* <code>Subject</code>, nebo
		+	* <code>Thumbprint</code> – např. <code>AB12CD34EF56...</code>
		+
		+	Tyto údaje je možné zjistit pomocí aplikace PowerShell:
		+	<syntaxhighlight lang="powershell">
		+	Get-ChildItem -Path Cert:\LocalMachine\My
		+	</syntaxhighlight>
		+
		+	====Konfigurace appsettings.json====
		+	V adresáři projektu upravte soubor <code>appsettings.json</code>:
		+
		+	<b>Varianta se Subject:</b>
		+	<syntaxhighlight lang="json">
		+	{
		+	"Kestrel": {
		+	"Endpoints": {
		+	"Https": {
		+	"Url": "https://*:5001",
		+	"Certificate": {
		+	"Subject": "<... zjištěná hodnota Subject ...>",
		+	"Store": "My",
		+	"Location": "LocalMachine",
		+	"AllowInvalid": false
		+	}
		+	}
		+	}
		+	}
		+	}
		+	</syntaxhighlight>
		+
		+	<b>Varianta s Thumbprint:</b>
		+	<syntaxhighlight lang="json">
		+	{
		+	"Kestrel": {
		+	"Endpoints": {
		+	"Https": {
		+	"Url": "https://*:5001",
		+	"Certificate": {
		+	"Thumbprint": "<... zjištěná hodnota Thumbprint ...>",
		+	"Store": "My",
		+	"Location": "LocalMachine",
		+	"AllowInvalid": false
		+	}
		+	}
		+	}
		+	}
		+	}
		+	</syntaxhighlight>
		+
		+	'''Poznámka:''' Klíč <code>AllowInvalid: false</code> zakazuje použití samo-podepsaných (self-signed) certifikátů. V neprodukčním prostředí lze jejich použití povolit nastavením hodnoty <code>true</code>.
		+
		+	== 4. Přístupová práva ==
		+
		+	Pokud je certifikát uložen v <code>LocalMachine\My</code>, aplikace musí mít odpovídající oprávnění:
		+	* Spouštěj jako správce
		+	* Nebo běž jako Windows služba s přístupem k privátním klíčům
		+
		+	Pro ladění můžeš použít <code>StoreLocation.CurrentUser</code>, kde oprávnění nejsou potřeba.