thumb_up
thumb_down
link
Copy link
Copied
insert_emoticon
lmatfy
Copied

Endpoints van Profit Connectoren (SOAP/XML en REST/JSON)

Overzicht van alle endpoints en de vereiste versie van TLS.

Let op:

In het weekend van 7, 8 en 9 augustus 2020 wijzigen de IP-adressen van de connectoren (SOAP en REST). Deze wijziging vindt plaats om de continuïteit van het connectorplatform te verbeteren. De wijziging heeft ook betrekking op het PCC.

Als je gebruik maakt van allowlisting op specifieke IP-adressen is het belangrijk om te controleren of de nieuwe IP-adressen worden toegelaten. Neem hiervoor contact op met je systeembeheerder. Als je geen gebruik maakt van een allowlist allowlisting, of als je onze IP-range hebt geallowlist (185.46.182.0/24), dan heeft dit GEEN impact.

De nieuwe IP-adressen staan in de onderstaande tabellen. Bij productie en test heeft het huidige IP-adres plaats heeft gemaakt voor een reeks. Dit houdt in dat het IP-adres kan wijzigen naar een ander IP-adres in diezelfde reeks.

Inhoud

Endpoints

Overzicht van de URL's (endpoints) en IP-adressen van de Profit Webservices.

Als je op je eigen systeem met een allowlist werkt, geef je de onderstaande IP-adressen vrij.

URL's PRODUCTIE-omgevingen

De omgevingsnaam van een Productie-omgeving begint met altijd met de letter O, bijvoorbeeld (O12345AA). Gebruik alleen de cijfers (12345) in de URL.

 

Endpoints en IP-adressen

SOAP/XML

https://12345.soap.afas.online/profitservices

IP-reeks: 185.46.182.140 t/m 185.46.182.179.

Alle endpoints

REST/JSON

https://12345.rest.afas.online/profitrestservices

IP-adres: 185.46.182.140 t/m 185.46.182.179.

Alle endpoints

URL's TEST-omgevingen

De omgevingsnaam van een Testomgeving begint met de letter T, bijvoorbeeld (T12345AA). Gebruik alleen de cijfers (12345) in de URL.

 

Endpoints en IP-adressen

SOAP/XML

https://12345.soaptest.afas.online/profitservices

IP-adres: 185.46.182.180 t/m 185.46.182.199.

Alle endpoints

REST/JSON

https://12345.resttest.afas.online/profitrestservices

IP-adres: 185.46.182.180 t/m 185.46.182.199.

Alle endpoints

URL's ACCEPT-omgevingen

De omgevingsnaam van een Acceptomgeving begint met de letter A, bijvoorbeeld (A12345AA). Gebruik alleen de cijfers (12345) in de URL.

 

Endpoints en IP-adressen

SOAP/XML

https://12345.soapaccept.afas.online/profitservices

IP-adres: 185.46.182.45

Alle endpoints

REST/JSON

https://12345.restaccept.afas.online/profitrestservices

IP-adres: 185.46.182.45

Alle endpoints

TLS

TLS1.2 is vereist bij het gebruik van de endpoints in dit artikel. Hierop is een aantal beperkte ciphersuites beschikbaar, maar deze bieden wel een zo breed mogelijke ondersteuning voor verschillende clients. Hierbij wordt een ECC-certificaat gebruikt, waardoor de sterke encryptie niet ten koste gaat van de snelheid.

Controleer of externe applicaties ook TLS 1.2 ondersteunen. Als dit niet het geval is, kan dit foutmeldingen opleveren.

Powershell scrips inrichten voor TLS 1.2

Wanneer je PowerShell gebruikt om connectoren (get en update) aan te roepen, is de kans groot dat je een van deze standaard PowerShell Commandlets gebruikt:

TLS 1.2 is de minimale eis op de connector eindpoints. Deze standaard PowerShell commandlets gaan niet standaard over TLS 1.2 (maar pas vanaf .NET 4.6), daarom moet je het script aanpassen. Doe je dit niet, dan krijg je bijvoorbeeld de volgende melding:

Invoke-WebRequest : The underlying connection was closed: An unexpected error occurred on a send.

At line:1 char:1

+ Invoke-WebRequest -Uri "https://12345.rest.afas.online/"

+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+ CategoryInfo : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest], WebException

+ FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand

Je lost dit op door in het script TLS1.2 te forceren. Plak de volgende regel voor de aanroep van het connector-endpoint:

[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12

Deze regel zet je voordat je het connectorendpoint gaat aanroepen. Zie ook deze documentatie.

Voorbeeld van een script zonder de aanpassing:

Voorbeeld van een script met de aanpassing:

Zie ook

Direct naar

  1. Connector - externe software koppelen met Profit (API)
  2. App connector inrichten
  3. Alle URL's van de Profit Webservices, IP-adressen en vereisten TLS
  4. Connector aanroepen via XML (SOAP)
  5. Connector aanroepen via Profit Rest Services (JSON)
  6. Beschrijvingen van UpdateConnectoren
  7. AFAS Partner Netwerk

Process

Connector XML/SOAP

Work area

Connectoren