Segreti
Memorizzate chiavi API e password in modo crittografato e richiamatele con {{ secrets.keyName }} nei modelli Shopify Flow.
Un segreto è un valore identificato e crittografato: una chiave API, un token bearer, una password. Lo si memorizza una sola volta e lo si richiama per nome, pertanto il valore stesso non compare mai in un modello di richiesta, in un layout di e-mail o nella cronologia.
Creare un segreto
Apra "Segreti" e faccia clic su "Crea segreto".
| Campo | Note |
|---|---|
| Nome | Solo lettere, numeri e trattini bassi. Deve essere univoco. Non può essere modificato in seguito |
| Valore segreto | Il valore in sé |
| Descrizione | Facoltativo, fino a 1024 caratteri. Vale la pena compilarlo: in futuro non ricorderà più a quale token si riferisse |
Il nome viene fissato al momento della creazione, poiché modificarlo comprometterebbe il funzionamento di tutti i modelli che vi fanno riferimento. Per rinominarlo, si deve creare un nuovo segreto, aggiornare i riferimenti e infine eliminare quello precedente.
Utilizzo di un segreto
Si prega di citare la fonte all'indirizzo {{ secrets.keyName }}:
Authorization: Bearer {{ secrets.airtableAccessToken }}I segreti funzionano in:
- URL, intestazioni e corpi delle richieste HTTP
- Campi relativi al nome utente e alla password SMTP
- Oggetti e corpi delle e-mail, compresi i campi di testo del visual builder
La barra laterale dell'editor presenta una scheda "Segreti disponibili" che elenca le vostre chiavi sotto forma di badge cliccabili: cliccate su uno di essi per copiare la sintassi corretta, anziché digitarla manualmente. Passando il mouse sopra il badge viene visualizzata un'anteprima mascherata, in modo da poter verificare di aver selezionato quella giusta.
Come vengono tutelati i segreti
- I valori vengono crittografati con crittografia a involucro in fase di archiviazione tramite Cloud KMS e decrittografati solo durante l'esecuzione di un'azione. Il testo in chiaro non viene mai memorizzato in modo permanente.
- L'elenco "Secrets" mostra
********, mai il valore: la pagina non lo riceve nemmeno. - I valori riservati vengono oscurati dai dati della richiesta prima che questi vengano registrati nella cronologia, pertanto un token memorizzato non può trapelare attraverso i Suoi log.
- Sidekick può dirvi che esiste un segreto, ma mai quale sia il suo valore.
La pagina di modifica mostra effettivamente il valore attuale, pertanto è possibile correggere un token digitato in modo errato.
La verifica di un segreto porta a una soluzione
Poiché un nome errato viene visualizzato come stringa vuota anziché come errore, si raccomanda di verificare il proprio lavoro:
- Per una richiesta HTTP, utilizzi la funzione "Test" e consulti i campi "URL risolto" e "Corpo risolto" nella scheda dei risultati.
- Per inviare un’e-mail, utilizzi l’opzione “Invia e-mail di prova”.
- Al termine di un'esecuzione dal vivo, apra la voce corrispondente nella Cronologia ed esamini i dati della richiesta.
Modifica o eliminazione di un segreto
Entrambe le modifiche hanno effetto immediato, ovunque venga utilizzato tale codice segreto, in tutto il vostro negozio.
L'app esegue una scansione delle vostre richieste HTTP, dei server SMTP e dei layout delle e-mail alla ricerca di riferimenti e vi mostra i risultati trovati, sia nella pagina che nella conferma di cancellazione, indicando ogni elemento interessato.
Ciò non vi impedirà di procedere. È possibile eliminare un segreto ancora in uso; l’app si limita semplicemente ad avvisarvi prima di procedere.
Correlati
- Effettate una richiesta HTTP all'indirizzo Shopify Flow - i segreti contenuti in un esempio risolto.
- Variabili e liquidi - la guida completa ai modelli.
- Cronologia e risoluzione dei problemi - confermare ciò che è stato effettivamente inviato.