diff --git a/nuget-readme.md b/nuget-readme.md index 24fb1aab9576d4eff7efe71eb64cb18695d72a76..a911e1e9f55345d040bdb9499177596cdc231051 100644 --- a/nuget-readme.md +++ b/nuget-readme.md @@ -9,6 +9,7 @@ Das FIT-Connect .NET SDK bietet eine einfache Möglichkeit, sowohl einen Antrags ### OSX Auf OSX wird das SDK nur dann unterstützt, wenn OpenSSL auf dem System installiert ist. +Zum Installieren von OpenSSL können Sie Homebrew verwenden: ```sh brew install openssl@1.1 @@ -27,13 +28,13 @@ export DYLD_LIBRARY_PATH=/usr/local/opt/openssl@1.1/lib Um einen Antrag mit dem SDK versenden zu können, werden eine ClientID und ein ClientSecret benötigt. Diese können im FIT-Connect Self-Service-Portal erzeugt werden. +[Hier](https://docs.fitko.de/fit-connect/docs/getting-started/account) ist beschrieben, wie Sie eine ClientID und ein ClientSecret erhalten. [Offizelle Dokumentation von FIT-Connect zum Versenden von Einreichungen (Anträgen)](https://docs.fitko.de/fit-connect/docs/sending/overview) ### Subscriber -Der Subscriber benötigt sowohl eine ClientID und das ClientSecret, aber auch die Schlüsselpaare zur -Verschlüsselung wie auch zum Signieren der Daten. +Der Subscriber benötigt eine ClientID, ein ClientSecret und zwei Schlüsselpaare zur Verschlüsselung und zum Signieren der Daten. Zu Testzwecken können selbstgenerierte Schlüsselpaare mit dem [hierzu bereitgestellten Tool](https://docs.fitko.de/fit-connect/docs/details/jwk-creation) erzeugt werden. In der Produktivumgebung müssen hierzu [Zertifikate der Verwaltungs-PKI zu Einsatz kommen](https://docs.fitko.de/fit-connect/docs/receiving/certificate). @@ -46,7 +47,7 @@ In der Produktivumgebung müssen hierzu [Zertifikate der Verwaltungs-PKI zu Eins ```csharp var submission = Client - .GetSender(FitConnectEnvironment.Development, clientId, clientSecret, logger) + .GetSender(FitConnectEnvironment.Testing, clientId, clientSecret, logger) .WithDestination(destinationId) .WithServiceType("FIT Connect Demo", leikaKey) .WithAttachments(new Attachment("Test.pdf", "Test Attachment")) @@ -54,12 +55,16 @@ var submission = Client .Submit(); ``` +Im Beispiel oben stellt das Argument "FitConnectEnvironment.Testing" die FIT-Connect-Endpunkte zur Verfügung, die aufgerufen werden sollen. +Das Argument 'destinationId" liefert die Adresse des Fachverfahrens, das die Antragsdaten über FIT-Connect erhalten soll. +Das Argument "leikaKey" enthält die ID der beantragten Leistung. "leika' ist die Abkürzung für "Leitungskatalog". + ## Subscriber ### Erstellen des Subscribers ```csharp -var subscriber = Client.GetSubscriber(FitConnectEnvironment.Development, clientId, +var subscriber = Client.GetSubscriber(FitConnectEnvironment.Testing, clientId, clientSecret, privateKeyDecryption, privateKeySigning, @@ -68,6 +73,11 @@ var subscriber = Client.GetSubscriber(FitConnectEnvironment.Development, clientI logger); ``` +Im Beispiel oben stellt das Argument "privateKeyDecryption" den JSON Web Key (JWK) für den privaten Schlüssel zum Entschlüsseln bereit. +Das Argument 'privateKeySigning" liefert den JWK des privaten Schlüssels zum Signieren. +Das Argument 'publicKeyEncryption" liefert den JWK des öffentlichen Schlüssels zum Verschlüsseln. +Das Argument 'publicKeySignatureVerification" liefert den JWK des öffentlichen Schlüssels zum Überprüfen der Signatur. + ### Abrufen der Submissions ```csharp