Sådan sender du invitationer med Business Generated Links
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.
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
-
De to keys, som kopieres fra din virksomhedskonto, er kodet med
base64
, så dit program skal først foretage enbase64-afkodning
af dem. -
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.
-
Brug
AES-CBC
med en keystørrelse på256-bit
, en blokstørrelse på128-bit
ogPKCS7 padding mode
til at krypterepayload
-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 athashe
IV efterfulgt afciphertexten
, som fremgår af dette eksempel:HMAC = HMAC-SHA256( IV + ciphertext )
.
- Brug en
-
Brug
base64
til at kryptere IV,ciphertext
og HMAC:base64_payload = base64( IV + ciphertext + HMAC )
-
Da
base64
inkluderer skråstreger (/) og plustegn (+), skal duURL-kryptere
payload
-dataene ovenfor, før du tilføjer dem til det endelige link. -
Det endelige link burde se sådan ud:
payload = urlencode( base64_payload ) https://www.trustpilot.com/evaluate-bgl/<domain>?p=<payload>
-
Erstat
domænet
med dit domænenavn ogpayload
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:
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:
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.