From 59e8bb91dd7bbbb335065ca520d6e13298953ec3 Mon Sep 17 00:00:00 2001
From: haidner1 <haidner@live.de>
Date: Tue, 23 Aug 2022 12:18:21 +0200
Subject: [PATCH] Broken links fixed
---
docs/changelog.md | 2 +-
docs/details/destination-management.mdx | 2 +-
docs/getting-started/submission/structure.mdx | 2 +-
docs/glossary.md | 6 +++---
docs/receiving/destination.mdx | 2 +-
docs/sending/encrypt.mdx | 2 +-
docs/sending/overview.mdx | 4 ++--
docs/sending/start-submission.mdx | 2 +-
src/pages/docs/responsibilities/routing.js | 2 +-
9 files changed, 12 insertions(+), 12 deletions(-)
diff --git a/docs/changelog.md b/docs/changelog.md
index 09d61bd9e..ad646d67c 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -229,7 +229,7 @@ Das hier veröffentlichte Changelog bezieht sich auf die [Testinstanz von FIT-Co
## 2022-02-07
### Dokumentation
-- Hinweise zur [Signaturprüfung der vom DVDV gelieferten Zustellpunkt-Parameter](./responsibilities/get-destination.mdx#checkDestinationParametersSignature) ergänzt
+- Hinweise zur [Signaturprüfung der vom DVDV gelieferten Zustellpunkt-Parameter](./sending/get-destination.mdx#checkDestinationParametersSignature) ergänzt
## 2022-02-03
### Zustelldienst 1.2.0
diff --git a/docs/details/destination-management.mdx b/docs/details/destination-management.mdx
index e5a6002e7..034e92b84 100644
--- a/docs/details/destination-management.mdx
+++ b/docs/details/destination-management.mdx
@@ -20,7 +20,7 @@ Für die Aktualisierung der Schlüssel des Zustellpunktes gibt es folgenden Endp
* <ApiLink api="submission-api" to="/v1/destinations/{destinationId}/keys" withMethod="post"/>
-Die Details sind der API-Spec zu entnehmen. Eine Beschreibung der Parameter des Zustellpunkt-Objektes findet sich im Artikel [Aufbau der Zustellpunkt-Informationen](../responsibilities/get-destination.mdx#destination-object).
+Die Details sind der API-Spec zu entnehmen. Eine Beschreibung der Parameter des Zustellpunkt-Objektes findet sich im Artikel [Aufbau der Zustellpunkt-Informationen](../sending//get-destination.mdx#destination-object).
### Beispiele
diff --git a/docs/getting-started/submission/structure.mdx b/docs/getting-started/submission/structure.mdx
index e43a31445..871beda09 100644
--- a/docs/getting-started/submission/structure.mdx
+++ b/docs/getting-started/submission/structure.mdx
@@ -65,7 +65,7 @@ Die Fachschemareferenz ist im Zustellpunkt daher immer einer dazugehörigen Leis
```
-Wenn ein sendendes System die Angaben eines Zustellpunkts ermittelt (über den Endpunkt <ApiLink api="submission-api" to="/v1/destinations/{destinationId}" /> der Submission API oder [über die Routing API](../../responsibilities/get-destination.mdx)), so muss der Fachdatensatz diesem Schema entsprechen.
+Wenn ein sendendes System die Angaben eines Zustellpunkts ermittelt (über den Endpunkt <ApiLink api="submission-api" to="/v1/destinations/{destinationId}" /> der Submission API oder [über die Routing API](../../sending/get-destination.mdx)), so muss der Fachdatensatz diesem Schema entsprechen.
Wenn mehrere Schemata (bspw. innerhalb des `submissionSchemas` Array) im Zustellpunkt referenziert werden, so muss der Fachdatensatz einem dieser referenzierten Schemata entsprechen.
## Warum muss das sendende System über den Metadatensatz eine Fachschemareferenz mitliefern?
diff --git a/docs/glossary.md b/docs/glossary.md
index 821d893db..88141e0b2 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -5,7 +5,7 @@ hide_table_of_contents: true
| Begriff | Beschreibung |
|---------|--------------|
-| FIT-Connect Adressierungsinformationen | Für die Zuständigkeitsfindung im Portalverbund ist eine Hinterlegung von signierten Adressierungsinformationen in einem Landes-Redaktionssystem notwendig (siehe Artikel [Konfiguration des Antragsroutings](responsibilities/routing.mdx)). Die FIT-Connect-Adressierungsinformationen werden im Format XZuFi von den Landes-Redaktionssystemen an das Onlinegateway des Portalverbundes (PVOG) übermittelt und vom FIT-Connect Routingdienst in Kombination mit den im Deutschen Verwaltungsdiensteverzeichnis (DVDV) zur Zuständigkeitsfindung / technischen Adressierung von *Zustellpunkten* genutzt. |
+| FIT-Connect Adressierungsinformationen | Für die Zuständigkeitsfindung im Portalverbund ist eine Hinterlegung von signierten Adressierungsinformationen in einem Landes-Redaktionssystem notwendig (siehe Artikel [Konfiguration des Antragsroutings](organisation-tasks/publish_destination#signierte-adressierungsinformationen)). Die FIT-Connect-Adressierungsinformationen werden im Format XZuFi von den Landes-Redaktionssystemen an das Onlinegateway des Portalverbundes (PVOG) übermittelt und vom FIT-Connect Routingdienst in Kombination mit den im Deutschen Verwaltungsdiensteverzeichnis (DVDV) zur Zuständigkeitsfindung / technischen Adressierung von *Zustellpunkten* genutzt. |
| Amtlicher Gemeindeschlüssel (AGS) | Schlüssel zur Identifizierung von verwaltungspolitischen Gebieten. Siehe [AGS](./details/ags.mdx) |
| Amtlicher Regionalschlüssel (ARS) | Schlüssel zur Identifizierung von verwaltungspolitischen Gebieten. Nachfolger des AGS. Siehe [ARS](./details/ars.mdx) |
| Angekündige Anlage | Angabe gegenüber dem Zustelldienst, welche Anlagen übermittelt werden. Teilmenge der Angaben in der `contentStructure` im verschlüsselten Metadatensatz. |
@@ -16,7 +16,7 @@ hide_table_of_contents: true
| API-Gateway | Das API-Gateway ist eine technische Komponente, die OAuth-Tokens prüft und nicht oder falsch authentifizierte Anfragen ablehnt. Ein Zugriff auf die Schnittstelle des Zustelldienstes erfolgt immer über das API-Gateway. |
| Autorisierungsdienst | Der Autorisierungsdienst / OAuth-Dienst stellt via Client-Credentials-Flow OAuth-Tokens an API-Clients aus, mit denen diese sich anschließend gegenüber den FIT-Connect-Schnittstellen (d.h. gegenüber dem API-Gateway) authentifizieren können. |
| Destination | siehe *Zustellpunkt (Destination)* |
-| Destination-ID (`destinationId`) | Die Destination-ID ist eine vom *Zustelldienst* vergeben ID für einen *Zustellpunkt*. Sie wird von Betreiber:innen empfangender Systeme im Self-Service-Portal angelegt und dienst der eindeutigen Adressierung des empfangenden Systems der zuständigen Fachbehörde im jeweiligen Antragskontext auf Basis eines *Leistungsschlüssels* und eines geographischen Merkmals (z.B. ARS oder PLZ). Sendende Systeme (z.B. Online-Antragsdienste) können die Destination-ID über die Routing API oder über bilaterale Absprachen mit den Betreiber:innen empfangender Systeme ermitteln (siehe Artikel [Zustellpunkt ermitteln](responsibilities/get-destination.mdx)). |
+| Destination-ID (`destinationId`) | Die Destination-ID ist eine vom *Zustelldienst* vergeben ID für einen *Zustellpunkt*. Sie wird von Betreiber:innen empfangender Systeme im Self-Service-Portal angelegt und dienst der eindeutigen Adressierung des empfangenden Systems der zuständigen Fachbehörde im jeweiligen Antragskontext auf Basis eines *Leistungsschlüssels* und eines geographischen Merkmals (z.B. ARS oder PLZ). Sendende Systeme (z.B. Online-Antragsdienste) können die Destination-ID über die Routing API oder über bilaterale Absprachen mit den Betreiber:innen empfangender Systeme ermitteln (siehe Artikel [Zustellpunkt ermitteln](sending/get-destination.mdx)). |
| Einreichung (submission) | Eine Einreichung bei einer zuständigen Stelle kann ein Antrag (bspw. ein Antrag nach dem Onlinezugangsgesetz), ein Bericht (bspw. Statistikmeldung eines Unternehmens) oder eine sonstige Einreichung für die Initiierung eines Bearbeitungsvorgangs in einem Verwaltungsverfahren sein. Eine Einreichung besteht mindestens aus einem Metadatensatz und optional einem Fachdatensatz und / oder einem oder mehreren Anlagen. Eine Einreichung besitzt immer eine systemübergreifend eindeutige ID (`submissionId`). Diese ID wird für jeden Einreichungsvorgang durch den Zustelldienst vergeben. |
| Einreichungsvorgang (case) | Bei Erstellung einer neuen Einreichung wird durch den Zustelldienst automatisch ein neuer Einreichungsvorgang angelegt. Der Einreichungsvorgang kann neben der initialen Einreichungen auch mehrere Antworten (replies) umfassen. Innerhalb eines Einreichungsvorgangs können weitere Fachdatensätze und Anlagen zwischen beiden Parteien in Form von Antworten (replies) ausgetauscht werden. Der Einreichungsvorgang wird über eine eindeutige *Vorgangsreferenz* identifiziert. |
| Empfangendes System (subscriber) | Das technische System, das Einreichungen auf Verwaltungsseite entgegennimmt. (z.B. Fachanwendung / virtuelle Poststelle) |
@@ -42,5 +42,5 @@ hide_table_of_contents: true
| Zuständige Fachbehörde | Die für die Bearbeitung der Einreichung zuständige Stelle. Die zuständige Fachbehörde betreibt zum Empfang von Einreichungen ein empfangendes System. |
| Zustellberechtigungs-Scope | Beschreibt die Scopes aus den OAuth-Tokens (JWT), die im Zustelldienst dazu dienen, um zu überprüfen, ob ein Onlinedienst Einreichungen bei einer Destination vornehmen darf. |
| Zustelldienst | Zentrale Komponente der FIT-Connect-Infrastruktur. Der Zustelldienst implementiert die Submission API und ermöglicht die Übermittlung und den Abruf von Einreichungen von sendenden Systemen an empfangende Systeme. |
-| Zustellpunkt (Destination) | Technisch eindeutig adressierbarer Endpunkt zur Einreichung von Anträgen oder Berichten an die für die Verwaltungsleistung zuständige Fachbehörde über die FIT-Connect Übermittlungsinfrastruktur. Ein Zustellpunkt beschreibt die Konfiguration eines konkreten empfangenden Systems (Fachverfahren oder virtuelle Poststelle). Für ein empfangendes System können (z.B. für unterschiedliche Fachlichkeiten) multiple Zustellpunkte angelegt werden. In der Konfiguration eines Zustellpunkts sind interne und öffentliche Teile hinterlegt. Interne Angaben sind solche, die zu Administrationszwecken dienen. Öffentliche Angaben legen z.B. fest, in welcher Form der Empfänger Einreichungen akzeptiert. Zustellpunkte werden über die sogenannte Destination-ID eindeutig identifiziert. Weitere Informationen finden sich in den Artikeln [Zustellpunkt anlegen](receiving/destination.mdx) und [Zustellpunkt ermitteln](responsibilities/get-destination.mdx). |
+| Zustellpunkt (Destination) | Technisch eindeutig adressierbarer Endpunkt zur Einreichung von Anträgen oder Berichten an die für die Verwaltungsleistung zuständige Fachbehörde über die FIT-Connect Übermittlungsinfrastruktur. Ein Zustellpunkt beschreibt die Konfiguration eines konkreten empfangenden Systems (Fachverfahren oder virtuelle Poststelle). Für ein empfangendes System können (z.B. für unterschiedliche Fachlichkeiten) multiple Zustellpunkte angelegt werden. In der Konfiguration eines Zustellpunkts sind interne und öffentliche Teile hinterlegt. Interne Angaben sind solche, die zu Administrationszwecken dienen. Öffentliche Angaben legen z.B. fest, in welcher Form der Empfänger Einreichungen akzeptiert. Zustellpunkte werden über die sogenannte Destination-ID eindeutig identifiziert. Weitere Informationen finden sich in den Artikeln [Zustellpunkt anlegen](receiving/destination.mdx) und [Zustellpunkt ermitteln](sending/get-destination.mdx). |
| Zuständigkeitsverzeichnis | Dienst, der eine Abfrage der *Adressierungsinformationen* anhand eines Leistungsschlüssels und eines geographischen Merkmals (z.B. ARS oder PLZ) ermöglicht; z.B. Portalverbund Online-Gateway oder Behördenfinder Deutschland |
diff --git a/docs/receiving/destination.mdx b/docs/receiving/destination.mdx
index 5b73d776c..1217d94c2 100644
--- a/docs/receiving/destination.mdx
+++ b/docs/receiving/destination.mdx
@@ -98,7 +98,7 @@ Anschließend kann der Zustellpunkt entweder über das Self-Service-Portal oder
:::
:::caution Hinweis
-Um eine [Auffindbarkeit des Zustellpunktes über die Routing API](../responsibilities/get-destination.mdx) zu ermöglichen, müssen die konfigurierten Zuständigkeitsinformationen zunächst in einem an den Portalverbund angeschlossenen Landes-Redaktionssystem des FIM-Bausteins Leistungen hinterlegt werden. Weitere Informationen hierzu finden sich im Artikel [Konfiguration des Antragsroutings](../responsibilities/routing.mdx).
+Um eine [Auffindbarkeit des Zustellpunktes über die Routing API](../sending/get-destination.mdx) zu ermöglichen, müssen die konfigurierten Zuständigkeitsinformationen zunächst in einem an den Portalverbund angeschlossenen Landes-Redaktionssystem des FIM-Bausteins Leistungen hinterlegt werden. Weitere Informationen hierzu finden sich im Artikel [Konfiguration des Antragsroutings](../organisation-tasks/publish_destination#signierte-adressierungsinformationen).
:::
## Zugriff auf Zustellpunkte einrichten
diff --git a/docs/sending/encrypt.mdx b/docs/sending/encrypt.mdx
index 266e48786..b6270ad1a 100644
--- a/docs/sending/encrypt.mdx
+++ b/docs/sending/encrypt.mdx
@@ -16,7 +16,7 @@ Eine Übertragung über FIT-Connect besteht aus
Alle drei Datensatzarten müssen mit [JSON Web Encryption (JWE)](https://tools.ietf.org/html/rfc7516) verschlüsselt und mit [JWE-Compact Serialisierung](https://tools.ietf.org/html/rfc7516#section-7.1) serialisiert werden.
Dokumente müssen als Binärdateien und nicht als Zeichenketten kodiert verschlüsselt werden.
-Der [vorher abgerufene Zustellpunkt](../responsibilities/get-destination.mdx#informationen-des-zustellpunktes-erhalten) beinhaltet die Schlüssel-ID des öffentlichen Verschlüsselungsschlüssels unter dem Feld `encryptionKid`.
+Der [vorher abgerufene Zustellpunkt](../sending/get-destination.mdx#informationen-des-zustellpunktes-erhalten) beinhaltet die Schlüssel-ID des öffentlichen Verschlüsselungsschlüssels unter dem Feld `encryptionKid`.
Damit können wir den öffentlichen Schlüssel des Zustellpunktes im JSON Web Key (JWK)-Format abrufen um Daten zu verschlüsseln.
```shell title="Beispiel: Abruf des JWK eines Zustellpunktes"
diff --git a/docs/sending/overview.mdx b/docs/sending/overview.mdx
index 1f7a3c799..ef9c90162 100644
--- a/docs/sending/overview.mdx
+++ b/docs/sending/overview.mdx
@@ -8,10 +8,10 @@ import Mermaid from '@site/src/components/Mermaid'
Bei einer Einreichung z.B. eines Antrags reicht ein Onlinedienst im Namen und Auftrag eines Endnutzers Fachdaten und/oder Anlagen bei einem Zustellpunkt ein.
Hierfür benötigt der Onlinedienst die öffentlich verfügbaren Informationen eines Zustellpunktes, wie beispielsweise die Zustellpunkt-Id (`destinationId`) oder den JWK des Zustellpunktes.
-Wie der Zustellpunkt der zuständigen empfangenden Stelle technisch ermittelt wird ist unter [Zustellpunkt ermitteln](../responsibilities/get-destination.mdx) genauer beschrieben.
+Wie der Zustellpunkt der zuständigen empfangenden Stelle technisch ermittelt wird ist unter [Zustellpunkt ermitteln](../sending/get-destination.mdx) genauer beschrieben.
FIT-Connect möchte einen sehr sicheren Übermittlungsweg bereitstellen, weswegen alle Daten immer Ende-zu-Ende-Verschlüsselt gemäß dem in [Verschlüsselte Übertragung von Antragsdaten](../getting-started/encryption.mdx) beschriebenen Vorgehen übertragen werden müssen.
-Das dafür benötigte Schlüsselmaterial wird als Teil der technischen Informationen eines Zustellpunkts über die Submission API und Routing API bereitgestellt und unter [Zustellpunkt ermitteln](../responsibilities/get-destination.mdx) als Teil der Zustellpunktermittlung näher beschrieben.
+Das dafür benötigte Schlüsselmaterial wird als Teil der technischen Informationen eines Zustellpunkts über die Submission API und Routing API bereitgestellt und unter [Zustellpunkt ermitteln](../sending/get-destination.mdx) als Teil der Zustellpunktermittlung näher beschrieben.
Während der Einreichung erhält man von der API eine `caseId`, mithilfe welcher man nach der Abgabe den Event Log der Einreichung abrufen kann.
Dieser Event Log enthält eine Liste von Ereignissen, ähnlich wie im Interface einer Paketverfolgung, mit denen der aktuelle Zustellungsstatus der Einreichung sowie aller zukünftig zu diesem Case hinzugehörigen Einreichungen transparent wird.
diff --git a/docs/sending/start-submission.mdx b/docs/sending/start-submission.mdx
index 6fbe45ffa..4766ee6d5 100644
--- a/docs/sending/start-submission.mdx
+++ b/docs/sending/start-submission.mdx
@@ -19,7 +19,7 @@ Die UUIDs der Anlagen müssen eindeutig sein und werden vom sendenden System fes
Der Endpunkt erwartet folgende Parameter:
-- Eine Destination-ID. Dies ist die eindeutige UUID des Zustellpunktes, an den die Einreichung vermittelt werden soll (`destinationId`). Im Artikel [Zustellpunkt Ermitteln](../responsibilities/get-destination.mdx) wird beschrieben wie diese ermittelt werden kann.
+- Eine Destination-ID. Dies ist die eindeutige UUID des Zustellpunktes, an den die Einreichung vermittelt werden soll (`destinationId`). Im Artikel [Zustellpunkt Ermitteln](../sending/get-destination.mdx) wird beschrieben wie diese ermittelt werden kann.
- Die Liste der angekündigten Anlagen (`announcedAttachments`). Dies ist eine Liste der Attachment-IDs aller Anlagen, die mit der Einreichung hochgeladen werden sollen. Die Liste enthält [eine UUIDv4](https://de.wikipedia.org/wiki/Universally_Unique_Identifier#(Pseudo)zuf%C3%A4llig_generierte_UUIDs_(Version_4)) für jedes Attachment. Die UUIDs müssen vom sendenden System selbst generiert werden. Für alle `announcedAttachments` muss anschließend das jeweilige Attachment hochgeladen werden (siehe [Anlagen hochladen](./attachments.mdx), bevor sich die Einreichung im Schritt [Einreichung versenden](submit.mdx) abschließen lässt.
- Der Typ der Verwaltungsleistung (`serviceType`). Dies ist eine Beschreibung der Art der Verwaltungsleistung. Die angegebene Verwaltungsleistung muss der Verwaltungsleistung der Einreichung und einem der angebotenen Verwaltungsleistung des Zustellpunkts entsprechen. Für die jeweilige Verwaltungsleistung muss immer sowohl ein Name (`name`), als auch ein eindeutiger Identifier (`identifier`) angegeben werden. Der Identifier besteht aus einem einem Leistungsschlüssel und dem Präfix `urn:de:fim:leika:leistung:`. Ist für die gegebene Verwaltungsleistung kein Leistungsschlüssel vorhanden, kann die Verwaltungsleistung übergangsweise über die Angabe einer anderen eindeutigen Schema-URN beschrieben werden. Bestehende Leistungssschlüssel können [über das FIM-Portal](https://fimportal.de/) oder [über die LeiKa-Suche (inoffiziell)](https://opengovtech.de/leika/) ermittelt werden.
- Optional kann hier auch ein Callback hinterlegt werden, um Benachrichtigungen über neue Events der Einreichung zu erfahren. Näheres dazu wird im Artikel [Verwendung von Callbacks](../details/callbacks.mdx) beschrieben.
diff --git a/src/pages/docs/responsibilities/routing.js b/src/pages/docs/responsibilities/routing.js
index c6153cacb..e2ca8664a 100644
--- a/src/pages/docs/responsibilities/routing.js
+++ b/src/pages/docs/responsibilities/routing.js
@@ -4,7 +4,7 @@ import {Redirect} from '@docusaurus/router';
export default function routing() {
return (
<p>
- <Redirect to="../../../docs/organisation-tasks/publish_destination#4-%C3%A4nderungen-einpflegen" />
+ <Redirect to="../../../docs/organisation-tasks/publish_destination#signierte-adressierungsinformationen" />
</p>
);
--
GitLab