Unica Plan-REST-API in Unica Platform konfigurieren

Verwenden Sie diese Informationen, um die Unica Plan-REST-API in Unica Platform zu konfigurieren.

Prozedur

  1. Legen Sie unter Unica Platform | Allgemein | Verschiedenes einen Wert für token lifetime fest. Dieser Wert ist die Anzahl Sekunden, für die das Token des Anmeldeverfahrens gültig ist. Wenn Sie diesen Wert z. B. auf 86400 festlegen, gilt das Token nach der Anmeldung einen Tag lang. Der Standardwert ist 20 Sekunden. Diese Konfiguration wird bei einem API-Aufruf nicht aktualisiert. Nach Ablauf der Zeit muss ein Anmeldeaufruf erfolgen, ein neues Token angefordert werden und dieses dann im folgenden API-Aufruf verwendet werden.
  2. Nehmen Sie unter Unica Platform | Sicherheit | API-Management folgende Einstellungen vor. 
    Enable session-based API authentication: (Enabled)
Delete security token after a single use: (Disabled)

    Wenn Sicherheitstoken nach einmaliger Verwendung löschen aktiviert ist, ist vor jedem API-Aufruf ein Anmeldeaufruf erforderlich.

  3. Nehmen Sie unter Unica Platform Sicherheit | API-Management | folgende Einstellungen für die Authentifizierung vor. 
    API URI: /authentication/login
Block API access: (Disabled)
Secure API access over HTTPS: (Disabled)
Require authentication for API access: (Enabled)
  4. Klicken Sie auf API-Konfigurationsvorlage und fügen Sie ein Abmeldeverfahren hinzu, das vom Client-Stub verwendet werden soll. 
    New category name: Logout
API URI: /authentication/logout
Block API access:(Disabled)
Secure API access over HTTPS: (Disabled)
Require authentication for API access: (Enabled)
  5. Fügen Sie unter API-Konfigurationsvorlage REST API Ver 1.0 hinzu. 
    New category name: REST API Ver 1.0
API URI: /*
Block API access: (Disabled)
Secure API access over HTTPS: (Disabled)
Require authentication for API access: (Enabled)
Enable SSL if you plan to use SSL
  6. Wählen Sie Plan v2 APIs > Einstellungen bearbeiten aus und konfigurieren Sie die folgenden Werte: 
    
API URI: /v2/*
Block API access: (Disabled)
Secure API access over HTTPS: (Disabled)
Require authentication for API access: (Enabled)
  7. Klicken Sie auf Änderungen speichern, um die Konfiguration zu speichern.
  8. Unter Unica Platform Sicherheit | API-Management | kann nur ein fest codierter Benutzer verwendet werden. Dieser Benutzer muss ein Unica Plan-Benutzer mit Administratorberechtigung sein und das Kennwort darf für diesen Benutzer nicht leer sein.
  9. Verwenden Sie in Ihren Konfigurationen die folgende REST-API-URL-Struktur.

    URL für die Authentifizierung: http://<Host>:<Port>/unica/api/manager/authentication

    Host und Port müssen zur Authentifizierung auf Unica Platform verweisen.

    Unica Plan API-URL: http://<Host>:<Port>/plan/api/plan/V1

    Host und Port müssen auf Unica Plan verweisen.