Koble til klienten

Slik konfigurerer du Fiks IO-klienten med verdiene fra oppsettet og begynner å utveksle meldinger.

Når systemet, kontoen og tilgangene er på plass i Fiks Forvaltning, er siste steg å koble fagsystemet ditt til kontoen. Det gjøres med en Fiks IO-klient. KS tilbyr offisielle klienter for .NET og Java som håndterer autentisering, signering, kryptering og kø-kobling for deg.

Verdier du trenger

Klienten konfigureres med verdier fra de tidligere stegene:

Verdi Hva det er Hvor du finner det
integrasjonId Identifiserer integrasjonen ved maskin-til-maskin-pålogging Opprett system, steg 6
integrasjonspassord Passord som hører til integrasjonen Opprett system, steg 6 — eller generer nytt
kontoId Konto-id-en meldinger sendes og mottas med Opprett konto, steg 9
Privat nøkkel Den private delen av nøkkelparet; dekrypterer innkommende meldinger Generert av deg; den offentlige delen ble lastet opp i Opprett konto, steg 7
Virksomhetssertifikat Brukes til Maskinporten-autentisering Fra Før du starter
ASiC-E-signeringsnøkkel Signerer meldingspakkene Virksomhetssertifikatet eller et eget nøkkelpar
Nøkkelformat

Den private nøkkelen må være i PKCS#8-format. Java-klienten har et verktøy for å konvertere fra PKCS#1. Se Feilsøking hvis kryptering eller dekryptering feiler.

Velg klient

Behov .NET Java
Motta og sende meldinger KS.Fiks.IO.Client (NuGet) fiks-io-klient-java (Maven no.ks.fiks)
Kun sende meldinger (ingen kø-kobling) KS.Fiks.IO.Send.Client fiks-io-send-klient

Send-klienten er enklere og trenger ingen AMQP-kobling, men kan ikke motta meldinger. Skal systemet ditt svare på eller lytte etter meldinger, bruk den fulle klienten. Se Klientbiblioteker for en samlet oversikt.

Konfigurer klienten

Klientene bygger konfigurasjonen med et builder-mønster. Eksempelet under viser .NET — Java følger samme prinsipp med FiksIOKonfigurasjon.builder(). Se README-en i klient-repoet for den fullstendige og oppdaterte oppskriften.

var config = FiksIOConfigurationBuilder
    .Init()
    .WithMaskinportenConfiguration(maskinportenSertifikat, issuer)
    .WithFiksIntegrasjonConfiguration(integrasjonId, integrasjonspassord)
    .WithFiksKontoConfiguration(kontoId, privatNokkel)
    .WithAsiceSigningConfiguration(asiceSertifikatSti, asicePrivatNokkelSti)
    .BuildProdConfiguration();

var klient = await FiksIOClient.CreateAsync(config);

Bruk testkonfigurasjon (BuildTestConfiguration / tilsvarende) mot testmiljøet. Se miljøer.

Send og motta meldinger

  • Sende: bygg en meldingsforespørsel med avsenderkonto, mottakerkonto og meldingstype, og send den med eventuell payload (fil, strøm eller tekst).
  • Motta: abonnér på kontoens kø med en callback. Når en melding kommer inn, håndterer du den og bekrefter den med ack().
Les dette før du tar klienten i bruk

Klienten må holde en langtlevende tilkobling og lytte kontinuerlig på køen, og hver mottatt melding må bekreftes med ack() — også ved feil. Gjør du ikke dette, havner meldinger i dead-letter-køen og går tapt. Se Beste praksis for meldingshåndtering.

Fullstendige kodeeksempler ligger i README-en til hvert klient-repo.

Verifiser at koblingen virker

Når klienten kjører og lytter på kontoens kø, forsvinner «konto uten kobling»-advarselen i Fiks Forvaltning. Du kan også sjekke koblingsstatus og antall meldinger på køen — se Overvåking. Får du ikke kontakt, se Feilsøking.

📞 Få hjelp