Änderungen von Dokument Server-Zertifikat

Zusammenfassung

• Seiteneigenschaften (3 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Titel

...	...	@@ -1,1 +1,1 @@
1		-ServerZertifikate
	1	+Server-Zertifikate

Dokument-Autor

...	...	@@ -1,1 +1,1 @@
1		-XWiki.jelten
	1	+XWiki.erbesdob

Inhalt

...	...	@@ -1,24 +1,21 @@
1	1	{{toc/}}
2	2
3		-# Server-Zertifikate
4		-
5	5	Es werden verschiedene Fälle unterschieden:
6	6
7		-cit/in/ma.tum.de Domains auf [[Ubuntu-VM im ESXi: mit rbg-cert|Informatik.Benutzerwiki.ServerZertifikate|anchor="Ubuntu_VM"]]
	5	+ * cit/in/ma.tum.de Domains auf [[Ubuntu-VM im ESXi: mit rbg-cert|Informatik.Benutzerwiki.ServerZertifikate|anchor="Ubuntu_VM"]]
	6	+ * cit/in/ma.tum.de Domains auf anderen Maschinen: eigenständig mit [Let's Encrypt](https://certbot.eff.org/instructions) oder [[rbg-cert selber einrichten|Informatik.Benutzerwiki.ServerZertifikate|anchor="Serverzertifikat_f_252r_alle_anderen_Maschinen_44_deren_Namen_252ber_die_Strukturdb_verwaltet_werden"]]
	7	+ * andere Domains: eigenständig mit [Let's Encrypt](https://certbot.eff.org/instructions)
	8	+ * Falls keine der Optionen möglich ist: Es muss begründet werden, warum weder rbg-cert noch Let's Encrypt möglich ist, dann kann ausnahmsweise eine [[manuelle Ausstellung|Informatik.Benutzerwiki.ServerZertifikate|anchor="Sonderfall_manuelle_Ausstellung"]] erfolgen.
	9	+ * Hilfe, ich habe EC Schlüssel und muss aber in die Vergangenheit zu RSA reisen: [[Neuen Schlüssel generieren und in der Struk eintragen|Informatik.Benutzerwiki.ServerZertifikate|anchor="Vorbereitung_bei_Nutzung_von_rbg_45cert"]]
8	8
9		-* cit/in/ma.tum.de Domains auf anderen Maschinen: eigenständig mit [Let's Encrypt](https://certbot.eff.org/instructions) oder [[rbg-cert selber einrichten|Informatik.Benutzerwiki.ServerZertifikate|anchor="Serverzertifikat_f_252r_alle_anderen_Maschinen_44_deren_Namen_252ber_die_Strukturdb_verwaltet_werden"]]
10		-* andere Domains: eigenständig mit [Let's Encrypt](https://certbot.eff.org/instructions)
11		-* Falls keine der Optionen möglich ist: Es muss begründet werden, warum weder rbg-cert noch Let's Encrypt möglich ist, dann kann ausnahmsweise eine [[manuelle Ausstellung|Informatik.Benutzerwiki.ServerZertifikate|anchor="Sonderfall_manuelle_Ausstellung"]] erfolgen.
12		-* Hilfe, ich habe EC Schlüssel und muss aber in die Vergangenheit zu RSA reisen: [[Neuen Schlüssel generieren und in der Struk eintragen|Informatik.Benutzerwiki.ServerZertifikate|anchor="Vorbereitung_bei_Nutzung_von_rbg_45cert"]]
	11	+# Ubuntu VM
13	13
14		-## Ubuntu VM
15		-
16	16	Für neue VMs ist die erforderliche Software bereits vorinstalliert.
17	17
18		-1 In der [StrukturDB](https://rbgwebapp.in.tum.de/struktur/) müssen alle Aliase korrekt eingetragen sein. Bei Service-IPs muss `servicehost` auf den tatsächlichen Host (also Server/VM/...) verweisen.
19		-1 Das Zertifikat wird dann in `/var/lib/rbg-cert/live/HOST.cert.pem` liegen
20		-1 Um auf der Maschine die Dienste neuzustarten/neuzuladen, wenn ein neues Zertifikat da ist, legt man scripte in `/usr/local/cert.d/` ab, die mit `run-parts(8)` kompatibel sind. Das erste Argument ist der Teilpfad zum neuen Zertifikat. Unten ist ein Beispielscript für einen Apache2-reload.
21		-1 Nun kann man mit `rbg-cert` Zertifikate beantragen:
	15	+ 1. In der [StrukturDB](https://rbgwebapp.in.tum.de/struktur/) müssen alle Aliase korrekt eingetragen sein. Bei Service-IPs muss `servicehost` auf den tatsächlichen Host (also Server/VM/...) verweisen.
	16	+ 1. Das Zertifikat wird dann in `/var/lib/rbg-cert/live/HOST.cert.pem` liegen
	17	+ 1. Um auf der Maschine die Dienste neuzustarten/neuzuladen, wenn ein neues Zertifikat da ist, legt man scripte in `/usr/local/cert.d/` ab, die mit `run-parts(8)` kompatibel sind. Das erste Argument ist der Teilpfad zum neuen Zertifikat. Unten ist ein Beispielscript für einen Apache2-reload.
	18	+ 1. Nun kann man mit `rbg-cert` Zertifikate beantragen:
22	22
23	23	```
24	24	# Zur Kontrolle die konfigurierten Namen abfragen, fehlende in der StrukturDB eintragen!
...	...	@@ -33,12 +33,12 @@
33	33
34	34	Bitte modifiziert unsere Software nicht, denn sie wird zentral von uns aktualisiert. Bei Fragen/Anregungen gerne die Systemgruppe kontaktieren.
35	35
36		-### Beispiel-Script für server reload
	33	+## Beispiel-Script für server reload
37	37
38	38	Da Programme (nginx, postfix, ...) nicht riechen können, wann ein neues Zertifikat da ist, muss man ihnen das mitteilen.
39	39	Am einfachsten mit Scripten in `/usr/local/cert.d/...`, die ausführbar sind (`chmod +x`):
40	40
41		-### Beispiel für Apache
	38	+## Beispiel für Apache
42	42
43	43	Im `VirtualHost` Block in `/etc/apache2/sites-enabled/MYSERVICE.conf`:
44	44
...	...	@@ -65,7 +65,7 @@
65	65	systemctl reload apache2.service
66	66	```
67	67
68		-### Beispiel für nginx
	65	+## Beispiel für nginx
69	69
70	70	```
71	71	$ cat /etc/nginx/conf.d/ssl.conf
...	...	@@ -110,7 +110,7 @@
110	110	systemctl reload nginx.service
111	111	```
112	112
113		-### Allgemeines Beispiel
	110	+## Allgemeines Beispiel
114	114
115	115	```
116	116	$ cat /usr/local/cert.d/yourservice
...	...	@@ -126,13 +126,13 @@
126	126	#systemctl reload mydaemon
127	127	```
128	128
129		-## Serverzertifikat für alle anderen Maschinen, deren Namen über die Strukturdb verwaltet werden
	126	+# Serverzertifikat für alle anderen Maschinen, deren Namen über die Strukturdb verwaltet werden
130	130
131	131	Für andere Maschinen können die Zertifikate über API bezogen werden, sofern die Namen alle in der Strukturdb verwaltet werden. Die Namen müssen also ebenfalls wie obenstehend beschrieben in der Strukturdb konfiguriert werden.
132	132
133	133	_Wir bitten, vor der Nutzung die Systemgruppe zur Beratung zu kontaktieren_. Im Lauf der Zeit können API-Änderungen notwendig werden, dies bitte im Hinterkopf behalten.
134	134
135		-### Vorbereitung bei Nutzung von rbg-cert
	132	+## Vorbereitung bei Nutzung von rbg-cert
136	136
137	137	Das Programm `rbg-cert` verwendet auch die API, d.h. man kann es auf andere Maschinen portieren.
138	138	Zur Vorbereitung auf den Einsatz von rbg-cert sind folgende Schritte notwendig:
...	...	@@ -157,11 +157,11 @@
157	157
158	158	Falls Eigenentwicklungen zwingend notwendig sind, bitte das Verhalten von rbg-cert beibehalten!
159	159
160		-### Enrollment
	157	+## Enrollment
161	161
162	162	Der public key wird im Hosteintrag in der StrukturDB gespeichert. Bspw. per struklib auf lsadmin oder per <https://rbgwebapp.in.tum.de/struktur/treeview.> Nach spätestens einer guten Minute sollte der Key dann der RA bekannt sein, ab diesem Zeitpunkt kann die API verwendet werden.
163	163
164		-### API
	161	+## API
165	165
166	166	Production:
167	167
...	...	@@ -176,17 +176,18 @@
176	176
177	177	Public keys können im Moment nicht aus der RA entfernt werden, bei Kompromittierung bitte den public key ersetzen.
178	178
179		-## Sonderfall manuelle Ausstellung
	176	+# Sonderfall manuelle Ausstellung
180	180
181	181	Manuelle Ausstellung mit Genehmigung durch RBG nur möglich, wenn technisch weder rbg-cert noch Let's Encrypt möglich sind:
182	182
183		-1. Auf dem Zielserver z.B. nach `/etc/ssl/private`
184		-1. Certificate Signing Request (`csr`) erzeugen
185		-`openssl req -newkey rsa:3072 -nodes -keyout SERVERNAME.key -out SERVERNAME.csr -subj '/C=DE/O=Technische Universitaet Muenchen/CN=SERVERNAME.cit.tum.de' -addext "subjectAltName = DNS:OTHERNAME.cit.tum.de, DNS:ANOTHERNAME.cit.tum.de"`
186		-1. [Bei der CA](https://cert-manager.com/customer/DFN/ssl/dUIh9O1QABKy40PikBgN):
	180	+ 1. Auf dem Zielserver z.B. nach `/etc/ssl/private`
	181	+ 1. Certificate Signing Request (`csr`) erzeugen
	182	+`openssl req -newkey rsa:3072 -nodes -keyout SERVERNAME.key -out SERVERNAME.csr -subj '/C=DE/O=Technische Universitaet Muenchen/CN=SERVERNAME.cit.tum.de'`
	183	+ - weitere namen in csr packen: `-addext "subjectAltName = DNS:OTHERNAME.cit.tum.de, DNS:ANOTHERNAME.cit.tum.de"`
	184	+ 1. [Bei der CA](https://cert-manager.com/customer/DFN/ssl/dUIh9O1QABKy40PikBgN):
187	187	1. `.csr` hochladen
188	188	1. unter "Subject Alternative Names" alle weiteren ggf. benötigten Namen eintragen
189	189	1. alle anderen Felder leer lassen
190		-1. Bitte den `commonName` (CN) mit Begründung warum rbg-cert und Let's Encrypt nicht möglich sind per E-Mail an <rbg@in.tum.de> schicken.
191		-1. auf "Certificate approved" E-Mail warten, "Certificate ID" entnehmen
192		-1. [herunterladen](https://cert-manager.com/customer/DFN/idp/ssl/dUIh9O1QABKy40PikBgN?action=download) mit ID und "Certificate (w/issuer after)"
	188	+ 1. Bitte den `commonName` (CN) mit Begründung warum rbg-cert und Let's Encrypt nicht möglich sind per E-Mail an <rbg@in.tum.de> schicken.
	189	+ 1. auf "Certificate approved" E-Mail warten, "Certificate ID" entnehmen
	190	+ 1. [herunterladen](https://cert-manager.com/customer/DFN/idp/ssl/dUIh9O1QABKy40PikBgN?action=download) mit ID und "Certificate (w/issuer after)"