Der API-Key ist der Schlüssel, der Ihr Odoo-System mit dem ITscope Connector-Dienst verbindet. Ohne gültigen API-Key kann das Modul keine Anfragen an den SaaS-Service senden.

---

API-Key erstellen

1. Melden Sie sich im Kundenportal an: portal.connector.mateit.de
2. Navigieren Sie zu Einstellungen → API-Keys
3. Klicken Sie auf „Neuen API-Key erstellen"
4. Vergeben Sie eine Bezeichnung (z.B. „Odoo Produktion" oder „Odoo Staging")
5. Der Key wird einmalig angezeigt — kopieren Sie ihn sofort

---

API-Key in Odoo eintragen

1. Öffnen Sie in Odoo: Einstellungen → ITscope Connector
2. Tragen Sie im Feld SaaS Base-URL ein: https://api.connector.mateit.de/api/v1
3. Fügen Sie Ihren API-Key im Feld SaaS API-Key ein
4. Klicken Sie auf „Verbindung testen"
5. Bei Erfolg erscheint: ✓ SaaS-Verbindung aktiv — Credit-Saldo: XX.XXX Credits

---

API-Key deaktivieren

1. Im Portal unter Einstellungen → API-Keys sehen Sie alle aktiven Keys
2. Klicken Sie auf „Deaktivieren" neben dem gewünschten Key
3. Der Key wird sofort ungültig — das Odoo-Modul kann keine Anfragen mehr senden

Hinweis: Tragen Sie nach dem Deaktivieren einen neuen Key in Odoo ein, damit der Connector weiterhin funktioniert.

---

Key-Rotation (Key sicher austauschen)

Für einen unterbrechungsfreien Key-Wechsel empfehlen wir:

1. Neuen Key erstellen — der alte bleibt aktiv
2. Neuen Key in Odoo eintragen und Verbindung testen
3. Alten Key deaktivieren, sobald der neue funktioniert

Tipp: Das System erinnert Sie nach 90 Tagen per E-Mail an eine Key-Rotation.

---

Sicherheits-Tipps

• Key niemals im Quellcode speichern — nutzen Sie die Odoo-Einstellungen
• Einen Key pro Umgebung — separate Keys für Produktion und Staging
• Keys regelmäßig rotieren — empfohlen alle 90 Tage
• Alte Keys sofort deaktivieren — nicht benötigte Keys im Portal entfernen

---

Weiterführende Artikel

• Schnellstart — Erste Schritte mit dem ITscope Connector
• Odoo-Einstellungen — Alle Einstellungen im Überblick
• FAQ — Häufige Fragen zur Authentifizierung