Über dieses Dokument

Dieses Dokument soll Einblicke in die Konfiguration des Efecte Self-Service-Efecte Identity-Connectors geben, wie der Efecte Self-Service die Daten verwendet, die er von Efecte Identity Management erhält, und auf welche Weise Endbenutzer Aktualisierungen ihrer Daten an Efecte Identity Management weiterleiten können.

Dieser Artikel beschreibt das Verhalten des Efecte Identity Management Connector in ESS Version 2022.3 oder neuer.

Efecte Identity Management-Konnektor

Dieser Connector übernimmt die Integration mit dem Efecte Identity Management System (im Folgenden EIM oder Efecte Identity genannt). Die Konfiguration des Connectors ist in der Datei /etc/integration-hub/tenant-configs/<tenant_name>/connector-idm.xml gespeichert. Änderungen an der Konfiguration erfordern ein Neuladen des Mandanten mit dem Befehl „integration-hub-tenant reload <tenant_name>“ .

Gemeinsamer Bestandteil der Konfiguration (verwendet von verschiedenen Konzepten dieses Connectors) sind EIM-Verbindungseigenschaften in Beans mit der ID ="idmRemoteConfiguration" .

Um eine SSL-verschlüsselte Verbindung zu nutzen (neben dem Aktivieren des Flags „sslEnabled“), ist auch die Konfiguration eines Zertifikats erforderlich. Der EIM-Administrator sollte Ihnen ein geeignetes Zertifikat zur Verfügung stellen, das auch von EIM unterstützt wird. So importieren Sie das Zertifikat in den lokalen Schlüsselspeicher auf dem Integration Hub-Rechner:

yes yes | keytool -importcert -file "idm-remoting.crt" -alias "idm-remoting.crt" -keystore /etc/pki/java/cacerts -storepass changeit

Bitte verwenden Sie Ihren eigenen Zertifikatsdateinamen und Ihr eigenes Keystore-Passwort.

Organisationskonnektor

Bei richtiger Konfiguration kann der Identitätsconnector als Quelle für Organisationsdaten verwendet werden und ersetzt so den LDAP-Connector.

Organisationsinformationsdaten werden von der Bean id="idmOrganizationInfoHandler" verarbeitet, die folgende Parameter enthält:

Beispielkonfiguration:

<bean id="idmOrganizationInfoHandler" class="com.efecte.integration.connector.idm.handler.IdmOrganizationInformationHandler">
<property name="efecteIdentityFacade" ref="efecteIdentityFacade"/>
<property name="searchLimit" value="500"/>
<property name="userFilter">
 <set>
  <value>cn=Users,dc=host,dc=domain,dc=com</value>
 </set>
</property>
</bean>

Die Kommunikation zwischen Efecte Identity Management und dem Connector wird durch die Bean id="efecteIdentityFacade" mit folgenden Parametern abgewickelt:

Fügen Sie für die Eigenschaften accountTypeMethodNames , roleTypeNames und/oder serviceAgreementNames zusätzliche Wert-Tags in efecteIdentityFacade hinzu.

efecteIdentityFacade

<bean id="efecteIdentityFacade" class="com.efecte.integration.connector.idm.EfecteIdentityFacade">
  <constructor-arg ref="idmRemoteConfiguration"/>
  <property name="accountTypeMethodNames">
    <set>
      <value>AD Password</value>
      <value>Some Other Password</value>
    </set>
  </property>
  <property name="serviceAgreementNames">
    <set>
      <value>Customer - AD users</value>
    </set>
  </property>
  <property name="roleTypeNames">
     <set>
        <value>AD group</value>
     </set>
  </property>
</bean>

Abrufleistung

Leistungsstatistiken können aktiviert werden, um eine detailliertere Ansicht des Ausführungsflusses zu erhalten. Konfigurieren Sie dazu den Metrikdienst in der Connector-Konfigurations-XML:

<!-- Performance Metrics -->
<bean class="com.efecte.integration.util.Metrics" id="metrics" init-method="init" destroy-method="destroy">
 <property name="metricsEnabled" value="true"/>
 <property name="metricsLogName" value="Metrics"/>
 <property name="metricsLogMarker" value="METRICS"/>
 <property name="reportTimeUnit" value="MINUTES"/>
 <property name="reportPeriod" value="1"/>
</bean>
<bean id="idmOrganizationInfoHandler" class="com.efecte.integration.connector.idm.handler.IdmOrganizationInformationHandler">
 ... existing configuration ...
 <property name="metrics" ref="metrics"/>
</bean>

und konfigurieren Sie den entsprechenden Logger in der Datei log4j.xml:

<appender name="agent-stats" class="org.apache.log4j.RollingFileAppender">
 <!-- The active file to log to -->
 <param name="file" value="/var/log/integration-agent/agent-stats.log"/>
 <param name="append" value="true"/>
 <param name="encoding" value="UTF-8"/>
 <param name="MaxFileSize" value="100MB"/>
 <param name="MaxBackupIndex" value="10"/>
 <layout class="org.apache.log4j.PatternLayout">
  <param name="ConversionPattern" value="%c{1}|%p|%d|%t|%X{hostName}|%m%n"/>
 </layout>
</appender>
<!-- Application performance metrics -->
<logger name="Metrics">
 <level value="info"/>
 <appender-ref ref="agent-stats"/>
</logger>

Daten von Efecte Identity Management

Im Folgenden sind die wichtigsten Datenfelder eines Benutzers (eines Agenten) in EIM aufgeführt, die das ESS beim Abrufen und Schreiben von Daten verwendet.

Efecte Self Service-Konfiguration

Um den Efecte Identity Connector als Organisations-Connector auszuwählen, konfigurieren Sie ihn auf der Seite der Integration Suite und öffnen Sie dann die Admin-Seite von Efecte Self Service. Wählen Sie Integrationen -> Organisation -> Organisations-Connector.

Bevor Sie den Connector ändern, passen Sie die Administratorgruppen entsprechend den neuen Organisationsdaten an. Dies kann auf zwei Arten erfolgen:

• auf der Admin-Benutzeroberfläche, Registerkarte „Einstellungen“: „ AD Gruppe der Administratoren“ und „ AD Gruppe der Dienstbesitzer“
• im Dateiparameter webshop.properties ldap.administrator.group (beachten Sie, dass die Einstellungen aus der Datenbank zuerst kommen)

Wählen Sie anschließend aus der Dropdown-Liste „Organisations-Connector“ den Efecte Identity-Connector (sofern nicht als Standard festgelegt). Beachten Sie, dass der Organisationscache danach geleert wird und der Benutzer, falls er nicht als globaler Administrator angemeldet ist, abgemeldet werden kann. Melden Sie sich bei Bedarf erneut an und klicken Sie auf die Schaltfläche „Testdaten anzeigen“, um die Organisationsinformationen zu überprüfen.

Efecte Identity als Organisationsdaten-Connector für die globale Verwaltung

Um das Efecte Identity Management-System als Organisationsdatenanbieter für den globalen Administrator zu verwenden, konfigurieren Sie in der Datei /etc/webshop/webshop.properties (ESS-Maschine):

• globaladmin.organization.connector.type = com.efecte.integration.connector.idm.IdMConnector
• globaladmin.organization.connector.instanceName = defaultEfecteIdentity

und starten Sie ESS neu. Damit Benutzer Zugriff auf globaladmin haben, müssen sie zusätzlich der AD Gruppe angehören, die in webshop.properties als globale Administratorgruppe definiert ist.

Meine Leistungen

Der Identitätskonnektor kann als Datenquelle für die Felder „Meine Dienste“ dienen.
„Meine Dienste“ ist ein allgemeiner Name für eine Reihe von Integrationsmechanismen, die es externen Systemen ermöglichen, für Benutzer sichtbare Kataloginhalte dynamisch zu ändern.

Definieren von MyServices-Feldern

1. Gehen Sie zur ESS-Admin-Seite -> Integrationen -> Externe Datenfelder -> Externe Datenfelder
2. Drücken Sie die Schaltfläche „Meine Dienste hinzufügen“
3. Konfiguration eingeben
   • Feldname – geben Sie einen Namen ein, der als Alias für dieses MyServices-Feld verwendet werden soll
   • Daten von – wählen Sie den Efecte Identity-Connector
   • Dienst von Efecte Identity , der dem Feld „MyServices“ zugeordnet ist (Anmeldung bei Efecte Identity -> Verwaltung -> Dienste -> Dienstname)
     • Datenlisten-ID – dieser Wert sollte mit dem Namen des Dienstes übereinstimmen
4. Klicken Sie auf die Schaltfläche „Aktualisieren “. Wenn keine Fehler vorliegen, werden in der Tabelle mit den Feldelementen von „MyServices“ die Namen der „Rollen“ angezeigt, die in Efecte Identity für den Dienst definiert sind (überprüfen Sie „Rollen“ beim ausgewählten Dienst).

Der Efecte Identity-Connector ist nicht nur für die Synchronisierung von Elementen verantwortlich, sondern auch für die Verfolgung von Verknüpfungen zwischen Elementen und Benutzern.

Mein Leistungs- und Angebotskatalog

Verwenden des MyService-Eintrags als Quelle für Service Item IDs

1. Öffnen Sie auf der Registerkarte „Dienste“ der Admin-Seite einen Dienst und wählen Sie „Dienstelement“ aus.
2. Öffnen Sie in den Elementeigenschaften das Dropdown-Menü „Externer Datenlink“ und wählen Sie den Namen des MyServices-Felds aus, das Sie verwenden möchten
3. Wählen Sie aus der Dropdown-Liste „Artikel-ID“ das Element aus, das bei der Bestellung als Artikel-ID verwendet wird.

Die ID des ausgewählten Elements wird als Artikel-ID verwendet, wenn Benutzer Bestellungen für den angegebenen Artikel aufgeben.

Zuordnungen zwischen Benutzern und DataCards

Connector ist nicht nur für das Abrufen von Identity Service-Informationen verantwortlich, sondern auch für:

• Verfolgung von Verknüpfungen zwischen Identitätsdiensten und Benutzern (Identity Agent )
• Änderung dieser Assoziationen

Um diese Funktion zu nutzen:

1. Öffnen Sie auf der Admin-Seite „Service“ und wählen Sie „Service Item“ aus.
2. Öffnen Sie in den Service-Elementeigenschaften das Dropdown-Menü „MyServices-Link“ und wählen Sie den Namen des MyServices-Felds aus.
3. Wählen Sie aus der Dropdown-Liste „Unterelemente“ Folgendes aus:
   • Benutzer verwendet – in diesem Fall wird dem Benutzer eine Liste der Dienste angezeigt, mit denen er verbunden ist
   • Der Benutzer verwendet ihn nicht – in diesem Fall wird dem Benutzer eine Liste der Dienste angezeigt, mit denen er nicht verbunden ist.

Das Absenden einer Bestellung für einen Serviceartikel führt zu

• Entfernen
• Hinzufügen

Verbindung zwischen dem Benutzer ( Agent ), der die Bestellung aufgibt, und dem Efecte Identity Service.