Backend e dati
Segreti e chiavi API
Conserva le chiavi private che servono alla tua app per comunicare con altri servizi, tienile al sicuro e scopri come arrivano all'anteprima e alla tua app online.
Un segreto è un valore privato che serve alla tua app, ma che nessun altro deve vedere. Di solito è una chiave API o un token: il codice simile a una password che un servizio (per esempio di mappe, meteo o SMS) ti dà per permettere alla tua app di usarlo.
I segreti non fanno parte del codice della tua app. Buildliy li conserva a parte, criptati, e li passa al server della tua app quando è in funzione. In questo modo non compaiono mai nel tuo codice, su GitHub o nelle pagine che i visitatori scaricano.
Come vengono tenuti al sicuro i segreti
- Criptati quando vengono conservati. Buildliy cripta ogni segreto prima di salvarlo.
- Solo lato server. Solo il codice server della tua app può leggere un segreto. Non viene mai inviato ai browser dei visitatori.
- Mai più visibili. Dopo aver salvato un segreto, non puoi più vederne il valore: puoi solo sostituirlo.
- Solo per il proprietario. Solo il proprietario del progetto può vedere e modificare i segreti in Gestisci → Segreti. In un'app condivisa, un collaboratore può rispondere alla scheda della chiave dell'AI, ma non può sostituire una chiave che qualcuno ha già salvato.
Quando l'AI ti chiede una chiave
Se una funzione che hai chiesto ha bisogno di una chiave, l'AI si ferma e mostra una scheda nella chat. Ce ne sono di due tipi.
Una scheda Collega, per i servizi dell'elenco Connettori di Buildliy, come Resend, Twilio, Airtable o SendGrid. Clicca Collega con il nome del servizio per aggiungere la tua chiave. Buildliy controlla che la chiave funzioni con il servizio prima di salvarla, la tiene criptata e la salva nel tuo account, così puoi usarla anche nelle tue altre app. Appena il servizio è collegato, l'AI riprende la creazione. Se hai già collegato il servizio in passato ma non è ancora attivo per questa app, il pulsante invece dice Continua con il nome del servizio. Se è già collegato e attivo per questa app, l'AI lo usa e basta, e non vedi nessuna scheda. Salta per ora chiude la scheda senza collegare nulla: l'AI risponde che puoi collegare il servizio quando vuoi dalla pagina Connettori e aspetta il tuo prossimo messaggio. Vedi Connettori.
Una scheda chiave, per qualsiasi altra chiave. Mostra la domanda dell'AI, il nome con cui verrà salvata la chiave (accanto a Salvato come, per esempio WEATHER_API_KEY) e uno spazio dove incollarla.
Prendi la chiave dal servizio
Accedi al sito del servizio e copia la tua chiave API. La domanda nella scheda di solito ti dice a cosa serve la chiave.
Incollala nella scheda
Incolla la chiave nel campo. Clicca l'icona a forma di occhio se vuoi controllare cosa hai incollato, e nascondila di nuovo prima di condividere lo schermo.
Clicca Salva
La chiave viene salvata criptata. Come dice la scheda: "Salvato in modo sicuro e crittografato. Non compare mai nella chat né nel codice della tua app. Puoi cambiarlo più tardi in Gestisci → Segreti." (I collaboratori vedono "Il proprietario del progetto può cambiarlo più tardi.") Poi l'AI continua a creare usando la chiave.
Se clicchi Salta, non viene salvato nulla e l'AI va avanti senza la chiave. La funzione che ne ha bisogno non funzionerà finché non aggiungi la chiave in Gestisci → Segreti.
Per ricevere pagamenti la configurazione è diversa. Vedi Ricevi pagamenti.
Non incollare le chiavi nella chat
Tutto ciò che scrivi nella casella della chat viene salvato nella conversazione e letto dall'AI, e non viene nascosto né criptato come un segreto. Usa sempre la scheda della chiave oppure Gestisci → Segreti.
Se incolli una chiave per sbaglio
Buildliy controlla la casella della chat in cerca di chiavi segrete, come una chiave segreta di Stripe, un token di GitHub o l'indirizzo di un database con la sua password. Un messaggio che contiene una chiave non viene inviato. Appare invece una scheda intitolata Sembra una chiave segreta sopra la casella della chat, appena incolli la chiave o premi invio. Ti mostra che tipo di chiave è, con quasi tutta la chiave nascosta, e ti offre queste scelte:
- Salva come segreto: la salva in Gestisci → Segreti con il nome indicato in Salva come, per esempio
STRIPE_SECRET_KEY. Puoi cambiare il nome. Quando la chiave appartiene a un servizio dell'elenco Connettori, puoi scegliere tra Salva come tuo connettore … (Buildliy controlla che funzioni e la salva nel tuo account, così la possono usare anche le tue altre app) e Salva come segreto per questa app. In uno spazio di lavoro condiviso, prima devi spuntare una casella per confermare che i collaboratori che creano in questa app possono usare la connessione. - Modifica messaggio: porta il cursore sulla chiave così puoi toglierla. Finché la chiave resta nel messaggio, il messaggio non viene inviato.
- Non è una chiave — invia comunque: invia il messaggio così com'è, per le rare volte in cui la scheda si sbaglia.
Una volta salvata, la chiave nel tuo messaggio diventa [saved as STRIPE_SECRET_KEY], così puoi inviare il resto del messaggio in tutta sicurezza. Solo il proprietario del progetto può salvarla: i collaboratori vedono invece Rimuovi la chiave, e la scheda chiede loro di far aggiungere la chiave al proprietario in Gestisci → Segreti. Nella home, prima che la tua app esista, la scheda ti propone di togliere la chiave per il momento.
Le chiavi pensate per essere pubbliche, come una chiave pubblicabile di Stripe (pk_…), non vengono segnalate. Se alleghi un file Word, Excel o di testo che contiene una chiave segreta, la chiave viene nascosta all'AI.
Se una chiave è stata inviata comunque nella chat, considerala esposta. Vai sul sito del servizio, crea una nuova chiave ed elimina quella vecchia, poi salva la nuova chiave in Gestisci → Segreti.
Aggiungere, cambiare o rimuovere i segreti da solo
Apri Segreti
Apri la scheda Gestisci e scegli Segreti.
Compila Aggiungi un nuovo segreto
Sotto Aggiungi un nuovo segreto, inserisci un Nome in lettere maiuscole con i trattini bassi, come
WEATHER_API_KEY, il Valore e, se vuoi, una Descrizione per ricordarti a cosa serve.Salvalo
Clicca Salva. Il segreto compare sotto Segreti salvati.
Il nome deve coincidere con quello usato dal codice della tua app. Se non sei sicuro, chiedi all'AI quale nome si aspetta.
Da quale nome di segreto legge la sua chiave il widget del meteo?
- Cambiare un segreto. Clicca l'icona con la freccia circolare (Ruota questo segreto), incolla il nuovo valore e clicca Ruota. Sugli schermi più larghi, la colonna Rotazioni conta quante volte un segreto è stato ruotato.
- Salvare su un nome già esistente. Se salvi un segreto con un nome già salvato, il vecchio valore viene sostituito. Buildliy te lo chiede prima: la tua anteprima passa subito al nuovo valore, mentre la tua app pubblicata tiene quello vecchio finché non pubblichi di nuovo. Puoi scegliere Tieni quello vecchio oppure Sostituisci.
- Rimuovere un segreto. Clicca l'icona del cestino (Elimina questo segreto) e conferma. La tua app non potrà più usarlo: l'anteprima subito, l'app pubblicata alla prossima pubblicazione.
I segreti nell'anteprima e nella tua app online
- La tua anteprima riceve da sola un segreto nuovo, modificato o rimosso. Non devi rifare la creazione.
- La tua app pubblicata riceve i suoi segreti quando pubblichi. Dopo aver cambiato un segreto, pubblica di nuovo così il tuo sito online usa il nuovo valore. Quando la tua app è online, il messaggio che vedi dopo una modifica in Gestisci → Segreti, o dopo aver salvato una chiave da una scheda nella chat, ti ricorda di ripubblicare.
Segreti e connettori
Entrambi conservano le chiavi in modo sicuro. La differenza è dove si trovano e chi può usarli.
| Connettore | Segreto | |
|---|---|---|
| Dove viene salvato | Nel tuo account Buildliy | In una sola app |
| Chi lo usa | Per impostazione predefinita tutte le tue app (puoi disattivarlo per una singola app in Gestisci → Connettori); un'app condivisa con il tuo team solo dopo che lo attivi lì | Solo questa app |
| Controllato prima del salvataggio | Sì, Buildliy prova la chiave con il servizio | No |
| Ideale per | Servizi dell'elenco Connettori che usi in più app | Qualsiasi altra chiave, o una chiave diversa solo per un'app |
Se un segreto e un connettore hanno lo stesso nome, per quell'app vince il segreto. È un modo semplice per usare una chiave diversa in una sola app.
Le chiavi che Buildliy aggiunge per te
Alcune funzioni aggiungono dei segreti al posto tuo. Se la tua app usa l'AI nella tua app, vedrai BUILDLIY_API_KEY e BUILDLIY_API_URL. Se riceve pagamenti, vedrai BUILDLIY_API_KEY e BUILDLIY_WEBHOOK_SECRET. Se permette ai visitatori di caricare file o segnala i propri errori, vedrai BUILDLIY_API_KEY e BUILDLIY_API_URL. Se ha attività programmate, vedrai BUILDLIY_CRON_SECRET. Non modificarli e non eliminarli, altrimenti quelle funzioni smettono di funzionare.
Vedi anche
Hai ancora dubbi? Leggi le FAQ o contattaci.