O tym dokumencie

Niniejszy dokument ma na celu przedstawienie konfiguracji łącznika Efecte Self-Service Efecte Identity, sposobu, w jaki Efecte Self-Service wykorzystuje dane otrzymywane z Efecte Identity Management, a także sposobów, w jakie użytkownicy końcowi mogą wprowadzać aktualizacje swoich danych w Efecte Identity Management.

W tym artykule opisano zachowanie Efecte Identity Management Connector w ESS w wersji 2022.3 i nowszej.

Złącze Efecte Identity Management

Ten łącznik obsługuje integrację z systemem Efecte Identity Management (dalej zwanym EIM lub Efecte Identity). Konfiguracja łącznika jest przechowywana w pliku /etc/integration-hub/tenant-configs/<tenant_name>/connector-idm.xml . Zmiany w konfiguracji wymagają przeładowania dzierżawy poprzez wydanie polecenia „integration-hub-tenant reload <tenant_name>” .

Wspólną częścią konfiguracji (wykorzystywaną przez różne koncepcje tego łącznika) są właściwości połączenia EIM w elemencie bean o identyfikatorze ="idmRemoteConfiguration" .

Aby korzystać z szyfrowanego połączenia SSL (oprócz włączenia flagi „sslEnabled”), konieczna jest również konfiguracja certyfikatu. Administrator EIM powinien udostępnić Ci odpowiedni certyfikat, który jest również obsługiwany przez EIM. Aby zaimportować certyfikat do lokalnego magazynu kluczy na komputerze z centrum integracji, wykonaj następujące kroki:

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

Proszę użyć własnej nazwy pliku certyfikatu i hasła magazynu kluczy.

Łącznik organizacji

Po poprawnym skonfigurowaniu łącznik Identity może być używany jako źródło danych organizacji, zastępując tym samym łącznik LDAP.

Dane dotyczące organizacji są obsługiwane przez element bean id="idmOrganizationInfoHandler", który zawiera następujące parametry:

Przykładowa konfiguracja:

<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>

Komunikację między Efecte Identity Management a łącznikiem obsługuje bean id="efecteIdentityFacade" z następującymi parametrami:

W przypadku właściwości accountTypeMethodNames , roleTypeNames i/lub serviceAgreementNames należy dodać dodatkowe znaczniki wartości w efecteIdentityFacade .

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>

Pobieranie wydajności

Można włączyć statystyki wydajności, aby uzyskać bardziej szczegółowy wgląd w przepływ wykonania. Aby to zrobić, należy skonfigurować usługę metryk w pliku XML konfiguracji konektora:

<!-- 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>

i skonfiguruj odpowiedni rejestrator w pliku 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>

Dane z Efecte Identity Management

Poniżej przedstawiono kluczowe pola danych użytkownika (agenta) w EIM, których ESS używa podczas pobierania i zapisywania danych.

Konfiguracja samoobsługi Efecte

Aby wybrać łącznik Efecte Identity jako łącznik organizacji, skonfiguruj go po stronie Integration Suite, a następnie otwórz stronę administracyjną Efecte Self Service i wybierz Integracje -> Organizacja -> Łącznik organizacji.

Przed zmianą łącznika zmień grupy administratorów zgodnie z nowymi danymi organizacji. Można to zrobić na dwa sposoby:

• w interfejsie administratora, zakładka „Ustawienia”: „Grupa AD administratorów” i „Grupa AD właścicieli usług”
• w pliku webshop.properties parametr ldap.administrator.group (należy pamiętać, że ustawienia z bazy danych są wprowadzane jako pierwsze)

Następnie z listy rozwijanej „Organization Connector” wybierz Efecte Identity Connector (jeśli nie jest ustawiony jako domyślny). Pamiętaj, że po tym pamięć podręczna organizacji zostanie wyczyszczona, a jeśli użytkownik nie jest zalogowany jako administrator globalny, może zostać wylogowany. Zaloguj się ponownie w razie potrzeby i kliknij przycisk „Pokaż dane testowe”, aby sprawdzić dane dotyczące organizacji.

Efecte Identity jako łącznik danych organizacji dla globalnego administrowania

Aby użyć systemu Efecte Identity Management jako dostawcy danych organizacji dla administratora globalnego, w pliku /etc/webshop/webshop.properties (komputer ESS) skonfiguruj:

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

i uruchom ponownie ESS. Aby użytkownicy mieli dostęp do globaladmin, muszą dodatkowo należeć do grupy AD zdefiniowanej w pliku webshop.properties jako globalna grupa administratorów.

Moje usługi

Łącznik tożsamości może działać jako źródło danych dla pól Moich usług
Moje Usługi to powszechna nazwa zestawu mechanizmów integracyjnych umożliwiających zewnętrznym systemom dynamiczną modyfikację zawartości katalogu widocznej dla użytkowników.

Definiowanie pól MyServices

1. Przejdź do strony administracyjnej ESS -> Integracje -> Pola danych zewnętrznych -> Pola danych zewnętrznych
2. Naciśnij przycisk Dodaj pole Moje usługi
3. Wprowadź konfigurację
   • Nazwa pola – wprowadź nazwę, która będzie używana jako alias dla tego pola MyServices
   • Dane z – wybierz złącze Efecte Identity
   • Usługa z Efecte Identity mapowana na pole MyServices (Zaloguj się do Efecte Identity -> Administracja -> Usługi -> Nazwa usługi)
     • Identyfikator listy danych – ta wartość powinna być taka sama jak nazwa usługi
4. Kliknij przycisk Aktualizuj — jeśli nie ma błędów, w tabeli elementów pól MyServices zobaczysz nazwy „Ról” zdefiniowane w Efecte Identity dla usługi (zaznacz „Role” w wybranej Usłudze)

Łącznik Efecte Identity odpowiada nie tylko za synchronizację elementów, ale także za śledzenie powiązań między elementami i użytkownikami.

Mój katalog usług i ofert

Korzystanie z wpisu MyService jako źródła identyfikatorów pozycji usług

1. Na stronie administracyjnej w zakładce Usługi otwórz usługę i wybierz pozycję usługi
2. W oknie Właściwości elementu otwórz menu rozwijane „Łącze danych zewnętrznych” i wybierz nazwę pola Moje usługi, którego chcesz użyć
3. Z listy rozwijanej „Identyfikator przedmiotu” wybierz element, który będzie używany jako identyfikator przedmiotu podczas składania zamówienia

Identyfikator wybranego elementu będzie używany jako ItemID podczas składania zamówienia na dany element.

Powiązania między użytkownikami i kartami danych

Łącznik nie jest odpowiedzialny tylko za pobieranie informacji o usłudze tożsamości, ale także za:

• śledzenie powiązań między usługami tożsamości a użytkownikami ( Agent tożsamości)
• zmieniając wspomniane skojarzenia

Aby skorzystać z tej funkcjonalności:

1. Na stronie administratora otwórz Usługę i wybierz Element usługi
2. W oknie Właściwości elementu usługi otwórz menu rozwijane „Łącze Moje usługi” i wybierz nazwę pola Moje usługi
3. Z listy rozwijanej Podelementy wybierz:
   • Użytkownik korzystający – w tym przypadku użytkownikowi zostanie wyświetlona lista Usług, z którymi jest on powiązany
   • Użytkownik niekorzystający – w tym przypadku użytkownikowi zostanie wyświetlona lista usług, z którymi nie jest on powiązany

Złożenie zamówienia na pozycję serwisową spowoduje:

• Usuwanie
• Dodawanie

skojarzenie pomiędzy użytkownikiem ( Agent ) składającym zamówienie a Serwisem Efecte Identity.