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

# Ottieni una chiave API e accedi

> Autentica la CLI di Octoparse con OAuth o una chiave API. Usa una variabile di ambiente o stdin per CI e ambienti automatizzati.

## Requisiti di autenticazione

La maggior parte dei comandi della CLI di Octoparse richiede l'autenticazione. Una chiave API o una sessione OAuth identifica il tuo account e autorizza l'accesso alle attività e ai dati Octoparse.

<Warning>
  Tutti i comandi funzionali richiedono credenziali valide, incluse le esecuzioni locali con `--task-file` e `.otd` e i comandi per individuare i modelli. Esegui l'autenticazione prima di elencare, cercare modelli, eseguire o esportare attività.
</Warning>

<Note>
  A partire dalla CLI v0.1.33, `template search`, `template view` e `template version` richiedono credenziali. La CLI v0.1.32 consentiva a questi comandi di esplorare lo stesso catalogo di modelli senza effettuare l'accesso.
</Note>

Solo i comandi di configurazione e diagnostica possono essere eseguiti senza credenziali:

```bash theme={null}
octoparse --help
octoparse --version
octoparse capabilities
octoparse doctor
octoparse browser status
octoparse auth
octoparse auth info
```

## Metodi di accesso

La CLI di Octoparse supporta due metodi di accesso: OAuth e chiave API.

### OAuth (tramite browser)

Apri un flusso di accesso nel browser e memorizza localmente i token di accesso e aggiornamento:

```bash theme={null}
octoparse auth login --oauth
```

Usa OAuth quando preferisci non gestire manualmente le chiavi API o quando il tuo team usa SSO.

### Chiave API

Crea le chiavi API nella console Octoparse:

<Card title="Apri la pagina delle chiavi API" icon="key" href="https://www.octoparse.it/console/account-center/api-keys">
  Crea, copia e gestisci le chiavi API Octoparse dal centro account.
</Card>

**Accesso interattivo**: apre la pagina della chiave API, quindi chiede di incollare una chiave:

```bash theme={null}
octoparse auth login
```

**Passa direttamente la chiave**: verifica e memorizza una chiave copiata:

```bash theme={null}
octoparse auth login <apiKey>
```

**Evita di aprire il browser:**

```bash theme={null}
octoparse auth login --no-open
```

**Leggi la chiave da stdin**: per gestori di segreti e pipeline CI:

```bash theme={null}
echo "<apiKey>" | octoparse auth login --stdin
```

Ad esempio, con la CLI di 1Password:

```bash theme={null}
op read "op://vault/octoparse/credential" | octoparse auth login --stdin
```

<Note>
  La CLI verifica la chiave API prima di salvarla. Le chiavi non valide non vengono memorizzate.
</Note>

## Usa una variabile di ambiente

Per sessioni CI o temporanee, fornisci le credenziali tramite variabili di ambiente invece di quelle memorizzate:

```bash theme={null}
OCTO_ENGINE_API_KEY=xxx octoparse task list --json
```

Per l'accesso tramite token bearer, utile nei processi CI di breve durata:

```bash theme={null}
OCTO_ENGINE_ACCESS_TOKEN=xxx octoparse task list --json
```

Puoi anche sostituire l'URL di base dell'API:

```bash theme={null}
OCTO_ENGINE_API_BASE_URL=https://example.com OCTO_ENGINE_API_KEY=xxx octoparse task list
```

## Precedenza delle credenziali

La CLI di Octoparse controlla le credenziali in questo ordine:

```text theme={null}
1. OCTO_ENGINE_ACCESS_TOKEN  (token bearer, priorità massima)
2. OCTO_ENGINE_API_KEY       (sostituzione della chiave API)
3. ~/.octoparse/credentials.json  (memorizzate da auth login)
```

Il file delle credenziali viene creato automaticamente da `octoparse auth login`.

Su macOS e Linux:

```text theme={null}
~/.octoparse/credentials.json
```

Su Windows:

```text theme={null}
%USERPROFILE%\.octoparse\credentials.json
```

<Warning>
  Non sottoporre a commit le chiavi API o i token in Git, script, documentazione, screenshot, log condivisi o output CI.
</Warning>

## Controlla e gestisci lo stato dell'autenticazione

Verifica che la sessione sia attiva:

```bash theme={null}
octoparse auth status
```

Mostra informazioni dettagliate sull'account e sulle credenziali:

```bash theme={null}
octoparse auth info
```

Rimuovi le credenziali salvate:

```bash theme={null}
octoparse auth logout
```

## Passaggi successivi

<CardGroup cols={2}>
  <Card title="Esegui la tua prima attività" href="/docs/it/cli/quick-start/run-your-first-task">
    Elenca le attività, esaminane una, eseguila in locale ed esporta i dati.
  </Card>

  <Card title="Esplora tutti i comandi" href="../reference/command-cheatsheet">
    Esamina i comandi di autenticazione, attività, esecuzione locale, esecuzione cloud ed esportazione.
  </Card>
</CardGroup>