Installation API PlaceSimpleOrder

På servern

Förkrav

  • En serverdator med uppfyllda systemkrav.

  • Inloggad med en användare med administrativa rättigheter.

  • .NET Framework 3.5 (includes .NET 2.0 and 3.0)

  • Web Server (IIS) with Role services:

    • Application Development > ☑️ASP.NET 3.5

    • Management Tools > IIS 6 Management Compatibility > ☑️ IIS 6 Metabase Compatibility.

  • Uppgifter för att ansluta till SQL Servern.

Förbered servern

Öppna en kommandoprompt med administrativa rättigheter. Kör följande kommando för att installera ASP.NET.

C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i

När installationen är klar visas: Finished installing ASP.NET (2.0.50727).

Att installera ASP.NET behöver inte göras om detta redan gjorts vid något tidigare tillfälle.

Kör installationsprogrammet

Kör GKS.External.PlaceSimpleOrder.exe alternativt via en kommandoprompt:

msiexec /i "GKS.External.PlaceSimpleOrder.msi"
  • Tryck Next vid välkomstdialogen.

  • Välj Application Pool: .NET v2.0 Classic eller GKS . Lämna övriga fält oförändrade. Tryck Next för att acceptera förvald installationskatalog.

  • Ange namnet på databasservern, namnet på databasen, databasanvändarens namn och databasanvändarens lösenord:

Rubrik

Beskrivning

Exempel

Database server

Namn eller IP-adress på dator med SQL Server

gks-db-server

Databas

GKS3-databasens namn.

GKS

Username

Användarnamn för SQL Server. (SQL Authentication)

sa

Password

Lösenord för SQL Server. (SQL Authentication)

hemligt

  • Tryck OK. Programmet kontrollerar att angivna inställningar är korrekt. Om kontakt med databas misslyckas visas ett felmeddelande och inställningarna får fyllas i på nytt.

  • Tryck Close för att avsluta installationen.

Kontrollera installationen

Öppna en webbläsare och ange adress:

Gör API:et tillgängligt för extern part

För att ni ska kunna börja ta emot beställningar via API:et behöver det göras tillgängligt för extern part, t.ex. en webbshop.

Finns det externa systemet installerat internt inom ert lokala nätverk räcker det med att byta ut URL:en ovan med ert servernamn. Detta blir den URL som webbshoppen ska koppla sig till. T.ex:

http://gks-server/GKS.External.PlaceSimpleOrder/PlaceSimpleOrder.asmx

Vanligare är att det externa systemet finns utanför ert lokala nätverk, t.ex. på Internet. I detta fall behöver ni öppna en port i er brandvägg och vidarebefordra denna till det interna API:et. Då blir URL:en som det externa systemet ska koppla sig till istället:

http://vårttryckeri.se:8099/GKS.External.PlaceSimpleOrder/PlaceSimpleOrder.asmx

Exempelvis läggs en NAT-regel in i brandväggen:

EgenskapFrånTill

Interface

wan

lan

IP

(any)

gks-server

Port (TCP)

8099

80

För ökad säkerhet bör följande övervägas:

  • Istället för att tillåta alla inkommande ip-adresser (any) bör detta bytas till en fast ip-adress för det externa systemet.

  • Byt portnummer 8099 till något unikt och högt portnummer.

  • Se på att sätta upp certifikat (SSL) i webbservern.

Last updated