API-godkendelse
Sikre integrationer med de godkendelsesmetoder, der allerede er indbygget i Indexed PIM: API-nøgler pr. app, signaturverificering af webhooks, hemmelige nøgler til indgående webhooks og valgfri beskyttelse af feeds med bearer token.
API Credentials
Sådan fungerer godkendelse i Indexed PIM
Godkendelse i Indexed PIM er knyttet til den enkelte integration. Hver app gemmer de loginoplysninger, den skal bruge for at tale med sin eksterne tjeneste, og hvor platformen modtager indgående forespørgsler, valideres hemmelige nøgler eller bearer tokens.
WooCommerce-appen gemmer for eksempel butiks-URL, consumer key og consumer secret. e-conomic-appen gemmer et app secret token og et agreement grant token. Feed-endpoints kan kræve en `Authorization: Bearer ...`-header, før de genererer output.
Indexed PIM har ikke en fælles API-nøgleadministration eller et OAuth2-lag på tværs af hele platformen. I stedet bruger hvert appmodul de godkendelsesmetoder, der er beskrevet her.
Indbyggede metoder
Udgående API-loginoplysninger pr. app til de tilsluttede tjenester
Genererede webhook-nøgler og HMAC SHA256-signaturer på udgående webhooks
Validering af hemmelige nøgler på indgående webhooks, fx fra e-conomic
Valgfrit krav om bearer token på offentlige feed-endpoints
Forbindelsestest, der tjekker de gemte loginoplysninger, før synkroniseringen kører
Godkendelsesmetoder i brug
Platformen bruger praktisk godkendelse tilpasset den enkelte tjeneste frem for én universel model for loginoplysninger.
Loginoplysninger fra app til tjeneste
Integrationsapps gemmer de loginoplysninger, der skal til for at forbinde til hver tjeneste – for eksempel consumer keys til WooCommerce og tokenpar til e-conomic.
Solution:
Hver app-instans kan konfigureres for sig pr. marked, butik eller ekstern konto.
Signering af udgående webhooks
Når Indexed PIM sender webhooks, signeres payloaden med en genereret nøgle og leveres med en `X-Webhook-Signature`-header baseret på HMAC SHA256.
Solution:
Modtageren kan verificere payloaden, før den handler på den.
Hemmelige nøgler på indgående webhooks
Webhook-endpoints som dem til e-conomic validerer den hemmelige nøgle i URL'en, før de behandler opdateringer af kunder, produkter eller bogførte fakturaer.
Solution:
Uautoriserede kald afvises, før synkroniseringen går i gang.
Feeds beskyttet med bearer token
Den offentlige feed-controller kan læse `Authorization`-headeren, udtrække et bearer token og afvise forespørgsler, der ikke matcher feedets konfiguration.
Solution:
Maskinlæsbare eksporter kan ligge på en offentlig URL og stadig kræve et delt hemmeligt token.
Typisk opsætning
Indtast loginoplysninger på appen
Appens redigeringsformular gemmer tjenestespecifikke værdier som tokens, URL'er, nøgler og hemmeligheder direkte på integrationen.
Test forbindelsen
Apps som e-conomic og WooCommerce har en forbindelsestest, så teamet kan validere loginoplysningerne, før den automatiske synkronisering slås til.
Beskyt indgående forespørgsler
Webhook-ruter validerer hemmelige nøgler, og feed-ruter kan kræve et bearer token, før de returnerer data til eksterne modtagere.
Gennemgå forespørgsler i logs
Når loginoplysninger fejler, eller et eksternt API afviser en forespørgsel, gør appens logsider det lettere at se payload, statuskoder og svartider.
Om OAuth
Enkelte apps i Indexed PIM bruger OAuth-baserede forløb, men platformen har ikke en generel OAuth2-funktion. Fokus her er derfor de godkendelsesmetoder, som integrationsmodulerne og feed-endpoints bruger.
Har du brug for sikre integrationer, hvor du kan se, hvordan de godkender?
Konfigurer loginoplysninger pr. app, verificer indgående webhooks, signer udgående payloads, og brug API-logs til at se præcis, hvordan hver integration godkender sig.