# KI Proxy Konfiguration

Wenn Sie Squeeze mit dem KI Proxy verwenden möchten, dann folgen Sie folgendem Leitfaden für die Konfiguration.

<p class="callout info">Die Integration des KI Proxies ist erst ab Squeeze 2.6 verfügbar.</p>

<p class="callout info">Ab Squeeze 2.13 müssen sie <span style="text-decoration: underline;">keinen</span> KI Proxy Token konfigurieren, <span style="text-decoration: underline;">falls</span> ihr Squeeze Mandant bereits mit dem Portal verknüpft wurde. In diesem Fall authentifiziert sich Squeeze beim KI Proxy mittels OAuth über das Portal.</p>

### Integration konfigurieren

#### Authentifizierung mittels KI Proxy Token (Bisheriges Verfahren)

Um die Integration der KI für alle Mandanten eines Servers zu konfigurieren, fügen Sie folgende Konfiguration der Server-Konfiguration hinzu:

```JSON
{
    "dexp": {
        "aiProxy": {
            "baseUrl": "https://ocr-proxy.squeeze.one",
            "token": "...",
            "version": "v0"
        }
    }
}
```

Ersetzen Sie "..." durch den Access Token, der Ihnen zur Verfügung gestellt wurde.

#### Authentifizierung mittels Portal

Bei der Authentifizierung über das Portal, müsste die Konfiguration wie folgt aussehen. Mehr zur Integration des Portals, finden sie [hier](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/portal-integration "Portal Integration").

<p class="callout warning">Hinterlegen Sie die Portal-Konfiguration **nie** in der Serverkonfiguration, sondern nur in der Mandantenkonfiguration.</p>

```JSON
{
    "dexp": {
        "aiProxy": {
            "baseUrl": "https://ocr-proxy.squeeze.one",
            "version": "v0"
        }
    },
    "portal": {
      	"enabled": true,
      	"host": "https://portal.dexpro.de",
        "auth": {
			"clientId": "...",
            "secret": "..."
        }
    }
}
```

### Integration nutzen

Wenn sie die Konfiguration in der Server- oder Mandantenkonfiguration hinzugefügt haben, dann können sie in der Admin-UI die KI konfigurieren.

Siehe dazu:

- [Stapelklassen-Eigenschaften](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/stapelklassen-eigenschaften "Stapelklassen-Eigenschaften")
- [Stapelklasseneigenschaften OCR-Texterkennung](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/stapelklasseneigenschaften-ocr-texterkennung "Stapelklasseneigenschaften OCR-Texterkennung")

### Ablaufende Credentials prüfen

Um server-weit zu prüfen, ob verwendete Credentials ablaufen werden, können Sie das **Squeezer** CLI nutzen:

```shell
squeezer server:check-ai-proxy-tokens -d 600

SQUEEZE Ai Proxy Token Check
============================

 [WARNING] terstegen.squeeze.one: Token expires on 2024-11-22 12:36            
```

So können Sie sich die Hilfe des Tools anzeigen lassen:

```shell
squeezer server:check-ai-proxy-tokens -h    
Description:
  Checks if ai proxy tokens are expired

Usage:
  server:check-ai-proxy-tokens [options]

Options:
  -d, --days[=DAYS]     numbers of days before ai proxy token expires; default 28 days
  -h, --help            Display help for the given command. When no command is given display help for the list command
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
```