Hoppa till huvudinnehåll

Hemligheter

För att vi ska kunna komma åt din Unit4 API via API:et behöver vi några känsliga inloggningsuppgifter. Vi lagrar dessa känsliga uppgifter med hjälp av Rossums krypterade hemlighetshantering, och det är därför viktigt att dessa endast placeras i den krypterade hemlighetskonfigurationen, och inte i konfigurationen med klartext.

För mer information, se Rossums dokumentation

info

Spara hemligheter När du sparar hemligheterna visas rutan som tom igen, men uppgifterna sparas.

För att skriva över en hemlighet anger du bara de korrigerade uppgifterna och sparar dem.

Konfigurerbara hemliga parametrar​

Gemensam konfiguration​

Dessa parametrar ska alltid ställas in i hemligheter ELLER inställningar (där det anges).

unit4_api_url (ERP7 / CR)​

tips

Observera att detta nu kan ställas in i tilläggsinställningarna för bättre synlighet.

Observera att det i tilläggsinställningarna har nyckeln erpConnectionSettings/unit4ApiUrl.

Om detta värde är inställt på båda ställena, har det som är inställt i inställningarna företräde. :::string

{ "unit4_api_url": "https://example.unit4cloud.com" }

API-adressen för REST-förfrågningar till ditt Unit4 ERP7 / CR-system.

erpx_host (ERPx)​

tips

Observera att detta nu kan ställas in i tilläggsinställningarna för bättre synlighet.

Observera att det i tilläggsinställningarna har nyckeln erpConnectionSettings/erpxHost.

Om detta värde är inställt på båda platserna, har det som är inställt i inställningarna företräde framför det som är inställt här. :

: :string

{ "unit4_api_url": "https://example.unit4cloud.com" }

API-adressen för REST-förfrågningar till ditt Unit4 ERPx-system.

IDS-autentisering​

Dessa parametrar bör ställas in om du använder IDS för autentisering.

unit4_ids_auth_client​

string

{ "unit4_ids_auth_client": "example-ids-auth-client-id" }

IDS-klient-ID som används för att generera en åtkomsttoken för din Unit 4 API.

unit4_ids_secret​

string

{ "unit4_ids_secret": "example-random-secret" }

IDS-klienthemligheten, som paras ihop med ID:t ovan och används för att generera en åtkomsttoken för din Unit 4 API.

unit4_ids_url​

tips

Observera att detta nu kan ställas in i tilläggsinställningarna för bättre synlighet.

Observera att det i tilläggsinställningarna har nyckeln erpConnectionSettings/erpIdsHost.

Om detta värde är inställt på båda platserna, kommer det som finns i inställningarna och inte här att ha företräde.

string

{ "unit4_ids_url": "example" }

Den URL till vilken dina IDS-inloggningsuppgifter ska skickas för att generera en token.

Grundläggande autentisering​

Dessa inloggningsuppgifter ska anges för ERP-moln eller lokala installationer som inte har flyttats till IDS. Det är vanligtvis ERP 7- eller ERP CR-installationer.

unit4_basic_username​

string

{ "unit4_basic_username": "example" }

Användarnamnet som används för att ansluta till ditt API.

unit4_basic_password​

string

{ "unit4_basic_password": "example" }

Lösenordet som används för att ansluta till ditt API.

SOAP-konfiguration​

Dessa autentiseringsuppgifter ska anges för ERP 7 och ERP CR där dokument laddas upp via SOAP. För ERP-x behövs detta inte eftersom dokument laddas upp via REST.

unit4_soap_url (ERP7 / CR)​

tips

Observera att detta nu kan ställas in i tilläggsinställningarna för bättre synlighet.

Observera att det i tilläggsinställningarna har nyckeln erpConnectionSettings/unit4SoapUrl.

Om detta värde är inställt på båda platserna, har det som finns i inställningarna företräde framför det som finns här.

string

{ "unit4_soap_url": "example" }

Exempel på konfigurationer​

Eftersom JSON-syntax och typdefinitionerna som används ovan kanske inte är bekanta för alla, följer här ett exempel på en fullständig konfiguration. Denna kan redigeras/reduceras till endast de nycklar och alternativ som du behöver. Du kan också se vår dokumentation om JSON.

Exempel på ERPX-konfigurationer​

Konfiguration 1 med IDS i inställningarna​

Ställ in i hemligheter:

{
    "erpx_host": "https://example-api.unit4cloud.com",
    "unit4_ids_auth_client": "xxxxx",
    "unit4_ids_secret": "xxxxxxx",
    "unit4_ids_url": "https://example-ids.unit4cloud.com"
}

Konfiguration 2 med IDS blandat med hemligheter och inställningar​

Inställt i hemligheter:

{
    "unit4_ids_auth_client": "xxxxx",
    "unit4_ids_secret": "xxxxxxx",
}

Inställt i inställningar:

{
    "erpConnectionSettings": {
        "erpxHost": "https://example-api.unit4cloud.com",
        "erpIdsHost": "https://example-ids.unit4cloud.com"
    }
}

Exempel på ERP7-/CR-konfigurationer​

Konfiguration 1 med grundläggande autentisering i hemligheter​

Ställ in i hemligheter:

{
    "unit4_api_url": "https://example.com/BusinessWorld-web-api",
    "unit4_soap_url": "https://example.com/BusinessWorld-webservices/service.svc",
    "unit4_basic_username": "example-username",
    "unit4_basic_password": "xxxxxxxxxx"
}

Konfiguration 2 med grundläggande blandat med hemligheter och inställningar​

Inställt i hemligheter:

{
    "unit4_basic_username": "example-username",
    "unit4_basic_password": "xxxxxxxxxx"
}

Inställningar:

{
    "erpConnectionSettings": {
        "unit4ApiUrl": "https://example.com/BusinessWorld-web-api",
        "unit4SoapUrl": "https://example.com/BusinessWorld-webservices/service.svc"
    }
}

Konfiguration 3 med IDS för REST-API:et och grundläggande autentisering för SOAP​

Om en ERP7-/CR-miljö har IDS tillgängligt, använd det för REST-API:et och behåll grundläggande autentisering för SOAP.

Ställ in i hemligheter:

{
    "unit4_ids_auth_client": "example-client-id",
    "unit4_ids_secret": "xxxxxxxxxx",
    "unit4_basic_username": "example-username",
    "unit4_basic_password": "xxxxxxxxxx"
}

Inställningar:

{
    "erpConnectionSettings": {
        "unit4ApiUrl": "https://example.com/BusinessWorld-web-api",
        "unit4SoapUrl": "https://example.com/BusinessWorld-webservices/service.svc",
        "erpIdsHost": "https://example-ids.unit4cloud.com"
    }
}

Två saker att notera om den här konfigurationen:

  • unit4ApiUrl fungerar även som REST-värd för IDS, så erpxHost krävs inte på ERP7 / CR. Om erpxHost (eller hemligheten erpx_host) är angiven har den företräde.
  • Användarnamnet och lösenordet för grundläggande autentisering krävs fortfarande. Unit4:s SOAP-tjänster stöder inte OAuth, så SOAP-anrop skickar autentiseringsuppgifterna i själva anropet oavsett om IDS är konfigurerat. Endast REST-anropen använder IDS.