Raynetin resurssi- ja ohjelmistotiedot M42 Professionalissa
Integration of Raynet One asset and software discovery data into M42 Professional, Core, and IGA via the Generic REST API connector.
Raynetin resurssi- ja ohjelmistotiedot M42 Professionalissa
Integration of Raynet One asset and software discovery data into M42 Professional, Core, and IGA via the Generic REST API connector.
Avoimet kohdat ennen julkaisua (älä poista ennen kuin ratkaistu)
Tämä luonnos koottiin kolmesta olemassa olevasta Helpjuice-artikkelista (Raynet Connector, Raynet – M42 Professional Demo Support Material, Generic REST API Connector). Seuraavia ei voitu vahvistaa näistä lähteistä, ja ne on merkitty tekstin sisään merkinnällä [TBD]:
- Arkkitehtuurikaavio, joka vastaisi SAM & SaaS Management -artikkelissa käytettyä kaaviota (lähdemateriaalissa ei ole vastaavaa Raynetille).
- Täydellinen, kenttäkohtainen kartoitustaulukko (Raynet-kenttä → M42 Pro -kenttä) laitteille ja asennetulle ohjelmistolle — lähteet nimeävät vain kaksi käytettyä Raynet-taulua ja yhden yksilöllisen avainkentän (
import_id), ei täydellistä attribuuttilistaa. - Kohde-M42-template/attribuutti, johon asennetun ohjelmiston tietueet kartoitetaan (SAM käyttää "Software Version" -attribuuttia — ei vahvistettu Raynetille).
- Tarjoaako Raynet SaaS-/pilvisovellustietoaineiston, joka olisi verrattavissa siihen, mitä M42 SaaS Management tarjoaa M42 SAMin kautta (lähdemateriaalissa ei ole tästä näyttöä — oletetaan rajauksen ulkopuolelle).
- Onko integraatio vahvistetusti vain yksisuuntainen (Raynet → M42) — lähteistä ei löytynyt takaisinkirjoitus (write-back) -käyttötapausta, mutta tämä tulisi varmistaa.
- Miten Raynet-API-avain luodaan/hankitaan (ei kuvattu lähdemateriaalissa).
- Lopullinen artikkelin otsikko ja pitäisikö sen myös listata "Matrix42 Enterprise and SAM Connector" rinnakkaisena artikkelina yhdenmukaisuuden vuoksi.
Yleiskatsaus
Raynet One on kolmannen osapuolen IT-omaisuudenhallinta (ITAM) -alusta, joka löytää ja luetteloi laitteet ja niihin asennetun ohjelmiston. Asiakkaat, jotka jo käyttävät Raynet Onea resurssien tunnistamiseen, voivat tuoda kyseisen datan M42 Professionaliin (M42 Pro), M42 Coreen ja M42 IGA:han käyttämällä alustan sisäänrakennettua Generic REST API -konnektoria — erillistä asennusta ei tarvita.
Sen sijaan, että laite- ja ohjelmistoluetteloita ylläpidettäisiin manuaalisesti, ajastettu konnektoritehtävä lukee datan suoraan Raynetin API:sta ja pitää vastaavat tietueet M42:ssa automaattisesti ajan tasalla. Tuloksena on elävä, tarkka Configuration Management Database (CMDB), joka antaa incident-, change- ja problem-hallinnalle niiden tarvitseman omaisuuskontekstin toimiakseen tehokkaasti — sama lopputulos, jonka M42 SAM & SaaS Management -integraatio tarjoaa, mutta datan lähteenä Raynet M42 SAMin sijaan.
Edellytykset
Integraation toimiminen edellyttää seuraavaa:
- Aktiivinen Raynet One -tilaus/tenantti, jossa on tunnistettua laitedataa (ja valinnaisesti laitekohtaista ohjelmistodataa), saavutettavissa osoitteessa
https://<your-tenant>.raynetone.com/v1/resultDatabase. - Raynet-API-avain todennukseen (lähetetään
ApiKey-otsikkona). [TBD: miten tämä avain luodaan/hankitaan Raynetissä]. - Määritetty M42 Professional-, Core- tai IGA -ympäristö, jossa on pääsy Connector Management (EPE) -hallintakonsoliin, versiolla, joka tukee Generic REST API Connector -ajastettuja tehtäviä (otettu käyttöön 2025.3-julkaisussa).
- Raynetin SSL-juurivarmenne (tyypillisesti "ISRG Root X1") lisättynä luotettuna varmenteena Connector Managementiin (EPE). Tämän vaiheen voi tehdä vain Matrix42.
- M42:een määritetty WebAPI-käyttäjä, jota konnektori käyttää kirjoittaessaan haetun datan M42 Coreen, Prohon ja IGA:han.
Miten integraatio toimii
Arkkitehtuuri
[TBD: lähdemateriaalista ei löytynyt arkkitehtuurikaaviota tälle integraatiolle. Lisää tähän kaavio, samantyyppinen kuin M42 SAM & SaaS Management -artikkelissa, kun se on saatavilla.]
Synkronointiprosessi
Jokainen synkronointiajo noudattaa yhdenmukaista sekvenssiä:
- Pääkäyttäjä määrittää Generic REST API -konnektorin M42:n Connector Managementissa (EPE) osoittamaan asiakkaan Raynet One -tenanttiin (host-URL,
ApiKey-otsikkotodennus ja sivutuspohjaiset asetukset RaynetinresultDatabase-API:lle). - Konnektorin alle luodaan ajastettu tehtävä kutakin synkronoitavaa Raynet-tietoainestoa varten — esimerkiksi tehtävä, joka kyselee
resultTable/paged?tableName=DataTransformation-result_deviceslaitteiden hakemiseksi. - Jokainen tehtävä kartoittaa kentät Raynetin JSON-vastauksesta kohde-M42-templateen (esimerkiksi Device) JSONPath-tyylisillä attribuuttikartoituksilla, ja yksilöllistä attribuuttia (esimerkiksi
import_id) käytetään olemassa olevien tietueiden täsmäyttämiseen ja päivittämiseen kaksoiskappaleiden luomisen sijaan. - Määritetyn aikataulun mukaan tai manuaalisesti käynnistettynä tehtävä kutsuu Raynet-API:a — käyden läpi tulossivut — ja luo tai päivittää vastaavat datakortit M42 Coressa, Prossa ja IGA:ssa.
- Liittyvä data, kuten laitteeseen asennettu ohjelmisto, voidaan hakea samassa tehtävässä alikyselyllä, joka suodatetaan ylätason tietueen mukaan (esimerkiksi
Catalog_v2_SoftwareOnDeviceMatchingsuodatettunaComputerId:n mukaan) ja kartoittaa laitteen tietueeseen. 2025.3-julkaisusta lähtien vain yksi alikyselytaso on tuettu per ajastettu tehtävä.
Yksisuuntainen synkronointi
Data virtaa Raynet Onesta M42 Coreen, Prohon ja IGA:han vain yhteen suuntaan. M42:ssa tehtyjä muutoksia ei kirjoiteta takaisin Raynetiin. [TBD: vahvista tämä — lähdemateriaalissa ei dokumentoitu takaisinkirjoitus-skenaariota.]
Mikä data synkronoidaan
Toisin kuin dedikoitu M42 SAM -konnektori, Raynet-integraatio perustuu yleiskäyttöiseen Generic REST API -konnektoriin: se, mitkä Raynet-taulut luetaan ja tarkalleen miten niiden kentät kartoittuvat M42-attribuutteihin, määritetään asiakaskohtaisesti käyttöönoton yhteydessä, ei toimiteta kiinteänä oletuksena. Kaksi yleisintä dokumentoitua Raynetin käyttötapausta on kuvattu alla.
Laitteet
Raynetin löytämät laitteistolaitteet (taulusta DataTransformation-result_devices) synkronoidaan Device-tietueiksi M42:ssa — tyypillisesti Asset/Servers-tyyppiseen kansioon. Tämä pitää CMDB:n täytettynä Raynetistä peräisin olevalla laitedatalla ja mahdollistaa Device-tietueiden linkittämisen suoraan incidentteihin, muutoksiin ja problem-tietueisiin välitöntä laitteistokontekstia varten.
| Raynet Field | M42 Field |
| import_id (yksilöllinen attribuutti) | Name (tai templaten määritetty yksilöllinen attribuutti) |
| device_manufacturer (käytetään suodatusesimerkeissä) | [TBD] |
| [TBD — jäljellä olevat kentät eivät ole listattuna lähdemateriaalissa] | [TBD] |
Laitteisiin asennettu ohjelmisto
Kun Raynet-ympäristössä on myös Catalog_v2_SoftwareOnDeviceMatching-taulu, kuhunkin laitteeseen asennettu ohjelmisto voidaan hakea alikyselyllä (suodatettuna laitteen ComputerId:n mukaan) ja linkittää vastaavaan Device-tietueeseen M42:ssa. [TBD: vahvista kohde-M42-template/attribuutti, johon tämä kartoitetaan — esimerkiksi, päätyykö se "Software Version" -tietueeseen kuten M42 SAM -integraatiossa, vai monikkoarvoisena attribuuttina suoraan Device-tietueeseen.]
SaaS-sovellukset
[TBD: näyttöä ei löytynyt siitä, että Raynet tarjoaisi SaaS-/pilvisovellustietoaineiston, joka olisi verrattavissa siihen, mitä M42 SaaS Management tarjoaa M42 SAMin kautta. Jos Raynet tarjoaa tämän, lisää tähän osio, joka vastaa M42 SAM & SaaS Management -artikkelin "SaaS Applications" -osiota.]
Suodatus
Raynet-API tukee suodatusta, jota voidaan käyttää ajastetun tehtävän kyselyssä palautettavien tietueiden rajaamiseen — esimerkiksi vain tietyn valmistajan laitteet. Suodatinarvot on URL-koodattava. Katso suodatinsyntaksi Raynet 2025.3 -julkaisutiedotteesta.
Keskeiset hyödyt
Rikkaampi ITSM-konteksti
Kun incident nostetaan, Raynetistä synkronoitu laite- ja ohjelmistokonteksti on jo saatavilla. Esimerkiksi kun käyttäjä ilmoittaa ohjelmisto-ongelmasta itsepalveluportaalin tai AI Knowledge Discovery -chatbotin kautta, hänen laitteensa ja asennettu ohjelmistonsa voidaan esitäyttää Raynet-datasta, ja GenAI voi rikastaa syntyvää tikettiä laitteisto- ja ohjelmistotiedoilla agenttia varten — vähentäen edestakaista viestintää ja nopeuttaen triagea.
Nopeampi, matalamman riskin muutossuunnittelu
Koska laitteet on linkitetty konfiguraatioyksiköihin ja liiketoimintasovelluksiin Raynet-synkronoidun datan kautta, CMDB näyttää täsmälleen, mitkä laitteet, palvelut ja käyttäjät suunniteltu muutos koskee. Yhdistettynä M42:n Visual Analyzer- ja GenAI-ominaisuuksiin, tämä tukee vaikutusanalyysien, CAB-perustelujen yhteenvetojen, testisuunnitelmien ja peruutusohjeiden luomista rakenteellisesta, ajantasaisesta omaisuusdatasta manuaalisten hakujen sijaan.
Parempi näkyvyys, automaatio ja vaatimustenmukaisuus
- Parempi näkyvyys ja hallinta – Lähes reaaliaikainen pääsy Raynetin laite- ja ohjelmistodataan parantaa IT:n valvontaa, resurssien seurantaa ja päätöksentekoa.
- Automaatio ja tehokkuus – Automatisoitu, ajastettu synkronointi vähentää manuaalista työtä ja nopeuttaa prosesseja kuten perehdytystä ja CMDB-päivityksiä.
- Parempi tietoturva ja vaatimustenmukaisuus – Vanhentuneen tai luvattoman ohjelmiston nopeampi havaitseminen tukee vahvempaa tietoturva-asentoa ja säädöstenmukaisuutta.
- Strateginen integraatio ja innovaatio – Saumaton integraatio Raynetin ja M42:n välillä mahdollistaa älykkäämmän automaation, paremman hallinnan ja tukee laajempia digitaalisen transformaation pyrkimyksiä.
Tunnetut rajoitukset
2025.3-julkaisusta lähtien: useamman kuin yhden alikyselytason käyttö per ajastettu tehtävä ei ole tuettua suorituskykysyistä.
Aiheeseen liittyvä dokumentaatio
- Raynet Connector — vaiheittainen tekninen määritysopas.
- Generic REST API Connector — alustan dokumentaatio taustalla olevasta konnektorista.
- M42 SAM & SaaS Management in M42 Professional — vastaava integraatio, jonka data tulee M42 SAMista.
Table of Contents