For at vi skal få kommunikasjonen mellom deres lokalt installerte regnskapsprgram og Account Control til å fungere, har vi behov for å installere vår programvare (Connexus) på en server med lesetilgang til selskapet deres sin Navision-database.
Connexus er en bakgrunnsservice som fungerer som bindeledd mellom Account Controls skyapplikasjon og lokalt installerte ERP-systemer (i dette tilfellet Navision). Tjenesten utfører datauttrekk ved å kjøre spørringer mot ERP-database og sender datasett til Account Controls API.
Databasebruker administreres av kunde, og rettigheter på brukeren kan begrenses til lesetillatelse på kun de tabeller som Connexus skal hente data fra.
Sikkerhetsmekanismer for Connexus inkluderer:
- Data overføres sikret over https, der TLS 1.2 benyttes som kryptografisk protokoll.
- Alle forespørsler fra Connexus autentiseres ved bruk av egen API-nøkkel. API-nøkler sjekkes også opp mot kundens MacID for å forhindre misbruk.
- Innloggingsinformasjon som Connexus bruker for databasetilgang lagres kryptert i konfigurasjonsfil i programmappen på kundens server.
- Account Control kan ikke sende forespørsler direkte til Connexus. Dersom operasjoner skal initieres fra Account Control, benyttes meldingstjenesten Azure Service Bus. Connexus sjekker jevnlig etter nye meldinger, og kun forhåndsdefinerte operasjoner støttes i denne flyten.
- Forespørsler gjort mot endepunkter i APIet som gjelder Connexus kontrolleres av sikkerhetsmekanismer for å forhindre såkalte replay attacks.
Connexus knyttes opp mot databasen som ERP-systemet kjører på via autentisering gjennom en bruker i databasen (enten SQL-bruker, eller Windows-bruker), og man legger inn brukernavn/passord for brukeren ved kjøring av DesktopConnexus.exe etter installasjonen. Dere kan enten opprette en egen bruker for Save Solutions, eller bruke en allerede eksisterende bruker som har de påkrevde tilgangene
Informasjon og installasjonsguide (engelsk): Google Drive
Nedlasting av Connexus: Google Drive
En API-nøkkel kreves for å installere Connexus mot ERP-databasen. Denne kan du få ved å henvende deg til oss på support@savesolutions.no. Den skal limes inn i Connexus sitt øvre venstre hjørne ved installasjon for autentisering mot vår server.
Tilganger
For at vi skal få hentet ut all informasjon vi trenger fra ERP-systemet, trenger databasebrukeren som Connexus installeres med, tilgang til et utvalg databasetabeller i Navision sin databasestruktur. Disse er som følger:
[dbo].[000-SelskapAS$G_L Entry]:
-
[G_L Account No_]
[Document No_]
[Posting Date]
[Document Date]
[Description]
[Amount]
[Entry No_]
[Source Code]
[External Document No_]
[VIN]
[Book No_]
[Regnr]
Tilgang til kundens informasjon lagret i Account Control er begrenset til relevant personell og brukes kun til support- og feilsøkingsformål.
Personer med tilgang:
- Erik Gule Paulsen, supportmedarbeider
- Karl Martin Holst, supportmedarbeider
- Tor Henrik von der Ohe, supportmedarbeider
- Henrik Bonsaksen, utvikler
- Espen Austefjord, utvikler
Data lagres kryptert i Microsoft Azure sitt datasenter i Dublin, Irland. Kundens informasjon er kryptert ved hvile i database, samt under transport mellom applikasjonsinstanser for Account Control.
Installasjon av Connexus
Last ned og kjør SetupConnexus.msi (Tilgjengelig her: Google Drive)
Kjør Connexus Setup App via snarvei på skrivebord
- Lim inn API-nøkkel dere har fått oversendt.
- Klikk på Check API key. Om denne gir feilmelding, ta kontakt med oss på support via epost support@savesolutions.no eller telefon på 55 20 66 00. Account Control On-Premise skal IKKE være skrudd på.
- Nedtrekksmenyen i toppen med navn Stored credentials skal nå bli klikkbar. Trykk på denne og velg New
- Velg ERP-system og fyll inn informasjon om databaseserver, portnummer (som oftest 1433) autentiseringsmetode (Windows-bruker eller SQL-bruker, vi foretrekker SQL-bruker for mer granulær rettighetsstyring), brukernavn og passord for autentisering.
Når de øvrige feltene er fylt inn, kan du trykke på nedtrekksmenyen under Database.
Om du får en feilmelding under dette steget, les denne og forsøk å skru på Trust server certificate og/eller Use encryption avhengig av feilmeldingens innhold. I eksempelet under vil løsningen være å skru på Trust server certificate:
I listen som kommer opp, velger du navnet på databasen slik den forekommer i SQL Management Studio/ditt foretrukne databaseadministrasjonsverktøy. - Trykk på Add credential
- Trykk på nedtrekksmenyen under Stored credentials og velg koblingen du nettopp satt opp
- Trykk på Install and start service
- Connexus starter nå opp som en tjeneste i Windows med konfigurasjonen "Automatisk (forsinket start)". Dette kan ta alt i fra noen sekunder til noen minutter, avhengig av mengden data som ligger i regnskapet i databasen som ble valgt. Når Connexus har lest dataen den skal og har generert nødvendige tabeller, vil Connexus Setup App lukkes automatisk, og statusen på Windows-tjenesten vil være "Running". Dette kan sjekkes ved å åpne "Tjenester" / "Services" i Windows (åpne startmenyen i windows og skriv inn "tjenester" eller "services", avhengig av Windows-språk), og deretter trykke på C på tastaturet og se etter "Connexus integration service" (eller scrolle ned i listen).
Du kan enten friske opp listen via knappen som er anvist med pil i bildet under, eller få sanntidsvisning ved å dobbelklikke på prosessnavnet
Restarting / reinstallering av Connexus
Om automatisk eller manuell import til Account Control via Connexus stopper opp, kan det muligens løses ved å starte tjenesten på nytt. Dette kan gjøres via Connexus Setup App
- Trykk på Stop and uninstall service
- Velg den konfigurerte koblingen via Stored credentials fra toppmenyen til høyre
- Trykk på Install and start service.
Dette kan ta alt i fra noen sekunder til noen minutter, avhengig av mengden data som ligger i regnskapet i databasen som ble valgt. Når Connexus har lest dataen den skal og har generert nødvendige tabeller, vil Connexus Setup App lukkes automatisk, og statusen på Windows-tjenesten vil være "Running". -
Manuell import via Connexus kan nå forsøkes via Account Control på vanlig måte via balanseoversikten på gjeldende selskap eller det manuelle avstemmingsbildet.
Om problemet vedvarer, send oss en henvendelse på support@savesolutions.no hvor Connexus sin loggfil for i dag + dagene problemet først oppstod ligger som vedlegg på eposten. De befinner seg i ConnexusService-mappen (C:\Program Files\SaveSolutions\Connexus\ConnexusService\Logs).