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

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-09-02T09:21:21Z

Konfigurace appsettings.json

← Starší verze		Verze z 2. 9. 2025, 10:21
Řádek 34:		Řádek 34:
	"Endpoints": {		"Endpoints": {
	"Https": {		"Https": {
	"Url": "https://*:5001",		"Url": "<nowiki>https://*:5001</nowiki>",
	"Certificate": {		"Certificate": {
	"Subject": "<... zjištěná hodnota Subject ...>",		"Subject": "<... zjištěná hodnota Subject ...>",
Řádek 50:		Řádek 50:
	"Endpoints": {		"Endpoints": {
	"Https": {		"Https": {
	"Url": "https://*:5001",		"Url": "<nowiki>https://*:5001</nowiki>",
	"Certificate": {		"Certificate": {
	"Thumbprint": "<... zjištěná hodnota Thumbprint ...>",		"Thumbprint": "<... zjištěná hodnota Thumbprint ...>",

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

2025-08-29T10:43:45Z

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

← Starší verze		Verze z 29. 8. 2025, 11:43
Řádek 23:		Řádek 23:
	* <code>Thumbprint</code> – např. <code>AB12CD34EF56...</code>		* <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}}		{{Command\|Get-ChildItem -Path Cert:\LocalMachine\My}}

EnTeamAdmin v 29. 8. 2025, 10:43

2025-08-29T10:43:21Z

← Starší verze		Verze z 29. 8. 2025, 11:43
Řádek 24:		Řádek 24:

	Tyto údaje je možné zjistit pomocí aplikace PowerShell:		Tyto údaje je možné zjistit pomocí aplikace PowerShell:
	~~<syntaxhighlight lang="powershell">~~		{{Command\|Get-ChildItem -Path Cert:\LocalMachine\My}}
	Get-ChildItem -Path Cert:\LocalMachine\My
	~~</syntaxhighlight>~~

	====Konfigurace appsettings.json====		====Konfigurace appsettings.json====

EnTeamAdmin v 29. 8. 2025, 10:41

2025-08-29T10:41:30Z

← Starší verze		Verze z 29. 8. 2025, 11:41
Řá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===		===Aplikace v rámci IIS===
Řádek 83:		Řádek 83:
	====Přiřazení certifikátu k webové aplikaci====		====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...'''		* Vpravo klikněte na '''Bindings...'''
	* Zvolte '''Add...'''		* Zvolte '''Add...'''

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

2025-08-29T10:39:09Z

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

← Starší verze		Verze z 29. 8. 2025, 11:39
Řádek 81:		Řádek 81:
	Certifikát se objeví v seznamu serverových certifikátů.		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		* V IIS Manageru vyberte aplikaci enTeam.WebApi

EnTeamAdmin v 29. 8. 2025, 10:38

2025-08-29T10:38:53Z

@@ Řá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:

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-08-29T10:25:54Z

Konfigurace appsettings.json

← Starší verze		Verze z 29. 8. 2025, 11:25
Řádek 33:		Řádek 33:
	<b>Varianta se Subject:</b>		<b>Varianta se Subject:</b>
	<br>		<br>
	{
	"Kestrel": {		"Kestrel": {
	"Endpoints": {		"Endpoints": {
Řádek 47:		Řádek 46:
	}		}
	}		}
	}
	~~<br>~~

	<b>Varianta s Thumbprint:</b>		<b>Varianta s Thumbprint:</b>
	<~~syntaxhighlight lang="json"~~>		<br>
	{
	"Kestrel": {		"Kestrel": {
	"Endpoints": {		"Endpoints": {
Řádek 66:		Řádek 62:
	}		}
	}		}
	}
	~~</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>.		'''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>.

EnTeamAdmin: /* Konfigurace appsettings.json */

2025-08-29T10:23:03Z

Konfigurace appsettings.json

← Starší verze		Verze z 29. 8. 2025, 11:23
Řádek 32:		Řádek 32:

	<b>Varianta se Subject:</b>		<b>Varianta se Subject:</b>
	<~~syntaxhighlight lang="json"~~>		<br>
	{		{
	"Kestrel": {		"Kestrel": {
Řádek 48:		Řádek 48:
	}		}
	}		}
	<~~/syntaxhighlight~~>		<br>

	<b>Varianta s Thumbprint:</b>		<b>Varianta s Thumbprint:</b>

EnTeamAdmin v 29. 8. 2025, 10:04

2025-08-29T10:04:16Z

← Starší verze		Verze z 29. 8. 2025, 11: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.

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==