Tietoja tästä asiakirjasta

Tämän dokumentin tarkoituksena on antaa käsitys Efecte Self-Service Efecte Identity -liittimen konfiguroinnista, siitä, miten Efecte Self-Service käyttää Efecte Identity Managementilta saamiaan tietoja ja millä tavoin loppukäyttäjät voivat ohjata tietojensa päivityksiä Efecte Identity Managementiin.

Tässä artikkelissa kuvataan Efecte Identity Management Connectorin toimintaa ESS-versiossa 2022.3 tai uudemmissa.

Efecte Identity Management -liitin

Tämä liitin käsittelee integroinnin Efecte Identity Management -järjestelmän (tästä eteenpäin EIM tai Efecte Identity) kanssa. Liittimen kokoonpano on tallennettu tiedostoon /etc/integration-hub/tenant-configs/<vuokralaisen_nimi>/connector-idm.xml . Muutokset kokoonpanoon edellyttävät vuokralaisen uudelleenlatausta komennolla "integration-hub-tenant reload <vuokralaisen_nimi>" .

Yhteinen osa konfiguraatiosta (joita tämän liittimen eri käsitteet käyttävät) ovat EIM-yhteyden ominaisuudet beanissa, jonka id on ="idmRemoteConfiguration" .

SSL-salatun yhteyden käyttämiseksi (sslEnabled-lipun kytkemisen lisäksi) on myös määritettävä varmenne. EIM-ylläpitäjän tulee antaa sinulle sopiva varmenne, jota myös EIM-puoli tukee. Varmenteen tuominen paikalliseen avainsäilöön Integration Hub -koneessa tapahtuu seuraavasti:

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

Käytä omaa varmennetiedostonimeäsi ja avainsäilön salasanaasi.

Organisaatioliitin

Oikein konfiguroituna identiteettiliitintä voidaan käyttää organisaatiotietojen lähteenä, mikä korvaa LDAP-liittimen.

Organisaatiotietoja käsittelee bean id="idmOrganizationInfoHandler", joka sisältää seuraavat parametrit:

Esimerkkikokoonpano:

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

Efecte Identity Managementin ja liittimen välistä kommunikointia hoitaa bean id="efecteIdentityFacade" seuraavilla parametreilla:

Lisää ominaisuuksille accountTypeMethodNames , roleTypeNames ja/tai serviceAgreementNames arvotunnisteita efecteIdentityFacade- kohtaan.

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>

Noutotehokkuus

Suorituskykytilastot voidaan ottaa käyttöön, jotta suoritusvirrasta saadaan yksityiskohtaisempi kuva. Tätä varten määritä metriikkapalvelu liittimen määritysten XML-tiedostossa:

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

ja määritä sopiva lokitiedosto log4j.xml-tiedostossa:

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

Efecte Identity Managementin tiedot

Seuraavat ovat käyttäjän (agentin) keskeiset tietokentät EIM:ssä, jota ESS käyttää tietojen noutamiseen ja kirjoittamiseen.

Efecte-itsepalvelun konfigurointi

Valitaksesi Efecte Identity -liittimen organisaatioliittimeksi, määritä se Integration Suiten puolella ja avaa sitten Efecte Self Servicen hallintasivu, valitse Integrations -> Organization -> Organization Connector.

Ennen liittimen vaihtamista vaihda järjestelmänvalvojan ryhmät uusien organisaatiotietojen mukaisesti. Tämä voidaan tehdä kahdella tavalla:

• hallintapaneelin "Asetukset"-välilehdellä: "Järjestelmänvalvojien AD -ryhmä" ja "Palvelun omistajien AD -ryhmä"
• webshop.properties-tiedostossa parametri ldap.administrator.group (huomaa, että tietokannasta tulevat asetukset ovat ensin)

Valitse sitten "Organisaatioliitin" -pudotusvalikosta Efecte Identity -liitin (jos sitä ei ole asetettu oletusarvoksi). Muista, että tämän jälkeen organisaation välimuisti tyhjennetään ja jos käyttäjä ei ole kirjautunut sisään yleisenä järjestelmänvalvojana, hänet voidaan kirjata ulos. Kirjaudu tarvittaessa uudelleen sisään ja napsauta "Näytä testitiedot" -painiketta tarkistaaksesi organisaatiotiedot.

Efecte Identity organisaation dataliittimenä globaalille hallinnolle

Jotta Efecte Identity Management -järjestelmää voidaan käyttää organisaatiotietojen toimittajana globaalille hallinnolle, määritä /etc/webshop/webshop.properties-tiedostossa (ESS-kone) seuraavat tiedot:

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

ja käynnistä ESS uudelleen. Jotta käyttäjillä olisi pääsy globaladminiin, heidän on lisäksi kuuluttava webshop.properties-tiedostossa globaaliksi järjestelmänvalvojaryhmäksi määritettyyn AD ryhmään.

Palveluni

Identiteettiliitin voi toimia Omat palvelut -kenttien tietolähteenä
Omat palvelut on yleinen nimitys joukolle integraatiomekanismeja, joiden avulla ulkoiset järjestelmät voivat dynaamisesti muokata käyttäjille näkyvää luettelon sisältöä.

MyServices-kenttien määrittäminen

1. Siirry ESS:n hallintasivulle -> Integraatiot -> Ulkoiset tietokentät -> Ulkoiset tietokentät
2. Paina Lisää OmatPalvelut -kenttä -painiketta
3. Syötä kokoonpano
   • Kentän nimi – anna nimi, jota käytetään tämän OmatPalvelut-kentän aliaksena.
   • Tiedot lähteestä – valitse Efecte Identity -liitin
   • Efecte Identityn palvelu yhdistetty OmatPalvelut-kenttään (Kirjaudu Efecte Identityyn -> Hallinta -> Palvelut -> Palvelun nimi)
     • Tietolistan tunnus – tämän arvon tulee olla sama kuin palvelun nimi
4. Paina Päivitä -painiketta. Jos virheitä ei ole, näet MyServices-kenttäelementtitaulukossa Efecte Identityssä palvelulle määriteltyjen roolien nimet (tarkista valitun palvelun roolit).

Efecte Identity -liitin ei ole vastuussa ainoastaan elementtien synkronoinnista, vaan myös elementtien ja käyttäjien välisten yhteyksien seurannasta.

Palveluni ja tarjousluetteloni

MyService-merkinnän käyttäminen palvelukohteiden tunnusten lähteenä

1. Avaa hallintasivun Palvelut-välilehdellä Palvelu ja valitse Palvelukohde.
2. Avaa Kohteen ominaisuudet -kohdassa avattava 'Ulkoinen tietolinkki' -valikko ja valitse käytettävän OmatPalvelut-kentän nimi.
3. Valitse 'Tuotetunnus'-pudotusvalikosta elementti, jota käytetään tuotetunnuksena tilausta tehtäessä.

Valitun elementin tunnusta käytetään tuotetunnuksena, kun käyttäjät tilaavat tiettyä tuotetta.

Käyttäjien ja DataCardien väliset yhteydet

Yhdistin ei ole vastuussa ainoastaan identity Service -tietojen hakemisesta, vaan myös seuraavista:

• identiteettipalveluiden ja käyttäjien (identity Agent ) välisten yhteyksien seuranta
• muuttamalla mainittuja yhdistyksiä

Tämän toiminnon käyttämiseksi:

1. Avaa hallintasivulla Palvelu ja valitse Palvelukohde
2. Avaa Palvelukohteen ominaisuuksissa avattava 'OmatPalvelut-linkki' -valikko ja valitse OmatPalvelut-kentän nimi.
3. Valitse avattavasta alivalikosta:
   • Käyttäjä käyttää – tässä tapauksessa käyttäjälle näytetään luettelo palveluista, joihin hän on liitetty
   • Käyttäjä ei käytä – tässä tapauksessa käyttäjälle näytetään luettelo palveluista, joihin hän ei ole liitetty

Palvelunimikkeen tilauksen lähettäminen johtaa

• Poistaminen
• Lisätään

tilauksen tekevän käyttäjän ( Agent ) ja Efecte Identity -palvelun välinen yhteys.