Gå til hovedinnhold

Hemmeligheter

For å gi oss tilgang til Unit4 API via API-et, trenger vi noen sensitive påloggingsopplysninger. Vi lagrer disse sensitive opplysningene ved hjelp av Rossums krypterte hemmelighetsadministrasjon, og det er derfor viktig at disse kun plasseres i den krypterte hemmelighetskonfigurasjonen, og ikke i konfigurasjonen med ren tekst.

For mer informasjon, se Rossums dokumentasjon

info

Lagre hemmeligheter Når du lagrer hemmelighetene, vil boksen vises som tom igjen, men dataene vil bli lagret.

For å overskrive en hemmelighet, skriver du bare inn de korrigerte dataene og lagrer dem.

Konfigurerbare hemmelige parametere​

Vanlig konfigurasjon​

Disse parametrene bør alltid angis i hemmeligheter ELLER innstillinger (der det er angitt).

unit4_api_url (ERP7 / CR)​

tips

Merk at dette nå kan angis i utvidelsesinnstillingene for bedre synlighet.

Merk at i utvidelsesinnstillingene har den nøkkelen erpConnectionSettings/unit4ApiUrl.

Hvis denne verdien er angitt begge steder, vil den i innstillingene ha forrang. :::string

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

API-adressen for REST-forespørsler til Unit4 ERP7 / CR-systemet.

erpx_host (ERPx)​

tips

Merk at dette nå kan angis i utvidelsesinnstillingene for bedre synlighet.

Merk at i utvidelsesinnstillingene har den nøkkelen erpConnectionSettings/erpxHost.

Hvis denne verdien er angitt begge steder, vil den i innstillingene og ikke her ha forrang. :

: :**

string**

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

API-adressen for REST-forespørsler til Unit4 ERPx-systemet.

IDS-autentisering​

Disse parametrene bør angis hvis du bruker IDS for autentisering.

unit4_ids_auth_client​

string

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

IDS-klient-ID-en som brukes til å generere et tilgangstoken for Unit 4 API-en din.

unit4_ids_secret​

streng

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

IDS-klienthemmeligheten, som pares med ID-en ovenfor og brukes til å generere et tilgangstoken for Unit 4 API-en din.

unit4_ids_url​

tips

Merk at dette nå kan angis i utvidelsesinnstillingene for bedre synlighet.

Merk at i utvidelsesinnstillingene har den nøkkelen erpConnectionSettings/erpIdsHost.

Hvis denne verdien er angitt begge steder, vil den i innstillingene og ikke her ha forrang.

string

{ "unit4_ids_url": "example" }

URL-adressen som IDS-påloggingsinformasjonen din skal sendes til for å generere et token.

Grunnleggende autentisering​

Denne påloggingsinformasjonen skal oppgis for ERP-sky- eller lokale installasjoner som ikke er flyttet til IDS. Dette er vanligvis ERP 7- eller ERP CR-installasjoner.

unit4_basic_username​

string

{ "unit4_basic_username": "example" }

Brukernavnet som brukes til å koble til API-et ditt.

unit4_basic_password​

string

{ "unit4_basic_password": "example" }

Passordet som brukes til å koble til API-et ditt.

SOAP-konfigurasjon​

Disse påloggingsopplysningene bør oppgis for ERP 7 og ERP CR der dokumenter lastes opp via SOAP. For ERP-x er dette ikke nødvendig, da dokumenter lastes opp via REST.

unit4_soap_url (ERP7 / CR)​

tips

Merk at dette nå kan angis i utvidelsesinnstillingene for bedre synlighet.

Merk at i utvidelsesinnstillingene har den nøkkelen erpConnectionSettings/unit4SoapUrl.

Hvis denne verdien er angitt begge steder, vil den i innstillingene og ikke her ha forrang. :

: :string

{ "unit4_soap_url": "example" }

Eksempelkonfigurasjoner​

Siden JSON-syntaks og typedefinisjonene som brukes ovenfor kanskje ikke er kjent for alle, følger her et eksempel på en fullstendig konfigurasjon. Denne kan redigeres/reduseres til bare de nøklene og alternativene du trenger. Du kan også se vår dokumentasjon om JSON.

Eksempel på ERPX-konfigurasjoner​

Konfigurasjon 1 med IDS i innstillingene​

Angitt i hemmeligheter:

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

Konfigurasjon 2 med IDS blandet med hemmeligheter og innstillinger​

Angitt i hemmeligheter:

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

Angitt i innstillinger:

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

Eksempel på ERP7 / CR-konfigurasjoner​

Konfigurasjon 1 med grunnleggende autentisering i hemmeligheter​

Angi i hemmeligheter:

{
    "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"
}

Konfigurasjon 2 med grunnleggende blandet med hemmeligheter og innstillinger​

Angitt i hemmeligheter:

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

Angitt i innstillinger:

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

Konfigurasjon 3 med IDS for REST-API-et og grunnleggende autentisering for SOAP​

Der et ERP7-/CR-miljø har IDS tilgjengelig, bruk det for REST-API-et og behold grunnleggende autentisering for SOAP.

Angitt i hemmeligheter:

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

Angitt i innstillinger:

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

To ting å merke seg med denne konfigurasjonen:

  • unit4ApiUrl fungerer også som REST-verten for IDS, så erpxHost er ikke påkrevd på ERP7 / CR. Hvis erpxHost (eller hemmeligheten erpx_host) er angitt, har den forrang.
  • Brukernavnet og passordet for grunnleggende autentisering er fortsatt påkrevd. Unit4s SOAP-tjenester støtter ikke OAuth, så SOAP-forespørsler sender legitimasjonen i selve forespørselen uavhengig av om IDS er konfigurert. Bare REST-kallene bruker IDS.