Änderungen von Dokument NATS - Technisches Setup

Zusammenfassung

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

Details

Seiteneigenschaften

Ü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:
...	...	@@ -150,7 +150,7 @@
150	150	Schema
151	151	)))
152	152	|(((
153		-mksp.backend.briefing.offer.cancelled
	153	+{{{mksp.backend.briefing.offer.cancelled}}}
154	154
155	155	(((
156	156
...	...	@@ -161,7 +161,7 @@
161	161	(% class="nc" %)##BriefingOfferEvent##
162	162	)))
163	163	|(((
164		-mksp.backend.briefing.offer.created
	164	+{{{mksp.backend.briefing.offer.created}}}
165	165
166	166	(((
167	167
...	...	@@ -172,7 +172,7 @@
172	172	(% class="nc" %)##BriefingOfferEvent##
173	173	)))
174	174	|(((
175		-mksp.backend.briefing.offer.updated
	175	+{{{mksp.backend.briefing.offer.updated}}}
176	176	)))|(((
177	177	backend_briefing_offer_updated
178	178	)))|(((
...	...	@@ -179,7 +179,7 @@
179	179	(% class="nc" %)##BriefingOfferEvent##
180	180	)))
181	181	|(((
182		-mksp.backend.briefing.created
	182	+{{{mksp.backend.briefing.created}}}
183	183
184	184	(((
185	185
...	...	@@ -190,7 +190,7 @@
190	190	(% class="n" %)##BriefingEvent##
191	191	)))
192	192	|(((
193		-mksp.backend.key.assigned
	193	+{{{mksp.backend.key.assigned}}}
194	194	)))|(((
195	195	backend_key_assigned
196	196	)))|(((
...	...	@@ -197,7 +197,7 @@
197	197	(% class="nc" %)##KeyEvent##
198	198	)))
199	199	|(((
200		-mksp.backend.key.unassigned
	200	+{{{mksp.backend.key.unassigned}}}
201	201	)))|(((
202	202	backend_key_unassigned
203	203	)))|(((
...	...	@@ -204,7 +204,7 @@
204	204	(% class="nc" %)##KeyEvent##
205	205	)))
206	206	|(((
207		-mksp.backend.storage.reserved
	207	+{{{mksp.backend.storage.reserved}}}
208	208	)))|(((
209	209	backend_storage_reserved
210	210	)))|(((
...	...	@@ -239,18 +239,10 @@
239	239	(% class="nc" %){{code language="none"}}UserEvent{{/code}}
240	240	)))
241	241	|(((
242		-mksp.backend.user.created
243		-)))|backend_user_created|UserEvent
244		-|(((
245		-mksp.docuseal.signature.expired
246		-)))|docuseal_signature_expired|(((
	242	+mksp.docuseal.document.signed
	243	+)))|docuseal_document_signed|(((
247	247	SignatureEvent
248	248	)))
249		-|(((
250		-mksp.docuseal.signature.completed
251		-)))|docuseal_signature_completed|(((
252		-SignatureEvent
253		-)))
254	254
255	255	Die Consumer können dann wie folgt angelegt werden:
256	256
...	...	@@ -262,13 +262,13 @@
262	262	nats consumer add backend_events backend_key_assigned --pull --filter="mksp.backend.key.assigned" --defaults
263	263	{{/code}}
264	264
265		-= Troubleshooting =
	257	+= {{id name="NATSSetup-Troubleshooting"/}}Troubleshooting =
266	266
267	267	Man kann über die NATS CLI mit dem Server interagieren.
268	268
269		-== JetStream ==
	261	+== {{id name="NATSSetup-JetStream"/}}JetStream ==
270	270
271		-=== Streams ===
	263	+=== {{id name="NATSSetup-Streams"/}}Streams ===
272	272
273	273	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.
274	274
...	...	@@ -294,7 +294,7 @@
294	294	{"timestamp":"2025-09-08T09:06:00.062358","stora
295	295	{{/code}}
296	296
297		-=== Consumer ===
	289	+=== {{id name="NATSSetup-Consumer"/}}Consumer ===
298	298
299	299	Die bestehenden Consumer kann man sich ebenfalls im Jetstream Context anzeigen lassen:
300	300
...	...	@@ -349,7 +349,7 @@
349	349	* **Unprocessed Messages** sind Nachrichten, die noch nicht abgerufen wurden. Dies sollte immer 0 sein
350	350	* **Waiting Pulls**: die Anzahl der verbundenen Clients. Üblicherweise sollte das nur n8n sein, also immer 1.
351	351
352		-== Server ==
	344	+== {{id name="NATSSetup-Server"/}}Server ==
353	353
354	354	Man kann sich ebenfalls die aktiven Verbindungen anzeigen:
355	355