Hemligheter

En hemlighet är ett namngivet, krypterat värde - en API-nyckel, en bärartoken eller ett lösenord. Du lagrar den en gång och hänvisar till den med namnet, så att själva värdet aldrig visas i en förfrågningsmall, en e-postlayout eller i din historik.

Skapa en hemlighet

Öppna ”Hemligheter” och klicka på ”Skapa hemlighet”.

Fält	Anmärkningar
Namn	Endast bokstäver, siffror och understreck. Måste vara unikt. Kan inte ändras i efterhand
Hemligt värde	Värdet i sig
Beskrivning	Valfritt, upp till 1 024 tecken. Det lönar sig att fylla i - i framtiden kommer du inte att minnas vilket token det här var

Namnet låses fast efter skapandet, eftersom en ändring skulle göra att alla mallar som hänvisar till det slutar fungera. För att byta namn ska du skapa en ny hemlighet, uppdatera hänvisningarna och sedan ta bort den gamla.

Att använda en hemlighet

Ange det med {{ secrets.keyName }}:

Authorization: Bearer {{ secrets.airtableAccessToken }}

Hemligheter fungerar i:

• URL:er, rubriker och innehåll i HTTP-förfrågningar
• Fälten för SMTP-användarnamn och lösenord
• E-postämnen och -texter, inklusive textfält i det visuella redigeringsverktyget

I redigeringsfältets sidofält finns ett kort med namnet ”Tillgängliga hemligheter” där dina nycklar visas som klickbara ikoner - klicka på en för att kopiera rätt syntax istället för att skriva in den själv. När du håller muspekaren över ikonen visas en maskerad förhandsgranskning så att du kan kontrollera att du har valt rätt.

Hur hemligheter skyddas

• Värdena krypteras med Cloud KMS i viloläge och dekrypteras endast medan en åtgärd pågår. Klartext lagras aldrig.
• I listan ”Secrets” visas ********, aldrig själva värdet - sidan tar inte ens emot det.
• Hemliga värden redigeras bort från förfrågningsdata innan de skrivs till historiken, så att ett lagrat token inte kan läcka ut via dina egna loggar.
• Sidekick kan avslöja att en hemlighet finns, men aldrig dess värde.

På redigeringssidan visas det aktuella värdet, så att du kan rätta till ett felstavat token.

Verifiering av en hemlighet ger resultat

Eftersom ett felaktigt namn återges som en tom sträng istället för ett felmeddelande bör du kontrollera ditt arbete:

• För en HTTP-förfrågan, använd ”Test” och läs av ”Resolved URL” och ”Resolved Body” i resultatkortet.
• Om det gäller ett e-postmeddelande, använd funktionen ”Skicka testmeddelande”.
• Efter ett live-körning öppnar du posten i historiken och granskar begärandens data.

Redigera eller ta bort en hemlighet

Båda träder i kraft omedelbart, överallt där ”secret” används, i hela din butik.

Appen genomsöker dina HTTP-förfrågningar, SMTP-servrar och e-postmallar efter hänvisningar och visar vad den har hittat - både på sidan och i bekräftelsen av raderingen, där varje berört objekt namnges.

Det kommer inte att hindra dig. Du kan ta bort en hemlighet som fortfarande används; appen ser bara till att du får veta det först.

Relaterat

• Skapa en HTTP-förfrågan från Shopify Flow - hemliga uppgifter i ett praktiskt exempel.
• Variabler och vätska - den fullständiga referensen för mallar.
• Historik och felsökning - bekräfta vad som faktiskt skickades.