Änderungen von Dokument NATS - Technisches Setup

Zusammenfassung

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

Details

Seiteneigenschaften

Titel

...	...	@@ -1,1 +1,1 @@
1		-NATS - Technisches Setup
	1	+NATS Setup

Übergeordnete Seite

...	...	@@ -1,1 +1,0 @@
1		-PROJ.Digitale Mitgliederverwaltung.Technische Dokumentation.WebHome

Inhalt

...	...	@@ -44,7 +44,7 @@
44	44
45	45	== Authentifizierung ==
46	46
47		-Die Kommunikation ist TLS verschlüsselt, es kommen die TLS Zertifikate aus [[HashiCorp KeyVault>>doc:xwiki:IN.IT Infrastruktur.Services.Hashicorp Vault.WebHome]] zum Einsatz. Diese werden dann einzelnen Accounts zugewiesen. Der NATS Server validiert das Zertifikat an Hand der Zertifikatskette und mapt dann die Zertifikatsinformationen zu einem User. Üblicherweise wird dabei ein SAN (Subject Alternative Name) in Form einer Mail-Adresse verwendet. Diese gibt es in unserem Fall nicht, sodass das Subject verwendet wird. Wichtig ist, dass das Subject in RFC2253 Form verwendet werden muss.
	47	+Die Kommunikation ist TLS verschlüsselt, es kommen die TLS Zertifikate aus [[HashiCorp KeyVault>>doc:xwiki:IN.IT Infrastruktur.Kubernetes Cluster.Hashicorp Vault.WebHome]] zum Einsatz. Diese werden dann einzelnen Accounts zugewiesen. Der NATS Server validiert das Zertifikat an Hand der Zertifikatskette und mapt dann die Zertifikatsinformationen zu einem User. Üblicherweise wird dabei ein SAN (Subject Alternative Name) in Form einer Mail-Adresse verwendet. Diese gibt es in unserem Fall nicht, sodass das Subject verwendet wird. Wichtig ist, dass das Subject in RFC2253 Form verwendet werden muss.
48	48
49	49	{{code language="shell"}}
50	50	$ openssl x509 -noout -text -nameopt RFC2253 -in backend.mksp-da.de.crt
...	...	@@ -112,9 +112,9 @@
112	112	Zur Administration bietet sich die Verwendung der [[NATS CLI >>url:https://github.com/nats-io/natscli||shape="rect"]]an. Diese muss einmalig eingerichtet werden, dafür sind die entsprechenden Zertifikatsdateien notwendig. Wir legen zwei Kontexte an, einen für den Cluster Admin, einen für den JetStream Admin:
113	113
114	114	{{code language="shell"}}
115		-nats context add mksp-sysadmin --server nats.mksp-da.de:4222 --description "MKSP NATS SYS Admin" --tlscert /path/to/admin.mksp-da.de.crt --tlskey /path/to/admin.mksp-da.de.key --tlsca /path/to/mksp_root_x1_ca.crt
	115	+nats context add mksp-sysadmin --server ds-hetzner.mksp-da.de:4222 --description "MKSP NATS SYS Admin" --tlscert /path/to/admin.mksp-da.de.crt --tlskey /path/to/admin.mksp-da.de.key --tlsca /path/to/mksp_root_x1_ca.crt
116	116
117		-nats context add mksp-jsadmin --server nats.mksp-da.de:4222 --description "MKSP NATS JetStream" --tlscert /path/to/js-admin.mksp-da.de.crt --tlskey /path/to/js-admin.mksp-da.de.key --tlsca /path/to/mksp_root_x1_ca.crt
	117	+nats context add mksp-jsadmin --server ds-hetzner.mksp-da.de:4222 --description "MKSP NATS JetStream" --tlscert /path/to/jsadmin.mksp-da.de.crt --tlskey /path/to/jsadmin.mksp-da.de.key --tlsca /path/to/mksp_root_x1_ca.crt
118	118	{{/code}}
119	119
120	120	Anschließend wählen wir den richtigen Kontext aus, in diesem Fall den JetStream Admin Context:
...	...	@@ -211,7 +211,8 @@
211	211	(% class="nc" %)##StorageSpaceEvent##
212	212	)))
213	213	|(((
214		-mksp.backend.storage.released
	214	+{{{
	215	+ }}}
215	215	)))|(((
216	216	backend_storage_released
217	217	)))|(((
...	...	@@ -218,7 +218,8 @@
218	218	(% class="nc" %)##StorageSpaceEvent##
219	219	)))
220	220	|(((
221		-mksp.backend.storage.expired
	222	+{{{
	223	+ }}}
222	222	)))|(((
223	223	backend_storage_expired
224	224	)))|(((
...	...	@@ -225,7 +225,8 @@
225	225	(% class="nc" %){{code language="none"}}StorageSpaceEvent{{/code}}
226	226	)))
227	227	|(((
228		-mksp.backend.user.converted_to_member
	230	+{{{
	231	+ }}}
229	229	)))|(((
230	230	backend_user_converted_to_member
231	231	)))|(((
...	...	@@ -232,30 +232,13 @@
232	232	(% class="nc" %){{code language="none"}}UserEvent{{/code}}
233	233	)))
234	234	|(((
235		-mksp.backend.user.converted_to_guest
	238	+{{{
	239	+ }}}
236	236	)))|(((
237	237	backend_user_converted_to_guest
238	238	)))|(((
239	239	(% class="nc" %){{code language="none"}}UserEvent{{/code}}
240	240	)))
241		-|(((
242		-mksp.backend.user.created
243		-)))|backend_user_created|UserEvent
244		-|(((
245		-mksp.docuseal.document.signed
246		-)))|docuseal_document_signed|(((
247		-SignatureEvent
248		-)))
249		-|(((
250		-mksp.docuseal.signature.expired
251		-)))| |(((
252		-SignatureEvent
253		-)))
254		-|(((
255		-mksp.docuseal.signature.completed
256		-)))| |(((
257		-SignatureEvent
258		-)))
259	259
260	260	Die Consumer können dann wie folgt angelegt werden:
261	261
...	...	@@ -267,13 +267,13 @@
267	267	nats consumer add backend_events backend_key_assigned --pull --filter="mksp.backend.key.assigned" --defaults
268	268	{{/code}}
269	269
270		-= Troubleshooting =
	256	+= {{id name="NATSSetup-Troubleshooting"/}}Troubleshooting =
271	271
272	272	Man kann über die NATS CLI mit dem Server interagieren.
273	273
274		-== JetStream ==
	260	+== {{id name="NATSSetup-JetStream"/}}JetStream ==
275	275
276		-=== Streams ===
	262	+=== {{id name="NATSSetup-Streams"/}}Streams ===
277	277
278	278	Man kann sich die vorhandenen Streams und die Anzahl der Nachrichten anschauen. Die Anzahl sollte üblicherweise 0 sein, wenn die Zahl höher ist, werden Events nicht richtig abgearbeitet.
279	279
...	...	@@ -299,7 +299,7 @@
299	299	{"timestamp":"2025-09-08T09:06:00.062358","stora
300	300	{{/code}}
301	301
302		-=== Consumer ===
	288	+=== {{id name="NATSSetup-Consumer"/}}Consumer ===
303	303
304	304	Die bestehenden Consumer kann man sich ebenfalls im Jetstream Context anzeigen lassen:
305	305
...	...	@@ -354,7 +354,7 @@
354	354	* **Unprocessed Messages** sind Nachrichten, die noch nicht abgerufen wurden. Dies sollte immer 0 sein
355	355	* **Waiting Pulls**: die Anzahl der verbundenen Clients. Üblicherweise sollte das nur n8n sein, also immer 1.
356	356
357		-== Server ==
	343	+== {{id name="NATSSetup-Server"/}}Server ==
358	358
359	359	Man kann sich ebenfalls die aktiven Verbindungen anzeigen:
360	360