Änderungen von Dokument Server-Zertifikat

Zuletzt geändert von Michael Oberrauch am 2025/11/03 18:42
Von Version 6.1
bearbeitet von Thomas Walter Erbesdobler
am 2023/07/06 14:50
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 20.1
bearbeitet von Leo Fahrbach
am 2025/08/14 10:29
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -Server-Zertifikate
1 +Server-Zertifikat
Übergeordnete Seite
... ... @@ -1,0 +1,1 @@
1 +CIT.ITO.Docs.Services.Certificates.WebHome
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.erbesdob
1 +XWiki.fahrbach
Inhalt
... ... @@ -2,11 +2,10 @@
2 2  
3 3  Es werden verschiedene Fälle unterschieden:
4 4  
5 -cit/in/ma.tum.de Domains auf [[Ubuntu-VM im ESXi: mit rbg-cert|Informatik.Benutzerwiki.ServerZertifikate|anchor="Ubuntu_VM"]]
6 -
5 +* cit/in/ma.tum.de Domains auf [[Ubuntu-VM im ESXi: mit rbg-cert|Informatik.Benutzerwiki.ServerZertifikate|anchor="Ubuntu_VM"]]
7 7  * 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"]]
8 8  * andere Domains: eigenständig mit [Let's Encrypt](https://certbot.eff.org/instructions)
9 -* 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.
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="HSonderfallmanuelleAusstellung"]] erfolgen.
10 10  * 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 11  
12 12  # Ubuntu VM
... ... @@ -13,10 +13,10 @@
13 13  
14 14  Für neue VMs ist die erforderliche Software bereits vorinstalliert.
15 15  
16 -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.
17 -1 Das Zertifikat wird dann in `/var/lib/rbg-cert/live/HOST.cert.pem` liegen
18 -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.
19 -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:
20 20  
21 21  ```
22 22  # Zur Kontrolle die konfigurierten Namen abfragen, fehlende in der StrukturDB eintragen!
... ... @@ -40,10 +40,8 @@
40 40  
41 41  Im `VirtualHost` Block in `/etc/apache2/sites-enabled/MYSERVICE.conf`:
42 42  
43 -```
44 -SSLCertificateFile /etc/apache2/tls/fullchain.pem
45 -SSLCertificateKeyFile /etc/apache2/tls/key.pem
46 -```
42 + SSLCertificateFile /etc/apache2/tls/fullchain.pem
43 + SSLCertificateKeyFile /etc/apache2/tls/key.pem
47 47  
48 48  Und der automatische renew-hook (`chmod +x` nicht vergessen!)
49 49  
... ... @@ -135,41 +135,45 @@
135 135  Das Programm `rbg-cert` verwendet auch die API, d.h. man kann es auf andere Maschinen portieren.
136 136  Zur Vorbereitung auf den Einsatz von rbg-cert sind folgende Schritte notwendig:
137 137  
138 -```
139 -echo $UQN > /etc/uqn
140 -apt install strongswan-pki
141 -apt install python3-cryptography
135 + UQN=host:f:YOURHOSTNAME.cit.tum.de
136 + echo $UQN > /etc/uqn
137 + apt install python3-cryptography
138 +
139 + mkdir -pm755 /usr/local/cert.d/ # for post-renew trigger scripts
140 + mkdir -pm700 /var/lib/rbg-cert/live/ # certs will be here
141 + cd /var/lib/rbg-cert/live/
142 +
143 + openssl genpkey -algorithm x25519 -out $UQN.privkey.pem
144 + # Falls RSA benötigt wird: openssl genrsa -out $UQN.privkey.pem 4096
145 +
146 + openssl pkey -in $UQN.privkey.pem -pubout
147 + # für RSA: openssl rsa -in $UQN.privkey.pem -pubout
148 + # Diesen pubkey dann in der StrukturDB für PIRA registrieren
142 142  
143 -mkdir -pm755 /usr/local/cert.d/ # for post-renew trigger scripts
144 -mkdir -pm700 /var/lib/rbg-cert/live/ # certs will be here
145 -cd /var/lib/rbg-cert/live/
150 +`rbg-cert` und systemd timer/service sind von einer aktuellen Ubuntu-VM zu kopieren.
146 146  
147 -pki --gen --type ecdsa --size 256 --outform pem > $UQN.privkey.pem
148 -# Falls RSA benötigt wird: pki --gen --type rsa --size 3072 --outform pem > $UQN.privkey.pem
149 -
150 -pki --pub --in $UQN.privkey.pem --outform pem > $UQN.pubkey.pem
151 -# Diesen pubkey dann in der StrukturDB für PIRA registrieren
152 152  ```
153 +scp VMNAME:/usr/local/bin/rbg-cert /usr/local/bin/rbg-cert
154 +scp VMNAME:/etc/systemd/system/rbg-cert.service /etc/systemd/system/rbg-cert.service
155 +scp VMNAME:/etc/systemd/system/rbg-cert.timer /etc/systemd/system/rbg-cert.timer
156 +systemctl enable rbg-cert.timer
157 +```
153 153  
154 -`rbg-cert` und systemd timer/service sind von einer aktuellen Ubuntu-VM zu kopieren.
155 -
156 156  Falls Eigenentwicklungen zwingend notwendig sind, bitte das Verhalten von rbg-cert beibehalten!
157 157  
158 158  ## Enrollment
159 159  
160 -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 +Der public key wird im Hosteintrag in der StrukturDB gespeichert. Bspw. per struklib auf lsadmin oder per [https://struktur.ito.cit.tum.de/struktur/](https://struktur.ito.cit.tum.de/struktur/).
161 161  
162 162  ## API
163 163  
164 164  Production:
165 165  
166 -```
167 -URL: https://pira.in.tum.de/v0/server/[UQN]
169 + URL: https://pira.in.tum.de/v0/server/[UQN]
170 +
171 + GET → {cert, chain, fullchain, names, should_renew}
172 + POST {csr}
168 168  
169 - GET → {cert, chain, fullchain, names, should_renew}
170 - POST {csr}
171 -```
172 -
173 173  Hier sind keine Tests zulässig.
174 174  
175 175  Public keys können im Moment nicht aus der RA entfernt werden, bei Kompromittierung bitte den public key ersetzen.
... ... @@ -180,12 +180,13 @@
180 180  
181 181  1. Auf dem Zielserver z.B. nach `/etc/ssl/private`
182 182  1. Certificate Signing Request (`csr`) erzeugen
183 -`openssl req -newkey rsa:3072 -nodes -keyout SERVERNAME.key -out SERVERNAME.csr -subj '/C=DE/O=Technische Universitaet Muenchen/CN=SERVERNAME.cit.tum.de'`
184 - - weitere namen in csr packen: `-addext "subjectAltName = DNS:OTHERNAME.cit.tum.de, DNS:ANOTHERNAME.cit.tum.de"`
184 +`openssl req -newkey rsa:3072 -nodes -keyout SERVERNAME.key -out SERVERNAME.csr -subj '/C=DE/O=Technische Universitaet Muenchen/CN=SERVERNAME.cit.tum.de'`
185 +Weitere namen in csr packen:
186 +`-addext "subjectAltName = DNS:OTHERNAME.cit.tum.de, DNS:ANOTHERNAME.cit.tum.de"`
185 185  1. [Bei der CA](https://cert-manager.com/customer/DFN/ssl/dUIh9O1QABKy40PikBgN):
186 186   1. `.csr` hochladen
187 187   1. unter "Subject Alternative Names" alle weiteren ggf. benötigten Namen eintragen
188 188   1. alle anderen Felder leer lassen
189 -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. Bitte den `commonName` (CN) mit Begründung warum rbg-cert und Let's Encrypt nicht möglich sind per E-Mail an [support@ito.cit.tum.de](support@ito.cit.tum.de) schicken.
190 190  1. auf "Certificate approved" E-Mail warten, "Certificate ID" entnehmen
191 191  1. [herunterladen](https://cert-manager.com/customer/DFN/idp/ssl/dUIh9O1QABKy40PikBgN?action=download) mit ID und "Certificate (w/issuer after)"