import React from 'react' import FaqItem from "@components/FaqItem" import Link from '@docusaurus/Link' import ApiLink from "@components/ApiLink"; export default function FAQList() { return <section> <div className="max-w-6xl mx-auto px-4 sm:px-6"> <div className="py-12 md:py-20 border-t border-gray-200"> {/* Section header */} <div className="max-w-3xl mx-auto text-center pb-20"> <h2 className="h2">FAQs</h2> </div> <div className="max-w-3xl mx-auto text-center pb-15"> <h3 className="h3">FAQs fachlich</h3> </div> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Allgemeines</h4> </div> <ul className="mx-auto"> <FaqItem title='Es gab Anfang 2022 erste Informationsveranstaltungen zu FIT-Connect. Wird es noch weitere Informationsveranstaltungen geben?'> Es wird stetig weitere Informationsveranstaltungen zu FIT-Connect geben. Häufigkeit und thematischer Schwerpunkt werden sich jeweils an der aktuellen Nachfrage sowie am aktuellen Informationsbedarf orientieren. </FaqItem> </ul> <div className="max-w-3xl mx-auto text-center pb-15"> <h3 className="h3">FAQs technisch</h3> </div> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Einrichtung</h4> </div> <ul className="mx-auto"> <FaqItem title='Beim Abruf des Tokens bekomme ich die Fehlermeldung "Invalid, unknown or malformed scope"'> Bei der Einrichtung eines empfangenden Systems (Subscriber) im Self Service Portal ist es notwendig, den zuvor erstellten Zustellpunkt auch <Link to={'docs/receiving/destination#zugriff-auf-zustellpunkte-einrichten'}>dem API-Client zuzuordnen</Link>. </FaqItem> <FaqItem title='Kann man wie beim publicKey_encryption auch eine neue publicKey_signature_verification über die Schnittstelle hochladen?'> Ja diese können genauso wie der Public-Key für die Verschlüsselung hochgeladen werden. Im Gegensatz zu dem <code>publicKey_encryption</code> muss hier aber kein Schlüssel explizit aktiviert werden, da für die Signaturprüfung die neuen als auch die alten Schlüssel herangezogen werden können / müssen. </FaqItem> <FaqItem title='Besteht die Möglichkeit über das Self-Service-Portal den public key anzupassen ohne die Destination vorher zu löschen?'> Aktuell ist das nur über die API möglich. Im SSP muss leider die Destination neu angelegt werden. </FaqItem> <span className="block border-t border-gray-300" aria-hidden="true"/> </ul> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Versand</h4> </div> <ul className="mx-auto"> <FaqItem title='Kann man nach dem erfolgreichen "Einreichung absenden" noch nachsenden, solange die Daten nicht abgeholt wurden?'> Im Nachgang können nur Anhänge überschrieben werden. Man kann also nichts zusätzlich einreichen, wenn diese nicht angekündigt wurden. Das Versenden bzw. Nachreichen einer Einreichung erzeugt eine neue. </FaqItem> <FaqItem title='Was mache ich als Sender, wenn ich keine von der Destination angebotenen "SubmissionSchemas" unterstütze?'> Die Destination gibt die zu nutzenden Schemas vor. Falls eine Konvertierung in das gewünschte Format nicht automatisiert möglich ist, sollte es im Support des Senders auffallen und dann sollte eine organisatorische Abstimmung mit der für die Destination verantwortlichen Stelle gesucht werden. </FaqItem> <FaqItem title='Woher weiss der Empfänger welcher PublicKey zur Verschlüsselung verwendet werden soll, zumal mehrere Schlüssel in einer Destination hinterlegt werden können?'> Der für die Verschlüsselung aktive / zu nutzender Schlüssel wird in dem Feld encryptionKid angegeben. Anhand der ID können Sie aus dem Array den relevanten Schlüssel raussuchen. </FaqItem> <FaqItem title='Beim Empfänger ist "encryptedData" in dem Antrag immer null, obwohl ich es mitsende - woran liegt das?'> Denken Sie daran, dass Sie das Feld "data" bei der Antragsanlage immer auf "true" setzen müssen, damit diese Daten auch übermittelt werden. </FaqItem> <FaqItem title='Beim Versand bekomme ich die folgende Fehlermeldung: 422 Unprocessable Entity: Error during SET validation'> <pre> {JSON.stringify({"type":"https://schema.fitko.de/fit-connect/problems/security-event-token-validation","title":"Error during SET validation","status":422,"detail":"There was a problem during the processing of the provided SET","issue":"The specified public key in the header cannot be found."}, null, 2)} </pre> Bei der Destination in der Testumgebung ist kein Schlüssel hinterlegt, welcher mit dem bereitgestellten Tool generiert werden sollte. Ersetzen Sie den Schlüssel, wie <Link to={'docs/details/jwk-creation/'}>hier in der Dokumentation</Link> beschrieben. </FaqItem> <FaqItem title='Beim Versand bekomme ich die folgende Fehlermeldung: 409 Conflict: Invalid state transition'> Die Statuswechsel dürfen nur in der festgelegten Reihenfolge durchgeführt werden. Beachten Sie die <Link to={'docs/sending/query-status'}>hier</Link> definierte Statusfolge. </FaqItem> </ul> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Empfang</h4> </div> <ul className="mx-auto"> <FaqItem title='Wie ist "Issuer" beim SET der Empfangsbestätigung auszufüllen?'> Hier ist der Ersteller des SET einzutragen (Empfänger) – Vom gleichen Empfänger sollte es auch immer identisch befüllt werden (z.B. die Haupt-URL) </FaqItem> <FaqItem title='Woher kommt die CaseID für die Empfangsbestätigung?'> Die CaseID wird beim <Link to={'docs/receiving/download-submission'}>Abholen der Submission</Link> mitgeliefert. Diese sollte in diesem Feld auch angegeben werden. </FaqItem> <FaqItem title='Ich möchte einen neuen Verschlüsselungsschlüssel hinterlegen, was ist zu tun?'> Zuerst muss der neue Public-Key der Destination über <ApiLink api={"submission-api"} to={"destinations/{destinationId}/key"} withMethod={"post"}/> zugeordnet werden. Anschließend kann über den Endpunkt <ApiLink api={"submission-api"} to={"destinations/{destinationId}"} withMethod={"patch"}/> der neue Schlüssel als der Aktive definiert werden (encryptionKid). </FaqItem> <FaqItem title='Bei mir schlägt die Signatur oder Signaturvalidierung fehl, was können die Ursachen sein.'> Bitte immer daran denken, dass der Empfänger die Signatur mit seinem <b>privaten</b> Schlüssel durchführt und dann kann der Sender mit dem <b>öffentlichen</b> Schlüssel die Signatur validieren. </FaqItem> <FaqItem title='Bei mir schlägt die Ver- oder Entschlüsselung fehl, was können die Ursachen sein.'> Bitte immer daran denken, dass der Sender mit dem <b>öffentlichen</b> Schlüssel der empfangenden Stelle verschlüsseln muss und der Empfänger kann es dann mit seinem <b>privaten</b> Schlüssel entschlüsseln. </FaqItem> </ul> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Übergreifendes</h4> </div> <ul className="mx-auto"> <FaqItem title='Ich kann keinen Antrag empfangen oder senden, was kann ich tun?'> Überprüfen Sie immer mit welchem Token Sie die Aufrufe starten. Mit dem Token eines Senders können Sie die für den Empfänger spezifischen Endpunkte nicht aufrufen. Genauso umgekehrt können Sie mit dem Token eines Empfängers keine Submissions versenden. </FaqItem> <FaqItem title='Wo sehe ich die Statusänderungen im Event-Log?'> Zu jeder Submission können Sie über den Endpunkt <ApiLink api={'submission-api'} to={'/submissions/{sumissionId}/events'}/> das Log mit allen erfolgten Statusänderungen der Submission abrufen. Jeder der Token kann unter <Link to={'https://jwt.io/'}>jwt.io</Link> dekodiert werden und in der Payload unter dem Feld "events" finden Sie den Status der Submission. Mehr zur Statusfolge finden Sie <Link to={'docs/getting-started/event-log/events'}>hier</Link>. </FaqItem> <FaqItem title='Was sind die Schritte um die Signatur der Events (z.B. nach Jahren) zu prüfen wenn die PublikKey’s bereits getauscht wurden?'> Bei Änderung der Signaturschlüssels seitens des Senders wird empfohlen die alten Public-Keys nicht zu löschen, sondern lediglich die neuen hinzuzufügen, so dass eine Signaturprüfung (gegen alle vorliegenden Schlüssel) möglich bleibt. </FaqItem> </ul> <div className="max-w-3xl mx-auto text-center pb-10"> <h4 className="h4">Metadatensatz/Fachdatensatz</h4> </div> <ul className="mx-auto"> <FaqItem title='Was bedeutet "authenticationInformation" und "identificationReport"?'> Der Bereich "authenticationInformation" ist <Link to={'docs/metadata/authenticationinformation/'}>hier</Link> etwas näher beschreiben. Hier können alle für den Antrag relevanten Identifikationsnachweise angegeben werden (mehrere, da es auch mehrere Nachweise geben kann – zum Beispiel für Ehepartner oder Kind). Die Inhalte ergeben sich aus dem genutzten Dienst (zum Beispiel eID oder Elster). </FaqItem> <FaqItem title='Welche "types" gibt es im Bereich "authenticationInformation"?'> Aktuell gibt es keine anderen Typen. Das hängt mit dem Report im Allgemeinen Zusammen. Der deckt sehr viele Arten ab und kommt von Governikus. </FaqItem> <FaqItem title='Um welche Datei handelt es sich bei "content" im Bereich "authenticationInformation"?'> Der Nachweis wird als Base64Url-kodierte Zeichenkette angegeben. Interne Struktur hängt vom <code>type</code> ab. </FaqItem> <FaqItem title='Gibt es einen mimeType im Bereich "authenticationInformation"?'> Nein </FaqItem> <FaqItem title='Wo muss "schemaURI" angegeben werden?'> Die <code>schemaURI</code> muss nicht unter <code>$schema</code> angegeben werden, sondern unter <code>contentStructure</code> > <code>data</code> > <code>submissionSchema</code> </FaqItem> <FaqItem title='Sind die "purpose" in der contentStructure frei wählbare Bezeichnungen, oder gib es da eine Liste?'> Für den purpose gibt es 3 mgl. Werte: <code>form, attachment, report</code> – siehe auch <Link to={'https://git.fitko.de/fit-connect/metadata-schema/-/blob/main/schema/definitions/contentStructure.json#L58'}>das Schema direkt</Link>. </FaqItem> <FaqItem title='Was bedeutet der Inhalt von $schema? Und bleibt er immer gleich bzw. wie kann man ihn ermitteln?'> Grob zusammengefasst beschreibt das Metadatenschema den Metadatensatz. In dem Ausschnitt des Beispielmetadatensatzes wird in dem Feld <code>$schema</code> auf das zugrunde gelegte Metadatenschema verwiesen. Die aktuelle Version kann über den Link ganz oben unter <Link to={'docs/metadata/overview'}>hier</Link> heruntergeladen werden, bzw. darauf in dem Feld verweisen. In Zukunft wird es auch Weiterentwicklungen des Schemas geben. Weiterführende Information sind <Link to={'docs/metadata/overview'}>hier</Link> zu finden. </FaqItem> <FaqItem title='Wie können meine Kolleg:innen auf das Self Service Portal zugreifen?'> Mit einem GitLab- oder GitHub-Account kann sich jede:r am Self Service Portal der Testumgebung anmelden und dann sowohl mit Sendern als auch Empfängern testen. Zusätzlich ist ein Login über das GitLab der FITKO möglich. Bei Interesse kontaktieren Sie uns bitte über die oben angegebene Mail-Adresse der FITKO. </FaqItem> </ul> </div> </div> </section> }