Passwörter vergeben und verwalten

Passwort für den IAA-Benutzer

Wenn Sie die Intrexx Administration API installieren oder aktivieren, werden Sie aufgefordert, ein Passwort für den IAA-Benutzer zu vergeben. (Vergleichen Sie hierzu den Abschnitt Wechseln Sie auf den Reiter "Administration API Konfiguration"..)

Das Passwort für den IAA-Benutzer wird verschlüsselt in der Datei admin-api.yaml abgelegt. Diese finden Sie unter folgendem Pfad: \<intrexx-installationsverzeichnis>\admin-api\cfg\

Passwort für Portal

Damit über die Intrexx Administration API auf die zur Verfügung gestellten API-Endpunkte zugegriffen werden kann, muss in der Datei admin-api.yaml auch das Passwort für das Portal (oder gegebenenfalls mehrere Portale) hinterlegt sein.

Das Hinterlegen des Passworts erfolgt bei der Installation der Intrexx Administration API automatisch (Windows - IAA über die grafische Oberfläche installieren). Bei der Aktivierung der Intrexx Administration API muss das Passwort manuell in der Datei admin-api.yaml erfasst werden (Windows - IAA über die grafische Oberfläche aktivieren). Das Passwort wird verschlüsselt hinterlegt.

Neues Passwort für IAA-Benutzer vergeben

Sie können das Passwort jederzeit in der Datei ändern. Nach dem Speichern wird das Passwort von der Intrexx Administration API verschlüsselt.

Öffnen Sie in einem Editor die Datei admin-api.yaml.

Diese finden Sie unter folgendem Pfad:

\<intrexx-installationsverzeichnis>\admin-api\cfg\
Überschreiben Sie das Passwort.
Merken Sie sich das Passwort. (Das Passwort wird am Ende der Änderung nur noch verschlüsselt angezeigt.)
Starten Sie den Intrexx Administration API-Dienst neu.
Aktualisieren Sie das Dokument.
Das Passwort wird verschlüsselt angezeigt.

Änderung von Passwörtern für Intrexx-Komponenten nachpflegen

Die in der Datei admin-api.yaml hinterlegten Passwörter werden nicht automatisch angepasst, wenn sie im Portal Manager geändert werden.

Grund dafür ist, dass die Administration-API eigenständig betrieben werden kann (bspw. auf einem anderen Host) und insofern kein Teil des Intrexx-Servers ist. Neue oder geänderte Passwörter müssen daher manuell in admin-api/cfg/admin-api.yaml eingetragen und die Intrexx Administration API anschließend neu gestartet werden. Die Passwörter werden dabei verschlüsselt und nur noch in dieser gesicherten Form in der Konfiguration hinterlegt. Für den laufenden Betrieb bedeutet das: Wird das Passwort des technischen API-Users Intrexxseitig für den Supervisor oder ein Portal geändert, verlieren die API-Endpunkte dadurch vorübergehend ihre Autorisierung. Vor allem bei unerwarteten Meldungen fehlender Autorisierung empfiehlt es sich daher, die Passwörter in admin-api/cfg/admin-api.yaml zu überprüfen, sie gegebenenfalls neu einzutragen und die Intrexx Administration API neu zu starten, um sicherzugehen, dass sie mit denen aufseiten des Intrexx-Servers übereinstimmen.

admin-api.yaml

---
environment:
  host: "0.0.0.0"
  port: 4242
  portalManagementBySupervisor: false
  keystorePassword: "apiape-v1:rjIkOYgF3nzFmJhWsvpCwg=="
  sudoPassword: null
  keystore: "/opt/intrexx/admin-api/cfg/cacerts"
  secret: "apiape-v1:2g30kd5kFu8uLxplMzlhYp6J2k6Zb/HP8YZo3j/d2ToTTAU4xCe2VdnoGqi+MiOqu/n7vQmLIJgY3VeWAB0GSg=="
https: true
debugMode: true
credentials:
  password: "apiape-v1:rjIkOYgF3nzFmJhWsvpCwg=="
  username: "irma"
supervisor: null
maxAuthRequestPerIP: 50
https: true
license: null
connectTimeout: 5
readTimeout: 5
writeTimeout: 5
portals:
- name: "exampleportal"
  scheme: "https"
  host: "localhost"
  port: 8117
  credentials:
    password: ""
    username: "Administrator"