Skip to content
Snippets Groups Projects

Compare revisions

Changes are shown as if the source revision was being merged into the target revision. Learn more about comparing revisions.

Source

Select target project
No results found

Target

Select target project
  • fit-connect/docs
1 result
Show changes
Commits on Source (12)
......@@ -4,6 +4,12 @@ Das Format dieser Datei basiert auf [Keep a Changelog](https://keepachangelog.co
Das hier veröffentlichte Changelog bezieht sich auf die [Testinstanz von FIT-Connect](getting-started/environments.mdx).
## 2023-02-14
### Self Service Portal 1.5.3
- Das Formular zum Anlegen und Verwalten von Zustellpunkten unterstützt jetzt mehrere Verwaltungsleistungen pro Zustellpunkt, die auch mehrere Regionen und Fachdatenschemas enthalten können. ([Story](https://git.fitko.de/fit-connect/planning/-/issues/443))
- Fehlerhafte Texte in dem Formular zum Anlegen und Verwalten von Zustellpunkten wurden korrigiert. ([Story](https://git.fitko.de/fit-connect/planning/-/issues/853))
- Die fehlerhafte Verarbeitung von Callbacks im Formular zum Anlegen und Verwalten von Zustellpunkten wurde korrigiert. ([Story](https://git.fitko.de/fit-connect/planning/-/issues/903))
## 2023-01-16
### Dokumentation
- Die [Code-Beispiele zur Prüfung der in der Routing-API enthaltenen Signaturen](sending/get-destination.mdx) wurden überarbeitet.
......
......@@ -9,13 +9,27 @@ Zustellpunkte können dann im Rahmen von FIT-Connect über den Routingdienst gef
**Testumgebung**: Das [Self-Service-Portal der Testumgebung](https://portal.auth-testing.fit-connect.fitko.dev/) steht allen Interessierten zur Registrierung von API-Clients für die Testinstanz des FIT-Connect Zustelldienstes zur Verfügung.
## Anmeldung am Self-Service-Portal
## Anmeldung am Self-Service-Portal (SSP)
Eine Nutzung des Self-Service-Portals setzt zwingend eine vorangehende Authentifizierung über einen der unterstützten Identity Provider voraus.
In der Testumgebung ist neben der Authentifizierung über die GitLab-Instanz der FITKO auch ein Login mit einem bestehenden GitLab.com- oder GitHub-Account möglich. Falls Ihnen die Nutzung von GitLab.com- oder GitHub nicht möglich ist und Sie stattdessen eine Registrierung über die GitLab-Instanz der FITKO wünschen, wenden Sie sich bitte an `fit-connect <ät> fitko.de`.
Eine Nutzung des Self-Service-Portals (SSP) setzt eine Authentifizierung über einen der unterstützten Identity Provider voraus (siehe folgendes Bild).
### Zugang zum SSP in der Testumgebung
#### Username/Passwort erforderlich
In der Testumgebung ist die Authentifizierung per Username und Passwort über Ihren Account bei GitHub oder GitLab möglich.
Zudem können Sie sich über `GitLab der FITKO` anmelden. Zur Registrierung beim GitLab der FITKO wenden Sie sich bitte an `fit-connect <ät> fitko.de`.
<img width="600" alt="Übersicht der aktuell unterstützten OAuth 2.0 Identiy Provider" src={useBaseUrl('/images/ssp/1-Login-Verfahren.png')} />
### Zugang zum SSP in der Staging- und Produktivumgebung
#### Username/Passwort und Zwei-Faktor-Authentifizierung erforderlich
Für den Zugang zum Self-Service-Portal in der Staging- und Produktivumgebung ist zusätzlich zur Anmeldung per Username und Passwort eine Zwei-Faktor-Authentifizierung erforderlich.
Eine Beschreibung der Zwei-Faktor-Authentifizierung finden Sie [hier](https://docs.gitlab.com/ee/user/profile/account/two_factor_authentication.html).
Nach erfolgreicher Authentifizierung wird die Startseite des Self-Service-Portals angezeigt: Die Clientverwaltung.
## Verwaltung von API-Clients
......
......@@ -80,25 +80,3 @@ These keys can be used to sign and decrypt in your client application.
Die zwei Punkte im Ausgabepfad "**..**\res\privateKey_decryption.jwk.json" bedeuten, dass von dem aktuellen Verzeichnis ausgegangen wird. Beispielsweise "**C:\Users\username\fit-connect-tools**\res\rivateKey_decryption.jwk.json"
:::
## OpenSSL
Dieses Kapitel enthält eine Schritt-für-Schritt-Anleitung, um aus einem Zertifikat der Verwaltungs-PKI einen JSON-Web-Key zu erzeugen:
1. Das von der Verwaltungs-PKI signierte Zertifikat muss nun in einen JWK umgewandelt werden:
```bash
openssl x509 -in certificate.pem -pubkey -noout
```
2. :construction: :warning: *wird noch ergänzt*
```bash
# pubkey --[into]--> JWK
```
Die JSON Web Keys müssen vor der Verwendung in einem Client immer auf Gültigkeit geprüft werden. Das umfasst
insbesondere folgende Punkte:
- Überprüfung gegen eine Certificate Revocation List und/oder einen OCSP-Endpunkt mit signierten Antworten.
- Überprüfung der Zertifikats-Kette bis zum Wurzelzertifikat (BSI) über das Attribut `x5c` im JWK
Weitere Informationen zur Gültigkeitsprüfung finden sich in der technischen Richtlinie BSI [TR-02103](https://www.bsi.bund.de/SharedDocs/Downloads/DE/BSI/Publikationen/TechnischeRichtlinien/TR02103/BSI-TR-02103.pdf?__blob=publicationFile&v=4) und in den [Vorgaben für kryptographische Verfahren in FIT-Connect](../details/crypto.md#certificates).
......@@ -23,38 +23,29 @@ module.exports = {
label: 'Infos für Verantwortliche',
collapsed: true,
items: [
/*
'organisation-tasks/video-verantwortliche',
*/
{
type: 'category',
label: 'Leitfäden zur Anbindung von FIT-Connect',
label: 'Leitfaden zur Anbindung von Onlinediensten',
collapsed: true,
items: [
{
type: 'category',
label: 'Onlinedienste anbinden',
collapsed: true,
items: [
'organisation-tasks/leitfaden-onlinedienst-ueberblick',
'organisation-tasks/sender',
],
},
{
type: 'category',
label: 'Fachverfahren anbinden',
collapsed: true,
items: [
'organisation-tasks/leitfaden-fachverfahren-ueberblick',
'organisation-tasks/subscriber',
'organisation-tasks/certificates',
'organisation-tasks/routing',
],
}
'organisation-tasks/leitfaden-onlinedienst-ueberblick',
'organisation-tasks/sender',
],
},
{
type: 'category',
label: 'Leitfaden zur Anbindung von Fachverfahren',
collapsed: true,
items: [
'organisation-tasks/leitfaden-fachverfahren-ueberblick',
'organisation-tasks/subscriber',
'organisation-tasks/certificates',
'organisation-tasks/routing',
],
}
}
]
},
{
......@@ -63,7 +54,7 @@ module.exports = {
items: [
{
type: 'category',
label: 'Leitfäden zur Anbindung von FIT-Connect',
label: 'Leitfäden zur Anbindung an FIT-Connect',
items: [
'leitfaeden/integration-guide-sender',
'leitfaeden/integration-guide-subscriber',
......