Sådan sender du invitationer med Business Generated Links

Denne funktion er en del af Privacy-tilkøbet, som er tilgængelig med Enterprise-pakken.

Denne artikel er rettet mod udviklere, som gerne vil oprette Business Generated Links. Hér får du hjælp til at oprette krypterede links med dit foretrukne programmeringssprog.

VIGTIGT

Business Generated Links er kun tilgængelige for nye Trustpilot-kunder inden for specifikke brancher.

For at hjælpe dig i gang har Trustpilot tilgængelige ressourcer om Authenticated Encryption på GitHub. Læs mere her.

Vejledning til alle programmeringssprog

Business Generated Links bruger Authenticated Encryption with Associated Data (AEAD) og metoden Encrypt then MAC (EtM). Trustpilot bruger én key til at kryptere dataene i payload (encryptkey) og en anden key til MAC part (authkey) for at sikre dataintegritet.

Gå ind på din virksomhedskonto > Få anmeldelser > Invitationsmetoder > Business Generated Links for at finde de to keys.

Opret Business Generated Links

  1. De to keys, som kopieres fra din virksomhedskonto, er kodet med base64, så dit program skal først foretage en base64-afkodning af dem.
  2. Opret en JSON-formatteret payload-kodestreng og indsæt kundeoplysningerne. Følgende felter er obligatoriske: email, name og ref (referencenummer). Her ses et eksempel:
    {
      "email":"eksempel@domæne.dk",
      "name":"Hans Jensen",
      "ref":"1234",
      "skus":["sku1","sku2","sku3"],
      "tags":["tag1","tag2","tag3"]
        }

    Tags må ikke indeholde mellemrum.

  3. Brug AES-CBC med en keystørrelse på 256-bit, en blokstørrelse på 128-bit og PKCS7 padding mode til at kryptere payload-dataene, så de ikke kan læses af tredjeparter.
    • Brug en Initialization Vector (IV) med en blokstørrelse på 128-bit.
    • Kryptér JSON-objektet med encryptkey og IV.
    • Opret en signatur for ciphertexten.
    • For at oprette en signatur skal du bruge HMAC-SHA256 og authkey. Beregn HMAC ved at hashe IV efterfulgt af ciphertexten, som fremgår af dette eksempel: HMAC = HMAC-SHA256( IV + ciphertext ).
  4. Brug base64 til at kryptere IV, ciphertext og HMAC: base64_payload = base64( IV + ciphertext + HMAC )
  5. Da base64 inkluderer skråstreger (/) og plustegn (+), skal du URL-kryptere payload-dataene ovenfor, før du tilføjer dem til det endelige link.
  6. Det endelige link burde se sådan ud:
      payload = urlencode( base64_payload )
      https://www.trustpilot.com/evaluate-bgl/<domain>?p=<payload>
    
  7. Erstat domænet med dit domænenavn og payload med de payload-data, du genererede i trin 5.

Det følgende rutediagram viser de nødvendige trin for korrekt formatering, kryptering og klargøring af payload-dataene før distribution:

Rutediagram over trinene for Business Generated Links

Sådan verificerer du et Business Generated Link

Du kan verificere, at et Business Generated Link er oprettet korrekt, på to måder:

Test dit link i en browser

Indsæt dit link i en browser, og søg. Lav derefter en testanmeldelse: Angiv antallet af stjerner, tilføj en titel, og skriv en anmeldelse. Hvis knappen Send anmeldelse er aktiv, lykkedes din krypteringsproces. Hvis du bliver bedt om at logge ind med Facebook, Google eller e-mail, mislykkedes din krypteringsproces. Sørg for ikke at offentliggøre din testanmeldelse.

Her er et eksempel på en vellykket krypteringsproces til venstre og en mislykket til højre:

Eksempel på et vellykket krypteringslink til venstre og et mislykket til højre

Test dit link med vores command line interface (CLI)

Du kan installere vores command line interface (CLI) på din computer. Hvis du kan dekryptere dine payload-data med CLI, er de krypteret korrekt.

Undgå at bruge en generisk e-mailadresse, som f.eks. test@gmail.com. Brug i stedet en unik e-mailadresse til at foretage en test.

Sådan koder du Business Generated Links til produktanmeldelser

For at indsamle produktanmeldelser med Business Generated Links skal du føje produkt-SKU'er til dine payload-data. Her er et eksempel på payload-data, der omfatter produkt-SKU'er. Det er en simpel JSON array:

{
  "email":"eksempel@domæne.dk",
  "name":"Hans Jensen",
  "ref":"1234",
  "skus":["sku1","sku2","sku3"]
}

Hvordan tilpasser jeg et Business Generated Link til et specifikt land?

Slet og erstat "www." med den relevante landekode, som for eksempel:

https://dk.trustpilot.com/evaluate-bgl/?p= https://es.trustpilot.com/evaluate-bgl/?p=

Sådan sender du invitationer til at skrive lokationsanmeldelser med Business Generated Links

Hvis du vil bruge Business Generated Links til at sende invitationer til at skrive lokationsanmeldelser, skal du sørge for at inkludere lokationsfeltet, når du tilføjer kundens oplysninger til payload-kodestrengen. Brug det lokations-ID, du har givet den specifikke lokation.

Her ses et eksempel:

{
  "email":"eksempel@domæne.dk",
  "name":"Hans Jensen",
  "ref":"1234",
  "locationId": "id1",
  "skus":["sku1","sku2","sku3"],
  "tags":["tag1","tag2","tag3"]
}

Der skelnes mellem store og små bogstaver i lokations-ID'et.

Related articles