Tietoa tästä dokumentista

Tämän dokumentin tarkoituksena on antaa käsitys Efecte Self-Servicen Efecte Identity -konnektorin määrityksestä, siitä miten Efecte Self-Service käyttää Efecte Identity Managementista saamiaan tietoja, sekä tavoista, joilla loppukäyttäjät voivat päivittää tietojaan Efecte Identity Managementiin.

Tässä artikkelissa kuvataan Efecte Identity Management -konnektorin toiminta ESS-versiossa 2022.3 tai uudemmassa.

Efecte Identity Management -konnektori

Tämä konnektori huolehtii integraatiosta Efecte Identity Management -järjestelmän kanssa (jäljempänä EIM tai Efecte Identity). Konnektorin määritys tallennetaan /etc/integration-hub/tenant-configs/<tenant_name >/connector-idm.xml -tiedostoon. Määrityksen muutokset edellyttävät vuokralaisen uudelleenlatausta suorittamalla "integration-hub-tenant reload <tenant_name>" -komento.

Määrityksen yhteinen osa (jota käyttävät tämän konnektorin eri toiminnot) ovat EIM-yhteyden ominaisuudet beanissa, jonka id on ="idmRemoteConfiguration".

SSL-salatun yhteyden käyttämiseksi ('sslEnabled'-lipun käyttöönoton lisäksi) tarvitaan myös varmenteen määritys. EIM:n pääkäyttäjän tulisi toimittaa sinulle sopiva varmenne, joka on tuettu myös EIM:n puolella. Tuo varmenne paikalliseen keystoreen Integration Hub -koneella suorittamalla:

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

Käytä omaa varmennetiedoston nimeäsi ja keystore-salasanaasi.

Organisaatiokonnektori

Kun se on määritetty oikein, Identity-konnektoria voidaan käyttää organisaatiotietojen lähteenä, jolloin se korvaa LDAP-konnektorin.

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

Esimerkkimääritys:

<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 konnektorin välistä viestintää käsittelee bean id="efecteIdentityFacade" seuraavilla parametreilla:

Lisää ominaisuuksiin accountTypeMethodNames, roleTypeNames ja/tai serviceAgreementNames lisää value-tageja kohteessa 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>

Haun suorituskyky

Suorituskykytilastot voidaan ottaa käyttöön tarkemman näkymän saamiseksi suoritusvuosta. Tee tämä määrittämällä metrics-palvelu konnektorin xml-määrityksessä:

<!-- 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 loki (logger) 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 Managementista saatava data

Seuraavassa on lueteltu EIM:n käyttäjän (agentin) keskeiset tietokentät, joita ESS käyttää tietoja hakiessaan ja kirjoittaessaan.

Efecte Self Service -määritys

Valitaksesi Efecte Identity -konnektorin organisaatiokonnektoriksi, määritä se Integration Suiten puolella ja avaa sitten Efecte Self Servicen pääkäyttäjäsivu, valitse Integrations -> Organization -> Organization Connector.

Ennen konnektorin vaihtamista muuta pääkäyttäjäryhmät uusien organisaatiotietojen mukaisiksi. Tämä voidaan tehdä kahdella tavalla:

• pääkäyttäjän käyttöliittymässä "Settings"-välilehdellä: "Administrators' AD group" ja “Service owners' AD group”
• webshop.properties-tiedoston parametrissa ldap.administrator.group (huomaa, että tietokannan asetukset ovat etusijalla)

Valitse sitten "Organization Connector" -pudotusvalikosta Efecte Identity -konnektori (jos sitä ei ole asetettu oletukseksi). Huomaa, että tämän jälkeen organisaatiovälimuisti tyhjennetään, ja jos käyttäjä ei ole kirjautunut global adminina, hänet saatetaan kirjata ulos. Kirjaudu tarvittaessa uudelleen ja tarkista organisaatiotiedot napsauttamalla "Show test data" -painiketta.

Efecte Identity organisaatiotietojen konnektorina global adminille

Jotta Efecte Identity Management -järjestelmää voidaan käyttää organisaatiotietojen lähteenä global adminille, määritä /etc/webshop/webshop.properties-tiedostossa (ESS-koneella) seuraavat:

• 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 tulee lisäksi kuulua AD-ryhmään, joka on määritetty webshop.properties-tiedostossa global administrator -ryhmäksi.

My Services

Identity-konnektori voi toimia tietolähteenä My Services -kentille.
My Services on yleisnimitys joukolle integraatiomekanismeja, jotka mahdollistavat sen, että ulkoiset järjestelmät voivat dynaamisesti muokata käyttäjille näkyvän luettelon sisältöä.

MyServices-kenttien määrittäminen

1. Siirry ESS:n pääkäyttäjäsivulle -> Integrations -> External data fields -> External data fields
2. Paina Add MyServices field -painiketta
3. Enter configuration
   • Field name – anna nimi, jota käytetään tämän MyServices-kentän aliaksena
   • Data from – valitse Efecte Identity -konnektori
   • Service Efecte Identitystä kartoitettuna MyServices-kenttään (kirjaudu Efecte Identityyn -> Administration -> Services -> Service Name)
     • Data list id - tämän arvon tulee olla sama kuin palvelun nimi
4. Paina Update-painiketta - jos virheitä ei ilmene, MyServices field elements -taulukossa näkyvät palvelulle Efecte Identityssä määritellyt 'Roles'-nimet (tarkista 'Roles' valitulta palvelulta)

Efecte Identity -konnektori ei vastaa ainoastaan elementtien synkronoinnista, vaan myös elementtien ja käyttäjien välisten liitosten seurannasta.

My Services ja tarjousluettelo

MyService-tietueen käyttäminen palvelunimiketunnusten (Service Item ID) lähteenä

1. Avaa pääkäyttäjäsivun Services-välilehdellä palvelu ja valitse Service Item
2. Avaa nimikkeen ominaisuuksissa 'External data link' -pudotusvalikko ja valitse käytettävän MyServices-kentän nimi
3. Valitse 'Item ID'-pudotusvalikosta elementti, jota käytetään ItemId-arvona tilausta tehtäessä

Valitun elementin tunnusta käytetään ItemID-arvona, kun käyttäjät tilaavat kyseistä nimikettä.

Käyttäjien ja DataCards-korttien väliset liitokset

Konnektori ei vastaa ainoastaan Identity Service -tietojen hakemisesta, vaan myös:

• Identity Servicejen ja käyttäjien (Identity Agents) välisten liitosten seurannasta
• näiden liitosten muuttamisesta

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

1. Avaa pääkäyttäjäsivulla Service ja valitse Service Item
2. Avaa palvelunimikkeen ominaisuuksissa 'MyServices Link' -pudotusvalikko ja valitse MyServices-kentän nimi
3. Valitse Sub-items-pudotusvalikosta:
   • User using – tässä tapauksessa käyttäjälle näytetään lista palveluista, joihin hänet on liitetty
   • User not using – tässä tapauksessa käyttäjälle näytetään lista palveluista, joihin häntä ei ole liitetty

Palvelunimikkeen tilauksen lähettäminen johtaa seuraavaan:

• Poistamiseen
• Lisäämiseen

liitos tilauksen tekevän käyttäjän (agentin) ja Efecte Identity Servicen välillä.