Vai al contenuto principale
I segreti sono il posto in cui la tua app conserva chiavi API, token e password. Così le sue funzioni backend possono usarli senza che i valori compaiano mai nel codice della tua app. Li aggiungi, modifichi ed elimini dalla pagina Secrets nella dashboard della tua app. Puoi anche incollare una chiave nella chat AI e Base44 la salva per te.
La pagina Secrets appare nella dashboard quando la tua app usa funzioni backend.

Ottenere una chiave API

Una chiave API funziona come una password privata tra la tua app e un servizio esterno. Dimostra che l’account è tuo e mantiene sicura la connessione. Crei la chiave nel servizio stesso, poi la aggiungi alla tua app.
Non condividere mai pubblicamente la tua chiave API. Trattala come una password.
Per ottenere una chiave API:
  1. Accedi al servizio esterno, ad esempio OpenAI, Resend o Stripe.
  2. Apri la sua sezione Developer, API o Integrations.
  3. Crea una nuova chiave API o un nuovo token.
  4. Copia la chiave.
  5. Aggiungi la chiave alla tua app come segreto. Puoi aggiungerla nella pagina Secrets o incollarla nella chat AI.

Aggiungere segreti

Aggiungi un segreto quando un servizio ti dà una chiave che serve alla tua app. Se la chat AI ha bisogno di una chiave, mostra un modulo dove puoi inserirla, e la chiave viene salvata come segreto per te. Le tue funzioni backend trovano ogni segreto in base al suo nome esatto. Se la chat AI ha già scritto una funzione che si aspetta una chiave, usa il nome che ti ha indicato.
La scheda Action needed della chat AI che chiede un segreto RESEND_API_KEY, con i pulsanti Skip e Submit Secrets

La chat AI che chiede un segreto

Per aggiungere un segreto:
  1. Vai all’editor della tua app.
  2. Clicca Dashboard.
  3. Clicca Secrets.
  4. Clicca Add Secret.
  5. Inserisci il Secret Name, ad esempio STRIPE_API_KEY. I nomi non possono contenere spazi, quindi usa i trattini bassi.
  6. Incolla la chiave in Secret Value.
  7. Clicca Add Secret.
Pagina Application Secrets con Secrets evidenziato nella barra laterale e 4 segreti mascherati

I segreti salvati della tua app

Per aggiungere più segreti insieme, clicca Import .env invece di Add Secret, poi carica o incolla il tuo file .env. Ogni riga KEY=VALUE diventa un segreto. Un segreto esistente con lo stesso nome riceve il nuovo valore.

Incollare chiavi nella chat

Quando incolli una chiave API in un messaggio della chat AI, Base44 la salva come segreto per te e la toglie dal messaggio prima che l’AI lo legga. Succede in ogni modalità della chat, e l’AI lavora con il nome del segreto, mai con la chiave stessa. Nel tuo messaggio, la chiave viene sostituita da una riga che inizia con “Secret detected and saved as” e indica il nome del segreto, come $STRIPE_SECRET_KEY. Il segreto appare poi nella pagina Secrets, dove puoi modificarlo o eliminarlo come qualsiasi altro segreto. Base44 riconosce le chiavi di OpenAI, Anthropic, Stripe, AWS, GitHub, Google e Slack, i token dei bot di Telegram e Discord e i JSON Web Token. Per le chiavi di altri servizi, aggiungile tu come segreti invece di incollarle nella chat.

Modificare o eliminare i segreti

Aggiorna un segreto quando rigeneri una chiave nel servizio da cui proviene. Eliminalo quando la tua app non usa più quel servizio. Scegli cosa vuoi fare:
Puoi sostituire il valore di un segreto, ma non puoi rinominarlo. Per usare un nome diverso, aggiungi un nuovo segreto ed elimina quello vecchio.Per modificare il valore di un segreto:
  1. Vai all’editor della tua app.
  2. Clicca Dashboard.
  3. Clicca Secrets.
  4. Clicca l’icona di modifica accanto al segreto.
  5. Incolla il nuovo valore.
  6. Clicca Save.
L’eliminazione avviene subito, senza conferma, e non puoi annullarla. Una funzione che legge ancora il segreto non riceve nessun valore. Chiedi quindi alla chat AI di rimuovere o aggiornare anche quel codice.Per eliminare un segreto:
  1. Vai all’editor della tua app.
  2. Clicca Dashboard.
  3. Clicca Secrets.
  4. Clicca l’icona di eliminazione accanto al segreto.

Applicare le modifiche

Quando aggiungi, modifichi o elimini un segreto, le tue funzioni backend recepiscono la modifica automaticamente mentre costruisci e usi l’anteprima. La tua app pubblicata può mantenere i valori che aveva all’ultima pubblicazione. Pubblica quindi di nuovo la tua app per essere sicuro che la tua app live usi la modifica.

Mantenere privati i segreti

I segreti sono crittografati e archiviati in modo sicuro, e restano sul server. Le tue funzioni backend li leggono quando vengono eseguite. I valori completi dei segreti quindi non raggiungono mai il browser né le persone che usano la tua app. Dopo che salvi un segreto, il suo valore completo resta nascosto, anche a te. Quando salvi un valore di 30 caratteri o più, come la maggior parte delle chiavi API, la pagina Secrets ne mostra i primi 10 caratteri. Così puoi capire quale chiave è salvata. I valori più brevi restano completamente mascherati. Chiunque possa modificare la tua app può vedere questi indizi e aggiungere, modificare o eliminare i suoi segreti. Conserva una tua copia di ogni chiave che non puoi rigenerare.
Altri posti in cui conservare le chiavi:
  • API condivise: i segreti dell’app appartengono a una sola app. Per condividere un’API e le sue credenziali con tutte le app del tuo workspace, usa un’integrazione OpenAPI personalizzata.
  • Il tuo codice: se scrivi tu le funzioni backend, consulta leggere i segreti nel codice.
  • Chiavi che fanno entrare altri strumenti nelle tue app: le impostazioni del workspace hanno una propria pagina Secrets. Contiene i personal access token e, con un piano Enterprise (Business o Enterprise), le chiavi API del workspace. Permettono ai tuoi script e strumenti di lavorare con le tue app dall’esterno di Base44. Le chiavi che la tua app usa per chiamare altri servizi, come OpenAI o Resend, vanno nei segreti della tua app.
Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.