API työkaluillesi. MCP-palvelin tekoälyllesi.
Customer API kattaa laitteet, paikalliset ylläpitäjätilit, runbookit, sovelluskaupan ja tenantin käyttöönoton, ja OpenAPI-dokumentaatiota voi kokeilla suoraan selaimessa. MCP-palvelin antaa tekoälyavustajille lukuoikeuden laitekantaasi. PowerShell-moduuli puolestaan skriptaa käyttöönoton.
- OpenAPI ja interaktiivinen dokumentaatio
- MCP-palvelin ja kuusi työkalua
- PowerShell-moduuli
- Avoimen lähdekoodin runbookit
# 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"
# User name t-<tenant-id>, password = API secret$cred = Get-CredentialInvoke-RestMethod -Authentication Basic -Credential $cred ` -Uri "https://customer-api.realmjoin.com/device/list"Invoke-RestMethod -Authentication Basic -Credential $cred ` -Uri "https://customer-api.realmjoin.com/tenant/stats"
// Example client configuration; the exact format depends on your client{ "mcpServers": { "realmjoin": { "url": "https://customer-api.realmjoin.com/mcp", "headers": { "Authorization": "Bearer rjm_…" } } }}
Customer API
REST-rajapinta tenanttia kohden, tunnistautuminen tenant-tunnuksella ja API-salaisuudella. Jokainen osa-alue kytketään päälle erikseen, joten helpdesk-integraatio saa LAPS:n eikä mitään muuta.
OpenAPI ja Scalar
Määrittely osoitteessa
/openapi/v1.json, interaktiivinen referenssi osoitteessa/scalar/v1.Scopet tenanttikohtaisesti
Kahdeksan API-aluetta sekä MCP-palvelin, jokainen kytketään päälle erikseen.
Kutsurajat
Laitepäätepisteet 30 ja MCP 60 kutsua minuutissa tenanttia kohden.
Auditointi
Kutsut, jotka muuttavat jotakin, kirjataan työtilaasi samalla tavalla kuin portaalissa tehdyt toimet.Lue dokumentaatio · Avaa API-referenssi
Päätepisteet
Asiakkaille tarkoitetut reitit alueittain ryhmiteltyinä. Suodata, jos haluat nähdä yhden alueen.
| Reitti | Mitä se tekee |
|---|---|
| GET/device/list | Laitteet ensisijaisine ja toissijaisine käyttäjineen sekä tieto siitä, milloin ne nähtiin viimeksi. |
| GET/device/{id}/state | Laitteen koko tila RealmJoin-, Entra- tai Intune-tunnuksella, tai vain ne polut, jotka pyydät. |
| POST/laps/request | Pyydä tukitili, jolloin vastaus kertoo, kuinka kauan laitteen seuraavaan yhteydenottoon on aikaa. |
| POST/laps/retrieve | Hae tukitilin salasana, kun se on talletettu. |
| POST/runbook/{runbookName}/run | Aja runbook ja odota tulosta, enintään tunnin mittaisille töille. |
| POST/runbook/{runbookName}/start | Käynnistä runbook taustalla ja saa työn tunnus. |
| GET/runbook/jobs/{jobID}/status | Työn tila. |
| GET/runbook/jobs/{jobID}/output/text | Tuloste tekstinä. |
| GET/runbook/jobs/{jobID}/output/streams | Kaikki tulostevirrat. |
| GET/runbook/jobs/{jobID}/exception/text | Epäonnistuneen työn poikkeusteksti. |
| GET/store/apps | Hae ja selaa Package Storea. |
| GET/store/apps/{id} | Yksi paketti tietoineen. |
| GET/store/subscribed | Tilaamasi paketit. |
| POST/store/subscribed | Tilaa paketti Intunen tai RealmJoinin kautta, mukaan lukien automaatio, lykkäys, yöikkuna ja aikavyöhyke. |
| GET/store/subscribed/{id} | Yksi tilaus. |
| GET/store/subscribed/status/{id} | Tilaustoiminnon edistyminen. |
| POST/tenant/connect | Skriptattu käyttöönotto kertakäyttöisellä tunnuksella. |
| POST/tenant/logingestion-config | Yhdistä Log Analytics -työtilasi. |
| POST/tenant/runbooks-config | Yhdistä Azure Automation -tilisi. |
| GET/tenant/stats | Aktiivisten ja kaikkien laitteiden, käyttäjien ja pakettien määrät. |
Kumppani- ja näyttöintegraatioilla on muutama reitti lisää, katso API-referenssi.
Kysy laitekannaltasi
Sisäänrakennettu MCP-palvelin antaa Model Context Protocolia puhuville tekoälyavustajille mahdollisuuden hakea tietoja RealmJoinista: laitteen tila, kone nimen perusteella, paketin levinneisyys laitekannassa. Tokenit ovat nimettyjä, ne vanhenevat, ne voi peruuttaa milloin tahansa ja niistä näkyy, milloin niitä on viimeksi käytetty.
Kuusi työkalua, joilla on vain lukuoikeus
RealmJoinin PowerShell-moduuli
Tenanteille, jotka haluavat myöntää jokaisen oikeuden käsin, ja kumppaneille, jotka ottavat käyttöön useita tenantteja, PowerShell Galleryn moduuli hoitaa asennuksen: käyttöönotto portaalista saadulla tokenilla sekä Log Analyticsin ja Azure Automationin yhdistäminen.
Install-Module RealmJoin
Complete-RJTenantOnboarding -Token <token>
Set-RJLogAnalyticsWorkspace
Set-RJAutomationAccountLokitaulut KQL:ää ja Sentineliä varten
RealmJoin kirjoittaa työtilaasi Logs Ingestion API:n kautta tiedonkeruusäännöllä, ilman jaettuja avaimia. Kolme omaa taulua sisältää tapahtuneen:
- RJAuditLogs_CL
- Kuka muutti mitä
- RJOperationalLogs_CL
- Mitä RealmJoin teki
- RJRunbookLogs_CL
- Jokainen runbook-työ
Avointa lähdekoodia siellä, missä siitä on sinulle hyötyä
Ne osat, joita haluat lukea, laajentaa tai käyttää uudelleen, ovat julkisesti GitHubissa.
Runbook-kirjasto
175 runbookia käyttäjille, ryhmille, laitteille ja organisaatiolle.
Korjausskriptit
Intunen tunnistus- ja korjausskriptit, synkronoituina portaaliin.
Runbookien apumoduuli
PowerShell-moduuli komennon
Use-RJInterfaceja sen sukulaisten taustalla.Omat runbookisi
Lähtökohta asiakaskohtaisille runbookeille.
Omat paketit
Aloituspohja omien pakettien rakentamiseen.
.NET-kirjastot
Kevyet asiakaskirjastot Microsoft Graphille ja Azurelle sekä Blazor-komponentit.
Yhdistä RealmJoin muuhun ympäristöösi.
ITSM-järjestelmäsi, SIEM-järjestelmäsi, tekoälyavustajasi. Aloita tenantista ja API-salaisuudesta.