Määritä: Whistleblower-käyttöoikeuksien määritys
Learn how to configure Whistleblower
Määritä: Whistleblower-käyttöoikeuksien määritys
Learn how to configure Whistleblower
Tässä artikkelissa kuvataan, miten Whistleblower määritetään. Lisätietoja Whistleblower-ratkaisusta löytyy täältä.
0. Whistleblower – esivaatimukset
- ESA on käytössä ja määritetty
- Vaatii työtä Cloud OPS -tiimiltä. Cloud OPS tarvitsee oikean vuokraajan (tenant) nimen ennen kuin se voi tehdä oman osuutensa (esimerkiksi muotoa whistleblower.customer.com)
- CloudOps-insinööri ajaa automaattiset skriptit, jotka ottavat ESA:n tunnistautumiskomponentit käyttöön asiakasympäristössä.
- CloudOps määrittää ESA:n yhteen (1) ESS-sivustoon.
- Cloud Operations -tiimi lähettää konsultille ilmoituksen siitä, että pilviympäristön määritys on valmis ja käyttövalmis
- Konsultti tarvitsee pääsyn asiakkaan palvelimelle
- Ennen kuin työ voidaan aloittaa, asiakkaan on päivitettävä DNS-tietonsa Efecte Cloudin antamien tietojen mukaisesti
1. ESA:n määritys vaihe vaiheelta
- Siirry ESA-hallintakonsoliin, esim. https://customer.efectecloud.com/auth/admin
- Avaa Whistleblower-realm vasemmasta yläkulmasta

- Vasta luodussa "whistleblower"-määrityksessä on valmiiksi määritetty Shibboleth-asiakas (client). Varmista, että sinne on määritetty mapperi "com:efecte:ess:user" tyypillä SAML Efecte ESS user mapper - Whistleblower realm:

- Poista ESM-pääsy WB-käyttäjiltä. Tämä on asetettava arvoon DISABLE ESA:n Shibboleth-mappereista, jotta pääsy ESM:ään estyy.

-
ESA-tarkistuspiste: Kopioi Clientin URL ilman /shibboleth-päätettä ja yritä avata ESS-portaali. Kirjautumisnäytön pitäisi nyt toimia, mutta portaali on vielä tyhjä.

Tarkista whistleblower-javascript-käyttäjämapperi
"distinguishedName": "CN=" + user.username + ",OU=users,DC=whistleblower",
Katso tästä ohjeet mapperien muuttamiseen ja muutosten käyttöönottoon: https://docs.efecte.com/internal-configuration-instructions/1812412-esa-custom-javascript-mappers
2. ESS:n määritys vaihe vaiheelta
Tietoa
ESS:ään ei luoda erillistä Whistleblower-vuokraajaa (tenant). ESS käsittelee Whistlebloweria itse asiassa tavallisena vuokraajana. Whistleblower-palvelutarjonnan määrittäminen onnistuu kirjautumalla tavalliseen vuokraajaan tavallisena ESS-pääkäyttäjänä.
- Siirry ESS-hallintasivustolle, esim. https://customer.efectecloud.com/scc/admin
- Valitse Sites-välilehti ja luo uusi sivusto. Lisää Organization Units -arvoksi DC=whistleblower . Tämä on erikoisarvo, jota käytetään erottamaan ESA:n kautta kirjautuvat käyttäjät.
Tuo Whistleblower-ratkaisun tarjous Report Misconduct ESS:ään report_misconduct_ess_services.yaml
Palvelut tiedostovalinnasta
Julkaise Report misconduct -tarjous yhteen Whistleblower -sivustoon
Kopioi Whistleblower-liitin (connector) asiakasympäristön integraatiokeskuksen (integration hub) konttiin connector-efecteWBR.xml
Luo tukikanava Support channels -välilehdeltä ja päivitä tilakartoitukset (status mappings)
Liitä tukikanava Whistleblower-palvelutarjontaan Report misconduct
Jos palvelut eivät näy Whistleblower-käyttäjälle, varmista, ettei niitä ole suojattu millään roolilla
ESS-tarkistuspiste: Kirjaudu ESS:ään anonyymillä kirjautumisella. Käyttäjä näkee vain Report misconduct -palvelun, ei mitään muuta. 
3. ESM:n määritys vaihe vaiheelta
- Siirry ESM:ään root-tason käyttäjänä, esim. https://customer.efectecloud.com/itsm
- Avaa Efecte Administration -alue (hammasratassymboli)
- Valitse Templates-välilehti ja Organization
- Valitse Import-vaihtoehto Template-pudotusvalikosta

- Tuo Whistleblower-mallipohjat (Whistleblower and Whistleblower
bundle): whistleblower_templateset.xml- Tarkista mallipohjaviittaukset
- Tarkista kielituki (jos muu kuin englanti)
- Luo Organization-moduulin alle kansio "Whistleblower reports" (koodi: whistleblower_reports)
- Tarkista, että sallitut mallipohjat ovat Whistleblower report ja Whistleblower report bundle.
- Tarkista, että vain Whistleblower reviewers -käyttäjillä on pääsy tähän kansioon

- Luo Organization-moduulin Personnel-kansion alle alikansio nimeltä Anonymous persons (koodi: anonymous_persons)
- Tarkista, että Person-mallipohja on valittu kansion sallituksi mallipohjaksi.
- Tarkista, että vain Whistleblower reviewers -käyttäjillä on pääsy tähän kansioon

- Luo rooli Whistleblower Reviewer
- Määritä 3 käyttäjää
-
Määritä 3 lisenssiä

- Tuo työnkulku (workflow) Whistleblower_report_workflow.xml
- Aseta työnkulun hälytysten vastaanottajat asiakkaan palautteen perusteella
- Määritä 6 Set value -solmua, jotka asettavat "Assigned to” -henkilöt ESS:ssä valitun Type of misconduct -arvon perusteella.
- Tallenna ja julkaise työnkulku

- Tuo kuuntelijat (listeners) wb_person_listener ja wbr_bundle_listener.xml

- Lisää alustan (platform) asetuksiin ominaisuus (property): anonymise.whistleblower_report. Lisää arvoihin vähintään seuraavat koodit: RequestedFor, misconduct_date, misconduct_description, misconduct_location, AdditionalInformation, misconduct_contact support_person, RequestAttachments, external_comments, internal_comments, resolution, misconduct_review_comments, OrderedBy.

- Poista valinta Whistleblower report -mallipohjan valintaruudusta "Record changes of data cards". Valitse sen sijaan Whistleblower report -mallipohjalle vaihtoehto "Log data card views".

- Luo kolme raporttia Whistleblower Reviewer -roolille.
- Ensimmäinen luotu raportti seuraa luotuja tapauksia:
- Nimi: New Whistleblower reports
- Asetukset: Näkyvissä "Whistleblower report" -tietokortit
- Ehdot: Status on "01 - New"
- Toisella raportilla tulee olla seuraavat asetukset
- Nimi: Whistleblower reports by Status
- Asetukset: Näkyvissä "Whistleblower report" -tietokortit
- Graafinen pylväskaavio, ryhmittely "Status"-kentän mukaan
-
Kolmannella raportilla tulee olla seuraavat asetukset
- Nimi: Whistleblower reports by Type
- Asetukset: Kaikki "Whistleblower report" -tietokortit
- Graafinen ympyrä -kaavio, ryhmittely "Type of misconduct" -kentän mukaan
- Ensimmäinen luotu raportti seuraa luotuja tapauksia:
-
Luo koontinäyttö (dashboard), johon sijoitetaan edellä mainitut kolme raporttia.

- ESM-tarkistuspiste: Kirjaudu sisään Misconduct issue handlers -käyttäjänä ja tarkista, että käyttäjä näkee vain misconduct-tapaukset. Myöskään muilla ESM-käyttäjillä ei ole pääsyä misconduct-tapauksiin. Root-käyttäjä näkee kaikki tietokortit, jotka on tallennettu samaan ESM:ään
4. Pakollinen käyttöönoton testiajo
Käyttöönoton testiajon tulee kattaa seuraavat vaiheet
- Kirjautuminen toimii anonyymillä kirjautumisella
- Luo Whistleblower-raportti
- Tarkista, että ESM:n työnkulun hälytystoiminnot toimivat
- Lähetä kommentti misconduct-tapauksen ilmoittajalle
- Vastaa kommenttiin ESS:ssä anonyyminä käyttäjänä
- Sulje tapaus ESM:ssä ja aseta ratkaisu (resolution)
- Kirjaudu ESS:ään ja tarkista, että ratkaisu näkyy misconduct-tapauksen ilmoittajalle
- Yritä kirjautua ESM:ään anonyymillä kirjautumisella – pääsyä ei pitäisi olla
- Tarkista, ettei ESS:ssä näy anonyymille käyttäjälle mitään muuta kuin Whistleblower-raportti
Lisätieto: Ei-aktiivisten käyttäjien poisto
Whistleblower-toiminnossa on sisäänrakennettu ominaisuus ei-aktiivisten käyttäjien poistamiseen. Se laskee päivien määrän kunkin käyttäjän viimeisimmästä kirjautumisajasta, ja jos se ylittää raja-arvon, käyttäjä poistetaan.
Oletuksena tämä prosessi tarkistaa tilanteen 8 tunnin välein ja käyttää enimmäisarvona 90 ei-aktiivista päivää.
Jos näitä asetuksia täytyy muuttaa, se onnistuu ESA:n /opt/keycloak/conf/keycloak.conf-määritystiedostossa.
Kohtaan <subsystem xmlns="urn:jboss:domain:keycloak-server:1.1"> on lisättävä seuraava osio:
Muista käynnistää ESA-kontti uudelleen tämän jälkeen!
Lisätieto: Evästekäytännön hyväksyntä
Kun 'whistleblower'-sivu näytetään ensimmäistä kertaa, käyttäjää pyydetään hyväksymään Efecten evästekäytäntö. Käyttäjä voi hyväksyä tai hylätä sen.
![]()
Käyttäjälle näytettävää viestiä voi muokata ESA:n hallintanäkymästä alla olevien kuvakaappausten mukaisesti (varmista ensin, että oikea realm on valittuna ESA-valitsimesta):


Table of Contents