LAUSNIR

API fyrir verkfærin þín. MCP-þjónn fyrir gervigreindina þína.

Customer API nær yfir tæki, staðbundna stjórnendur, runbook-skriftur, forritaverslunina og uppsetningu tenants, með OpenAPI-skjölum sem þú getur prófað í vafranum. MCP-þjónninn veitir gervigreindaraðstoðarmönnum lesaðgang að tækjaflotanum þínum. Og með PowerShell-einingunni keyrirðu innleiðinguna úr skriftu.

  • OpenAPI með gagnvirkum skjölum
  • MCP-þjónn með sex verkfærum
  • PowerShell-eining
  • Runbook-skriftur í opnum hugbúnaði
customer-api.realmjoin.com
# Device state, Intune part onlycurl -u "t-<tenant-id>:<api-secret>" \  "https://customer-api.realmjoin.com/device/<device-id>/state?path=Intune"# Request a support account for helpdeskcurl -u "t-<tenant-id>:<api-secret>" -X POST \  "https://customer-api.realmjoin.com/laps/request"

Customer API

REST-API fyrir hvern tenant, auðkennt með tenant-auðkenninu þínu og API-leynilykli. Kveikt er á hverju sviði fyrir sig, svo samþætting við þjónustuborðið fær LAPS og ekkert annað.

  • OpenAPI og Scalar

    Skilgreiningin á /openapi/v1.json, gagnvirkt uppflettirit á /scalar/v1.

  • Umfang fyrir hvern tenant

    Átta API-svið auk MCP-þjónsins, kveikt á hverju fyrir sig.

  • Tíðnimörk

    Tækjaendapunktar á 30 og MCP á 60 beiðnir á mínútu fyrir hvern tenant.

  • Úttekt

    Köll sem breyta einhverju eru skráð í vinnusvæðið þitt rétt eins og aðgerðir í gáttinni.Lestu skjölin · Opnaðu uppflettiritið fyrir API

Endapunktar

Slóðirnar sem snúa að viðskiptavinum, flokkaðar eftir sviðum. Síaðu til að sjá eitt svið.

SlóðHvað hún gerir
GET/device/listTæki með aðalnotendum og aukanotendum og hvenær þau sáust síðast.
GET/device/{id}/stateÖll staða tækis eftir auðkenni í RealmJoin, Entra eða Intune, eða aðeins þær slóðir sem þú biður um.
POST/laps/requestBiður um stuðningsaðgang og skilar tímanum þar til tækið tilkynnir sig næst.
POST/laps/retrieveSækir lykilorð stuðningsaðgangsins þegar það hefur verið varðveitt.
POST/runbook/{runbookName}/runKeyrir runbook-skriftu og bíður eftir niðurstöðunni, fyrir verk sem taka allt að klukkustund.
POST/runbook/{runbookName}/startRæsir runbook-skriftu í bakgrunni og skilar auðkenni verks.
GET/runbook/jobs/{jobID}/statusStaða verks.
GET/runbook/jobs/{jobID}/output/textÚttak sem texti.
GET/runbook/jobs/{jobID}/output/streamsAllir úttaksstraumar.
GET/runbook/jobs/{jobID}/exception/textVillutexti verks sem mistókst.
GET/store/appsLeitar og flettir í gegnum Package Store.
GET/store/apps/{id}Einn pakki með öllum upplýsingum sínum.
GET/store/subscribedPakkarnir sem þú ert áskrifandi að.
POST/store/subscribedSkráir áskrift að pakka um Intune eða RealmJoin, með sjálfvirkni, frestun, næturglugga og tímabelti.
GET/store/subscribed/{id}Ein áskrift.
GET/store/subscribed/status/{id}Framgangur áskriftaraðgerðar.
POST/tenant/connectInnleiðing úr skriftu með einnota lykli.
POST/tenant/logingestion-configTengir Log Analytics-vinnusvæðið þitt.
POST/tenant/runbooks-configTengir Azure Automation-reikninginn þinn.
GET/tenant/statsFjöldi virkra tækja, notenda og pakka og heildarfjöldi þeirra.

Samþættingar fyrir samstarfsaðila og skjái hafa nokkrar slóðir til viðbótar; sjá uppflettiritið fyrir API.

Spurðu tækjaflotann

Innbyggði MCP-þjónninn gerir gervigreindaraðstoðarmönnum sem tala Model Context Protocol kleift að fletta upp í RealmJoin: stöðu tækis, vél eftir nafni, útbreiðslu pakka um tækjaflotann. Lyklarnir bera nöfn, renna út, má afturkalla hvenær sem er og sýna hvenær þeir voru síðast notaðir.

Samtal til skýringar. Lyklar eru búnir til í Stillingum, MCP Access.

Sex verkfæri sem aðeins lesa

VerkfæriSvarar
get_device_stateStaða eins tækis eftir auðkenni í RealmJoin, Entra eða Intune, í samantekt eða eftir slóð.
get_device_by_nameFinnur tæki eftir vélarheiti.
search_devicesHlutar úr vélarheitum eða forskeyti auðkenna.
get_tenant_overviewTenantinn í einni sýn.
get_software_reportUppsetningar og útgáfur eins pakka, til dæmis generic-7zip.
list_packagesAuðkenni pakka, síuð ef vill.

PowerShell-eining RealmJoin

Fyrir tenanta sem vilja veita hverja heimild handvirkt, eða samstarfsaðila sem taka inn marga tenanta, sér einingin á PowerShell Gallery um uppsetninguna: innleiðingu með lykli úr gáttinni og tengingu við Log Analytics og Azure Automation.

Install-Module RealmJoin
Complete-RJTenantOnboarding -Token <token>
Set-RJLogAnalyticsWorkspace
Set-RJAutomationAccount

Skrártöflur fyrir KQL og Sentinel

RealmJoin skrifar í vinnusvæðið þitt gegnum Logs Ingestion API með gagnasöfnunarreglu, án sameiginlegra lykla. Þrjár sérsniðnar töflur geyma það sem gerðist:

RJAuditLogs_CL
Hver breytti hverju
RJOperationalLogs_CL
Hvað RealmJoin gerði
RJRunbookLogs_CL
Hvert runbook-verk

Opinn hugbúnaður þar sem hann gagnast þér

Þeir hlutar sem þú vilt lesa, bæta við eða endurnýta eru opnir á GitHub.

Tengdu RealmJoin við restina af tæknistaflanum þínum.

ITSM-kerfið þitt, SIEM-kerfið þitt, gervigreindaraðstoðarmaðurinn þinn. Byrjaðu á tenant og API-leynilykli.