# Gestione delle chiavi API

Crea una chiave per la tua app o agente. Conservalo, controlla l'accesso e gestisci il suo ciclo di vita.

Riferimento canonico: https://flashdata.dev/it/docs/guides/api-keys-and-permissions
Recensito: 2026-11-04 da FlashData

<a id="create"></a>

## 1. Creare una chiave

1. Accedi al tuo account verificato e apri API Keys. Riutilizzare una chiave autorizzata se ne hai già una.
2. Chiamalo per l'app e l'ambiente, seleziona una scadenza e scegli le fonti di cui ha bisogno. Selezionare Google Cerca per il primo esempio di ricerca.
3. Creare la chiave e salvarla qui sotto. Dare agenti indipendenti e applicazioni di produzione chiavi separate in modo da poterli revocare individualmente.

- [Aprire API Keys](https://flashdata.dev/app/api-keys)
- [Prova prima di firmare](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

## 2. Conservare la chiave

Scegli il modo in cui eseguirai FlashData. Gli esempi API e SDK leggono FLASHDATA_API_KEY; CLI può salvare la chiave nel suo profilo protetto. In produzione, inietta le credenziali dal tuo negozio segreto.

### Bash · API / SDK

#### Impostare la chiave per questo terminale

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


### PowerShell 7 · API / SDK

#### Impostare la chiave per questo terminale

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


### CLI

Incollare la chiave al prompt nascosto. Per un profilo chiamato, append --profile NAME qui e nei comandi successivi. Un profilo configurato in precedenza richiede il login --replace per sostituire la sua chiave.

#### Salvare la chiave

```bash
flashdata auth login
```

- [Installazione CLI](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

## 3. Verificare l'accesso

Eseguire il controllo gratuito nello stesso terminale o profilo CLI. Utilizzare la scheda che corrisponde a come hai memorizzato la chiave.

### Bash / cURL

Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.

#### Leggi l'account JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.

#### Leggi l'account JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


### CLI

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

#### Leggi di account gratuito

```bash
flashdata auth status
```

- [Impostare una chiave](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

### Confermare l'account e la fonte

HTTP restituisce questi campi direttamente. Con CLI JSON, trovarli sotto data.identity.identity e richiedono anche data.accessVerified: true.

| Check | Attesi |
| --- | --- |
| accountId | L'account che possiede questo carico di lavoro. |
| access | ready |
| scopes | Include google_search per la prima ricerca. |
| recurringAllowed | true prima del lavoro del proprietario programmato. |

- [Esegui la tua prima domanda](https://flashdata.dev/it/docs/guides/http-quickstart/reference.md)
- [Controllare l'equilibrio e i prezzi](https://flashdata.dev/it/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

### Come funzionano i permessi di origine

Una chiave può utilizzare solo le sue fonti concesse. La selezione del prodotto è separata dai prezzi: ogni chiave dell'account passa dal saldo condiviso, inclusi i crediti acquistati. Una chiave ristretta non ha il proprio tappo di spesa. I prodotti futuri richiedono una licenza esplicita.

- [Catalogo autorizzazioni agente](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

## Se una chiave è esposta

1. Rivolgere immediatamente la chiave esposta nella pagina della console corrispondente qui sotto, e fermare i suoi chiamanti programmati.
2. Creare un sostituto con le autorizzazioni necessarie, installarlo nel negozio segreto di ogni chiamante, ed eseguire la verifica gratuita sopra.
3. Recensione History e l'utilizzo dell'account per attività inaspettate. La rimozione di un segreto da un file non lo revoca.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Utilizzo dell'account](https://flashdata.dev/it/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

## Ruotare una chiave

1. Creare una sostituzione con le fonti richieste e installarlo nell'ambiente di destinazione.
2. Ripetere la verifica gratuita sopra, quindi passare l'applicazione o programmatore. Aggiorna ogni chiamante previsto.
3. Rivolgere la vecchia chiave dopo che i chiamanti sono stati scambiati. Un segreto aggiornato sul tuo computer portatile non aggiorna i servizi dispiegati.

### Sostituire una chiave CLI · incollare nel prompt nascosto

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

## Accesso di fatturazione

Smettere chiamate programmate, revocare la chiave di corrispondenza o la connessione di seguito, quindi ripetere la verifica gratuita con le vecchie credenziali. Dovrebbe essere respinta. L'accesso in loco non revoca l'accesso al server.

| Tipo di accesso | Dove revocare |
| --- | --- |
| Chiave ordinaria API | API Keys |
| Chiave dell'agente presunto | Settings → Connected apps → Agent connections |
| Concessione MCP OAuth | Settings → Connected apps |

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [Risoluzione dei problemi di autenticazione](https://flashdata.dev/it/docs/guides/headers-and-authentication/reference.md#errors)
