> ## 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.

# API-Schlüssel abrufen und einloggen

> Authentifizieren Sie Octoparse CLI über OAuth oder einen API-Schlüssel. Nutzen Sie für CI und automatisierte Umgebungen eine Umgebungsvariable oder stdin.

## Authentifizierungsanforderungen

Die meisten Befehle von Octoparse CLI erfordern eine Authentifizierung. Ein API-Schlüssel oder eine OAuth-Sitzung identifiziert Ihr Konto und autorisiert den Zugriff auf Ihre Octoparse-Aufgaben und -Daten.

<Warning>
  Alle funktionalen Befehle erfordern gültige Anmeldedaten, auch lokale Läufe mit `--task-file` und `.otd` sowie Befehle zur Vorlagensuche. Authentifizieren Sie sich, bevor Sie Aufgaben auflisten, Vorlagen suchen, Aufgaben ausführen oder exportieren.
</Warning>

<Note>
  Ab CLI v0.1.33 erfordern `template search`, `template view` und `template version` Anmeldedaten. In CLI v0.1.32 konnten diese Befehle denselben Vorlagenkatalog ohne Login durchsuchen.
</Note>

Nur Einrichtungs- und Diagnosebefehle können ohne Anmeldedaten ausgeführt werden:

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

## Login-Methoden

Octoparse CLI unterstützt zwei Login-Methoden: OAuth und API-Schlüssel.

### OAuth (browserbasiert)

Öffnen Sie einen Login-Ablauf im Browser und speichern Sie Zugriffs- und Aktualisierungstoken lokal:

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

Verwenden Sie OAuth, wenn Sie API-Schlüssel nicht manuell verwalten möchten oder Ihr Team SSO nutzt.

### API-Schlüssel

Erstellen Sie API-Schlüssel in der Octoparse-Konsole:

<Card title="Seite für API-Schlüssel öffnen" icon="key" href="https://www.octoparse.de/console/account-center/api-keys">
  Erstellen, kopieren und verwalten Sie Octoparse-API-Schlüssel in Ihrem Kontocenter.
</Card>

**Interaktiver Login** – öffnet die Seite für API-Schlüssel und fordert Sie anschließend zum Einfügen eines Schlüssels auf:

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

**Schlüssel direkt übergeben** – überprüft und speichert einen kopierten Schlüssel:

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

**Öffnen des Browsers vermeiden:**

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

**Schlüssel aus stdin lesen** – für Secret-Manager und CI-Pipelines:

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

Beispiel mit 1Password CLI:

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

<Note>
  Die CLI überprüft den API-Schlüssel vor dem Speichern. Ungültige Schlüssel werden nicht gespeichert.
</Note>

## Umgebungsvariable verwenden

Stellen Sie Anmeldedaten für CI oder temporäre Sitzungen über Umgebungsvariablen bereit, anstatt sie zu speichern:

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

Für den Zugriff per Bearer-Token (nützlich bei kurzlebigen CI-Aufträgen):

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

Sie können auch die API-Basis-URL überschreiben:

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

## Priorität der Anmeldedaten

Octoparse CLI prüft Anmeldedaten in dieser Reihenfolge:

```text theme={null}
1. OCTO_ENGINE_ACCESS_TOKEN  (bearer token, highest priority)
2. OCTO_ENGINE_API_KEY       (API key override)
3. ~/.octoparse/credentials.json  (stored by auth login)
```

Die Anmeldedatendatei wird automatisch von `octoparse auth login` erstellt.

Unter macOS und Linux:

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

Unter Windows:

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

<Warning>
  Übernehmen Sie API-Schlüssel oder Token nicht in Git, Skripte, Dokumente, Screenshots, geteilte Protokolle oder CI-Ausgaben.
</Warning>

## Authentifizierungsstatus prüfen und verwalten

Vergewissern Sie sich, dass Ihre Sitzung aktiv ist:

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

Zeigen Sie detaillierte Konto- und Anmeldedateninformationen an:

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

Entfernen Sie gespeicherte Anmeldedaten:

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

## Wie geht es weiter?

<CardGroup cols={2}>
  <Card title="Erste Aufgabe ausführen" href="/docs/de/cli/quick-start/run-your-first-task">
    Listen und prüfen Sie Aufgaben, führen Sie eine Aufgabe lokal aus und exportieren Sie Daten.
  </Card>

  <Card title="Alle Befehle durchsuchen" href="../reference/command-cheatsheet">
    Informieren Sie sich über Authentifizierungs-, Aufgaben-, lokale Lauf-, Cloud-Lauf- und Exportbefehle.
  </Card>
</CardGroup>