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

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Secret

> Salva chiavi API e password in modo che Research possa chiamare gli altri tuoi strumenti dagli script, senza che i valori arrivino nella chat.

I secret permettono a Research di usare gli altri tuoi strumenti, come PagerDuty, Grafana o un'API interna. Research scrive un breve script, e lo script legge il secret come variabile d'ambiente, ad esempio `$PAGERDUTY_API_KEY`. Research non vede mai il valore.

![La pagina Secrets in Settings con quattro secret dell'organizzazione](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-list.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=96f2e359f99274943e61fb34668d1364)

## Aggiungere un secret

1. Apri **Settings → Secrets**. Scegli la scheda **Organization** o **Personal** e fai clic su **New secret**.
2. Inserisci un **Name** con lettere maiuscole, cifre e trattini bassi, come `DATADOG_API_KEY`. Gli script usano questo nome.
3. Incolla il **Value**. La maggior parte delle credenziali è **Key-value**. Per un codice a due fattori, scegli **TOTP** e incolla il seed di configurazione; gli script generano da esso il codice attuale.
4. Aggiungi una **Note** che dica a cosa serve il secret e a quale host viene inviato. Research legge la nota per scegliere il secret giusto.
5. Fai clic su **Create secret**.

![Il pannello New secret con un nome, un valore nascosto e una nota](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-new.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=b95b0e2eb2aef42e9590437edf8cccc5)

> [!WARNING]
>
> **Redact value** è attivo per impostazione predefinita. Dopo il salvataggio, nessuno può più vedere il valore e non puoi disattivare l'oscuramento. Puoi comunque sostituire il valore.

Per aggiungere più secret insieme, fai clic su **Bulk add secrets** e incolla un `NAME=value` per riga, come in un file `.env`.

## Lasciare che Research chieda un secret

Quando Research ha bisogno di una credenziale che non hai salvato, mostra una scheda nella chat. Incolla il valore e fai clic su **Save secret**. Il valore va direttamente in Secrets, non nella chat. Research può usarlo dal comando successivo e nelle sessioni future.

![Una sessione di Research con una scheda che chiede all'utente di salvare una chiave API di PagerDuty](https://mintcdn.com/enclave/1alCsqvPvQsOJ-2n/images/product/secrets-chat.png?fit=max\&auto=format\&n=1alCsqvPvQsOJ-2n\&q=85\&s=0cfcb21c563467dd4b8adb6b33f3685a)

## Chi può usare un secret

* **Organization**: funziona nelle sessioni di Research di tutti i membri e nelle esecuzioni dei workflow. Solo **Owner** e **Admin** possono aggiungerlo, modificarlo o eliminarlo. I membri ne vedono nome e nota, ma non il valore.
* **Personal**: funziona solo nelle tue sessioni di Research. Chiunque può aggiungerne uno.

Se entrambi hanno lo stesso nome, viene usato il tuo secret personale.

## Modificare o eliminare un secret

Fai clic su un secret nell'elenco per sostituirne il valore, modificarne la nota o eliminarlo. Gli script che usano un secret eliminato smettono di funzionare.

> [!NOTE]
>
> Research invia un secret solo all'host API ufficiale del servizio o a un host che indichi tu. Non mostra mai il valore di un secret, nemmeno se lo chiedi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.