nShift Ship systemkrav och webbtjänster

Här är en översikt över systemkraven för Ship, Track och Portal, inklusive portar, webbtjänster och IP-adresser som används.

• Ship
  • On-premises-systemkrav
  • Krav för Cloud och Drop Zone
  • Drop Zone-URL:er
  • Datum och tid
  • Etikettstorlek
  • Nätverkskrav och portar
  • Säker dataöverföring
  • SPF-post
  • Mappsäkerhet
  • Skrivarkrav
  • Webbtjänster och URL:er
  • Stöd för kodningar
• Track
  • Krav för Scan App Pro
• Portal
  • Portal DNS-servrar som ska vitlistas
     

Ship

On-premises-systemkrav

Det är möjligt att installera On-premises på en delad server, men vi rekommenderar att använda en dedikerad server. Detta säkerställer stabilare prestanda. Vi rekommenderar inte heller att installera On-premises på en domänkontrollant. Att köra On-premises Clients i ett annat nätverk än On-premises-servern är en lösning som inte stöds.

Krav för Cloud och Drop Zone

Drop Zone-URL:er

• http://ws2.consignorsupport.no
• http://ws.consignorsupport.no
• http://wsm.consignorsupport.no
• https://www.nshiftportal.com

Exempel på förfrågningar som görs av Drop Zone

• http://ws2.consignorsupport.no/ResourceCenter/Gateway.asmx
• http://ws.consignorsupport.no/MessageHub/MessageHub.asmx
• http://wsm.consignorsupport.no/StorageCenter/Gateway.svc
• https://www.nshiftportal.com:443/ticket/token
• https://www.nshiftportal.com:443/ticket/api/tlic/actors
• https://www.nshiftportal.com:443/ticket/api/tlic/upload
• https://www.nshiftportal.com:443/ticket/api/tlic/callshipmentserver
• http://ws.consignorsupport.no/ClientAnalytics/CollectAppData.asmx

Datum och tid

Datum och tid måste vara korrekt inställda i ditt system för att säkerställa bästa möjliga prestanda. Felaktigt datum och felaktig tid på din server kan orsaka försämrad prestanda och saknade eller ogiltiga data i Portal. Det är också viktigt att använda korrekt datum och tid om du använder våra API:er för att säkerställa att säkerhetstoken är giltiga.

Kontrollera aktuellt datum och aktuell tid på www.timeanddate.com. Om ditt system är synkroniserat inom en marginal på 5 minuter från tiden på den här sidan bör det vara korrekt.

Etikettstorlek

Etiketterna är optimerade för termiska etiketter i storleken 100x192 mm (EU+internationellt) eller 4x6 tum (USA). Etiketter i större storlekar fungerar också, men observera att om du använder etiketter i mindre storlekar kommer endast etiketter från utvalda transportörer att skrivas ut korrekt.

Nätverkskrav och portar

Portar som används externt av Ship:

TCP 80/443 (HTTP/HTTPS - Ship använder ett antal webbtjänster, läs mer i det här avsnittet: Ship webbtjänster och URL:er.
TCP 21 (FTP/FTPS - Ship kan konfigureras för att använda FTP/FTPS. Om du är osäker på din konfiguration, vänligen kontakta din lokala Customer Service-avdelning.)
TCP 9999 (SFTP - Ship kan konfigureras för att använda SFTP. Om du är osäker på din konfiguration, vänligen kontakta din lokala Customer Service-avdelning.)
TCP 25 (SMTP - Ship kan konfigureras för att använda SMTP (Mail). Om du är osäker på din konfiguration, vänligen kontakta din lokala Customer Service-avdelning.)

Lokala portar som används av Ship:

52346 (Används av klienten för att ansluta till servern).
52345 (Används av klienter när de hämtar uppdateringar från servern).
52347 (Används av servern för en lokal process "import.exe" som kör en integrationsmodul).
52348 (Används av servern för en lokal process "JobExecutor.exe" som kör flera uppgifter).
Obs: Dessa lokala portar kan konfigureras; kontakta din lokala Customer Service-avdelning om detta behövs.

Observera att Ship är programvara som använder MS SQL Server för sin databas; databaskommunikationen utförs av både server och klient. Se Microsofts webbplats för information om nätverkskrav: https://support.microsoft.com/en-us/kb/287932.

Säker dataöverföring

Web Services
Vi har säker dataöverföring (HTTPS) mellan alla Ships interna webbtjänster.
Undantag är webbtjänster från tredje part som inte stöder säkra anslutningar, dvs. överföring av data till transportörer (EDI).

 

Ship On-premises
Alla webbtjänster som anropas från On-premises kan använda HTTPS om alternativet är aktiverat i On-premises-inställningarna. FTP beror på konfigurationen. Vi stöder FTP, FTPS och SFTP.
SMTP beror på konfigurationen (t.ex. mailback). 

 

Ship Cloud/Shipment Server API 
Kommunikationsprotokollet är HTTPS (port 443). 

 

Uppladdning av data till Portal
Kommunikationsprotokollet är HTTPS (port 80).

Drop Zone
Drop Zone använder alltid portar 80 och 443 eller 8089. Det är ett konfigurationsval att använda antingen port 443 med SSL/TLS-protokoll eller port 8089 utan. Port 8089 kan konfigureras till ett annat nummer.

 

SPF-post

Vissa kunder använder nShifts SMTP-server tillsammans med sin egen e-postserver på sin egen domän. Det är obligatoriskt att lägga till en SPF-post för din domän för att undvika att e-post som skickas via nShifts SMTP-server klassificeras som skräppost.

En SPF-post är en txt-post som läggs till i din domäns DNS och är specifik för varje domän.

Exempel på en SPF-post som inkluderar nShifts SMTP-servrar:
v=spf1 mx include:spf.protection.outlook.com include:_spf.consignor.com ~all

Du MÅSTE inkludera "include:_spf.consignor.com" om du skickar e-post från vår lösning.

Läs mer om SPF:

• https://support.google.com/a/answer/33786?hl=en
• https://docs.microsoft.com/en-us/microsoft-365/security/office-365-security/set-up-spf-in-office-365-to-help-prevent-spoofing

Mappsäkerhet

Folder security - On-premises server:
När du installerar en On-premises-server krävs det att användaren som kör installationspaketet är lokal administratör. Därefter förväntas användaren (eller 'Local System account' som kör vår lokala tjänst "Consignorserver") ha lokala administratörsrättigheter. Om tjänsten Consignorserver inte körs med lokala administratörsrättigheter kommer inte alla funktioner att fungera korrekt.

 

Folder security - On-premises client:
Användaren som är inloggad i Windows måste ha läsbehörighet till den lokala mappen där On-premises-klienten är installerad (som standard: C:\Program Files (x86)\Consignor client\
Varje användare som öppnar On-premises-klienten kommer att försöka skapa en mapp med konfigurationsfiler under C:\Users\<username>\appdata\roaming\Consignor\Consignor - för att kunna skapa och underhålla dessa konfigurationsfiler måste Windows-användarkontot ha korrekt åtkomst här.

OBS: Efter en uppdatering av On-premises-servern kommer processen UpdateClient.exe att köras (finns i installationsmappen för Consignor client). Användaren som öppnar klienten måste ha läs- och skrivåtkomst till installationsmappen för Consignor client.

 

Folder security for file-drop integration:
När file-drop integration används krävs det att tjänsten Consignorserver har läs- och skrivåtkomst till de konfigurerade mapparna.

Skrivarkrav

Skrivarkrav - On-premises client:
Användaren som är inloggad i Windows måste ha behörigheten "Print" till skrivardrivrutinen - On-premises försöker som standard kontrollera skrivarstatus, vilket kräver säkerhetsbehörigheten "Manage this printer". Denna statuskontroll kan stängas av vid behov. 

 

Skrivarkrav - On-premises server:
Vanliga utskriftskrav på servern. Denna metod har samma skrivarkrav som On-premises-klienten.

Krav för automatiserad utskrift på servern:
Den automatiserade utskriften (auto print osv.) utförs av den lokala tjänsten 'Consignorserver', och denna tjänst behöver rätt behörigheter. Läs mer här: Printer setup in nShift On-premises.

Ship webbtjänster och URL:er

Ship använder flera webbtjänster; vi rekommenderar att webbtjänsterna nedan vitlistas i brandväggar osv.

Våra servrar kör främst på dessa webbplatser för utgående webbtjänster på port 80 / 443:
https://ws2.consignorsupport.no
https://ws.consignorsupport.no

Våra webbtjänster stöder TLS 1.2

Adressuppslag, validering av utlämningsställe osv.
https://ws2.consignorsupport.no/AddressLookupWS/Main.asmx
 

API-backendkommunikation
https://internal-api.nshiftportal.com

Autentisering och inloggning
https://account.nshiftportal.com

Automatisk påfyllning av sändningsnummer:
https://ws.consignorsupport.no/BarcodeRefillWS/Barcode.asmx

Programuppdateringar:
https://ws2.consignorsupport.no/consignorDataUpdate/ConsignorDataUpdate.asmx

DG Office 
https://ws.consignorsupport.no/DangerousGoods/DGService.asmx
https://ws2.consignorsupport.no/DangerousGoods/DGService.asmx

EDI-filöverföring:
https://ws2.consignorsupport.no/SendingEdifacts/SendingEdifacts.asmx
https://ws.consignorsupport.no/SendingEdifacts/SendingEdifacts.asmx

Resource Center for AutoUpdates
https://ws2.consignorsupport.no/ResourceCenter/Gateway.asmx
https://ws.consignorsupport.no/ResourceCenter/Gateway.asmx

Routing Codes:
https://ws2.consignorsupport.no/RoutingCodes/RoutingCodes.asmxhttp://ws.consignorsupport.no/RoutingCodes/RoutingCodes.asmx

Storage Center:
https://wsm-aws.prod.edi-soft.no/StorageCenter/Gateway.svc

Uppladdning av sändningar till Portal:

https://api.consignorportal.com/ApiGateway/

Vissa transportörer kan också ha specifika webbtjänster för att fungera korrekt.
Du kan också se alla våra webbtjänster och deras funktioner i konfigurationsfilen som finns på C:\Consignor\Consignor\LiveUpdate\Config\FactorySettings\WebServerConfiguration.xml

Våra webbtjänster kan köras både på klient och server.
Se även hur man ställer in proxyinställningar här.

OBS: Även om du kan komma åt webbtjänsten via din webbläsare men inte via Ship, kan det bero på proxyinställningarna i webbläsaren.

Stöd för kodningar

Vi stöder följande kodningar i import- och importuppladdningsfiler:

• UTF8 without BOM
• ANSI
   

Track

Krav för Scan App

Scan App är tillgänglig för Android och iOS. Scan App körs på iOS 11 eller senare eller Android 5 eller senare. Det rekommenderas att alltid hålla appen uppdaterad till den senaste versionen.

• Ladda ner Scan App Pro för iPhone här
   
• Ladda ner Scan App Pro för Android här

IP-adresser som används av Scan App Pro

Använd dessa IP-adresser om du behöver använda en fast IP-adress för Scan App Pro.

Följande 5 IP-adresser används till och med den 7 maj 2023:

• 108.128.248.209
• 99.81.216.63
• 54.194.215.197
• 3.33.142.248
• 15.197.148.245

Från och med den 7 maj 2023 kommer följande IP-adresser att användas och ersätta de 5 gamla IP-adresserna:

• 13.248.199.199
• 76.223.93.225
• 13.248.195.215
• 76.223.80.201
• 75.2.23.193
• 99.83.208.216
• 75.2.125.199
• 99.83.241.202

Om du får ett meddelande som säger "No internet or network wrongly configured!", kan din telefon inte komma åt internet, eller så kan du ha brandväggsinställningar som blockerar åtkomsten i ditt nätverk.

 

Domäner som ska vitlistas för kameraskanning:

Huvudserver: https://mlts.dynamsoft.com, port: 443
Reservserver: https://slts.dynamsoft.com, port: 443

nShift Portal

Portal DNS-servrar som ska vitlistas

Vissa kunder behöver vitlista DNS/IP-adresser i sin brandvägg eller FTP. Här är en översikt över de IP-adresser som används:

Portal Gateway (ReturnData & ExportData)

portalgateway.consignorportal.com (54.229.144.217 and 52.48.142.186)

API:er (det kommer att finnas flera API:er på denna URL)

https://api.nshiftportal.com/

Prenumerationstjänst

IdentityServer: https://account.nshiftportal.com

SubscriptionServer: https://api.nshiftportal.com

För att verifiera åtkomst, gå till: https://api.nshiftportal.com/track/healthcheck/info
Tryck på F12 för att öppna konsolen. Klicka på fliken Network och se att du får Status 200.

Exempel från Google Chrome:

Exempel från Firefox: