# Gestisci credenziali e segreti

> Crea profili credenziali riutilizzabili e associa l’identità corretta a ogni gruppo di strumenti o passaggio del workflow.

## Prima di iniziare

Ti serve l’accesso come owner o editor della dashboard. Un profilo credenziali è un insieme di chiavi con un nome per un connettore, come Shopify – store B. I profili appartengono al workspace e possono servire più agenti o workflow.

## Crea un profilo

1. Apri **Strumenti** e seleziona il connettore.
2. Seleziona **Profilo**.
3. Scegli **Nuovo profilo**.
4. Inserisci un **Nome del profilo** che identifichi l’account del servizio o il livello di accesso.
5. Inserisci chiavi, token, credenziali client o password richiesti.
6. Scegli **Crea profilo**.

Puoi anche creare un profilo dal pannello degli strumenti di un agente. Poi [associa il profilo al connettore dell’agente](/it/docs/agents/tools), oppure selezionalo per un passaggio strumento del workflow. Usa profili diversi quando cambiano identità o permessi del provider.

## Sostituisci una credenziale

1. Apri il profilo nella pagina del connettore.
2. Inserisci il nuovo valore per ogni chiave che modifichi.
3. Scegli **Salva modifiche**.

Lasciare vuoto un valore esistente lo conserva. Modificare un profilo condiviso cambia le credenziali usate da tutte le associazioni a quel profilo.

> **Regola** — I valori salvati sono cifrati a riposo. Gli editor e l’Assistente non li ricevono mai. Solo l’owner può mostrare esplicitamente un valore salvato nel browser.

Durante l’esecuzione, Botchi legge il profilo associato e inserisce il segreto nella richiesta. Il modello lavora con nomi delle chiavi e argomenti degli strumenti, non con i valori salvati. Gli elenchi ordinari mostrano metadati mascherati, inclusi gli ultimi quattro caratteri.

## Ritira un profilo

1. Controlla gli agenti e i workflow che usano il profilo.
2. Associali a un profilo sostitutivo.
3. Scollega i numeri WhatsApp se ritiri il profilo che instrada i loro webhook.
4. Rimuovi il profilo inutilizzato.

Botchi rifiuta la rimozione finché un agente, workflow o webhook WhatsApp attivo dipende dal profilo. Rimuoverlo elimina i valori salvati.

Non esiste un archivio condiviso di segreti. Le credenziali appartengono a un profilo o a un account collegato. WhatsApp salva l’app secret Meta una volta per workspace nel profilo del connettore.

## Correlati

- [Crea strumenti HTTP personalizzati](/it/docs/tools/custom-tools)
- [Associa strumenti agli agenti](/it/docs/agents/tools)
- [Collega i canali social](/it/docs/tools/social-channels)