> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credenziali e integrazioni

> Gestisci le tue connessioni e i tuoi segreti e concedili alle app e alle Automazioni che ne hanno bisogno.

<Note>Disponibile in tutti i piani Cloud; Self-hosted richiede il piano Business o superiore.</Note>

Quando un'app o un'Automazione chiama un servizio esterno, usa **le tue credenziali**. Le credenziali appartengono a te, non all'app o all'Automazione, e sono di due tipi:

* **Connessioni**: account di terze parti che autorizzi su Teable tramite OAuth, come Google, Slack o Feishu.
* **Segreti**: stringhe che salvi tu, come una chiave API o un token di accesso.

Le credenziali si gestiscono in **Impostazioni** → **Integrazioni** e da lì si concedono alle singole app e Automazioni. Dopo la concessione, chiunque esegua quell'app o quell'Automazione usa le credenziali di chi le ha concesse. Il valore non viene mostrato a nessuno e i risultati dei test di un'Automazione lo mascherano.

## Gestire connessioni e segreti

Fai clic sul tuo avatar in basso a sinistra e apri **Impostazioni** → **Integrazioni**. La pagina ha tre sezioni: **Le mie connessioni**, **I miei segreti** e **App di terze parti che hai autorizzato**.

**Aggiungi segreto** richiede:

| Campo           | Descrizione                                                                      |
| --------------- | -------------------------------------------------------------------------------- |
| **Chiave**      | Inizia con una lettera maiuscola; solo lettere maiuscole, cifre e trattini bassi |
| **Valore**      | Di sola scrittura dopo il salvataggio; inserisci un nuovo valore per sostituirlo |
| **Descrizione** | Facoltativa, per annotare a cosa serve il segreto                                |

Le connessioni si aggiungono con **Connetti nuovo account**. Quando un'autorizzazione scade, la connessione propone **Ricollega**.

Ogni credenziale indica da quante risorse è usata al momento. **Visualizza** apre l'elenco di app e Automazioni, dove puoi **Rimuovere l'autorizzazione** a una singola voce.

## Concedere una credenziale a un'app o a un'Automazione

Apri il pannello delle credenziali della risorsa:

* **App**: nel pannello di chat dell'App Builder apri **+** → **Altro** → **Credenziali e configurazione**.
* **Automazioni**: apri il flusso di lavoro e fai clic su **Credenziali e configurazione** nella scheda **Modifica**.

**Concedi** offre tre strade: **Concedi un segreto esistente** sceglie uno dei tuoi segreti o una delle tue connessioni; **Aggiungi segreto** ne crea uno e lo concede subito; oppure scegli un servizio dall'elenco **Servizi**, che avvia un flusso OAuth per un servizio non ancora collegato e concede direttamente quello contrassegnato come **Connesso**.

Ogni concessione richiede un **Nome della variabile**, l'alias con cui la credenziale è nota all'interno di quell'app o Automazione. Segue le stesse regole di denominazione della chiave di un segreto ed è il nome che legge il codice.

Il pannello può mostrare anche segnaposto **Non associato**. La copia di un'app, la duplicazione di un flusso di lavoro e l'importazione o duplicazione di un database portano con sé gli alias attesi dal codice, ma nessuna credenziale. Con **Associa la mia** fornisci la tua, così l'app o l'Automazione può funzionare.

Quando un alias contiene la credenziale di un'altra persona, **Sostituisci con il mio** la rileva. **Rimuovi solo l'autorizzazione (mantieni segnaposto)** scioglie il collegamento e lascia il segnaposto, quindi il codice resta invariato.

<Info>Per modificare le concessioni di una risorsa serve l'autorizzazione di modifica su quell'app o Automazione. Puoi concedere solo credenziali tue.</Info>

## Leggere una credenziale nel codice

| Dove                             | Come leggerla                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------- |
| Azioni script di un'Automazione  | Una variabile di ambiente, come `process.env.EXTERNAL_API_KEY`                              |
| Campi di input di un'Automazione | Fai clic su **Inserisci segreto** accanto al campo e scegli un segreto concesso             |
| Segreti in un'app                | Il codice lato server legge `process.env.MY_API_KEY`                                        |
| Connessioni in un'app            | Il codice lato server chiama `getConnectionToken('ALIAS')` per ottenere un token di accesso |

Se incolli in un campo di un'Automazione qualcosa che somiglia a una chiave, Teable lo salva come tuo segreto e lascia un riferimento al suo posto, così il testo in chiaro non finisce nella configurazione del flusso di lavoro. Se preferisci mantenere il testo così com'è, fai clic su **Annulla** nell'avviso.

## Richieste di credenziali in AI Chat

Quando l'IA ha bisogno di un account esterno, fissa nella conversazione una scheda di richiesta che indica per quale servizio vuole una connessione o per quale alias vuole un segreto. Puoi:

* **Collega il mio account**: avviare un flusso OAuth; la nuova connessione viene concessa automaticamente alla risorsa.
* **Concedi il mio…**: usare una connessione o un segreto che possiedi già.
* **Salta**: non fornire la credenziale. L'IA prosegue con le parti che non ne dipendono.

## Sostituzione, eliminazione e uscita da uno spazio

Prima che tu sostituisca il valore di un segreto, elimini un segreto o disconnetta una connessione, Teable elenca le app e le Automazioni che la usano ancora. L'eliminazione e la disconnessione le bloccano immediatamente: se devono continuare a funzionare, concedi loro prima un'altra credenziale. Il vecchio valore di un segreto non è recuperabile.

Una volta salvato il nuovo valore, un'Automazione lo usa alla prossima esecuzione; un'app lo usa al riavvio del suo ambiente di anteprima e un'app pubblicata solo dopo una nuova pubblicazione.

Se lasci uno spazio in cui un'app o un'Automazione usa ancora le tue credenziali, la pagina **Integrazioni** lo segnala con **Hai lasciato questo spazio**. Fai clic su **Rimuovi autorizzazione** per smettere di fornirle.