Webservice einrichten

GenericInterface REST-Webservice in Znuny konfigurieren — Voraussetzung für alle SDK-Aufrufe.

Webservice einrichten — Znuny

Das Python SDK kann ohne GenericInterface REST-Webservice nicht mit Znuny kommunizieren.
pip install znuny installiert nur die Client-Bibliothek. Jeder ZnunyClient-Aufruf nutzt URLs wie:

https://ihr-znuny-server/Webservice/{webservice_name}/{operation_path}

Ohne Webservice erhalten Sie HTTP-404, Authentifizierungsfehler oder GenericInterface-Fehler — keine Import-Fehler in Python.

Was Sie vor dem Python-Code brauchen

Empfohlen: znuny-cli setup-system

Auf dem Znuny-Anwendungsserver ausführen (oder auf einem Host mit Zugriff auf otrs.Console.pl).

1. Paket installieren

pip install znuny

2. Assistent starten

znuny-cli setup-system

Erkennt Znuny unter /opt/znuny/bin/otrs.Console.pl oder in Docker-Containern (znuny-web-1).

3. API-Benutzer anlegen (empfohlen)

Passwort sicher speichern — nicht in Git committen.

4. Webservice konfigurieren

Import über:

otrs.Console.pl Admin::WebService::Add --name <name> --source-path <datei.yml>

5. Standard-Operations-Pfade

6. SDK verbinden

from znuny import ZnunyClient, BasicAuth, ClientConfig, TicketOperation

client = ZnunyClient(
    ClientConfig(
        base_url="https://ihr-znuny-server",
        webservice_name="PythonClientWebService",
        operation_url_map={
            TicketOperation.CREATE: "ticket-create",
            TicketOperation.GET: "ticket-get",
            TicketOperation.SEARCH: "ticket-search",
            TicketOperation.UPDATE: "ticket-update",
        },
    )
)
client.login(BasicAuth(user_login="python-client-user", password="IHR_PASSWORT"))

Manuelle Einrichtung in der Znuny-Admin-Oberfläche

Schritt 1 — Web Services öffnen

1. Als Administrator in Znuny anmelden.
2. Admin → Web Services → Web Service hinzufügen.

Schritt 2 — Provider konfigurieren

1. Name = Wert für ClientConfig.webservice_name.
2. Typ = Provider.
3. Transport = HTTP::REST.

Schritt 3 — Provider-Operationen

Include ticket data für jede Operation aktivieren.

Schritt 4 — Berechtigungen

Der Agent-Login für BasicAuth braucht Queue-Zugriff und Webservice-Berechtigung.

Schritt 5 — Testen

curl -X GET "https://ihr-znuny-server/Webservice/PythonClientWebService/ticket-get?UserLogin=python-client-user&Password=IHR_PASSWORT&TicketID=1"

YAML-Import über Konsole

/opt/znuny/bin/otrs.Console.pl Admin::WebService::Add \
  --name PythonClientWebService \
  --source-path /pfad/zur/webservice.yml

Fehlerbehebung

Weiter

Getting started und Mit Tickets arbeiten.