Et API for verktøyene dine. En MCP-server for AI-en din.
Customer API dekker enheter, lokal administrator, runbooks, appbutikken og oppsettet av tenanten, med OpenAPI-dokumentasjon du kan prøve rett i nettleseren. MCP-serveren gir AI-assistenter lesetilgang til enhetsparken din. Og PowerShell-modulen skripter onboardingen.
- OpenAPI med interaktiv dokumentasjon
- MCP-server med seks verktøy
- PowerShell-modul
- Runbooks med åpen kildekode
# 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
Et REST-API per tenant, autentisert med tenant-ID-en din og en API-hemmelighet. Hvert område slås på separat, slik at en helpdeskintegrasjon får LAPS og ingenting annet.
OpenAPI og Scalar
Spesifikasjonen på
/openapi/v1.json, en interaktiv referanse på/scalar/v1.Scopes per tenant
Åtte API-områder pluss MCP-serveren, hvert av dem slås på for seg.
Anropsgrenser
Enhetsanrop på 30 og MCP på 60 forespørsler per minutt per tenant.
Revisjon
Anrop som endrer noe, logges til arbeidsområdet ditt på samme måte som handlinger i portalen.Les dokumentasjonen · Åpne API-referansen
Endepunkter
De kundevendte rutene, gruppert etter område. Filtrer for å se ett enkelt område.
| Rute | Hva den gjør |
|---|---|
| GET/device/list | Enheter med primære og sekundære brukere og når de sist ble sett. |
| GET/device/{id}/state | Fullstendig enhetsstatus via RealmJoin-, Entra- eller Intune-ID, eller bare de banene du ber om. |
| POST/laps/request | Be om en supportkonto, returnerer tiden til enhetens neste innsjekking. |
| POST/laps/retrieve | Hent supportkontoens passord når det er deponert. |
| POST/runbook/{runbookName}/run | Kjør en runbook og vent på resultatet, for jobber på inntil en time. |
| POST/runbook/{runbookName}/start | Start en runbook i bakgrunnen og få en jobb-ID. |
| GET/runbook/jobs/{jobID}/status | Status for en jobb. |
| GET/runbook/jobs/{jobID}/output/text | Utdata som tekst. |
| GET/runbook/jobs/{jobID}/output/streams | Alle utdatastrømmer. |
| GET/runbook/jobs/{jobID}/exception/text | Unntaksteksten for en mislykket jobb. |
| GET/store/apps | Søk og bla i Package Store. |
| GET/store/apps/{id} | Én pakke med detaljene sine. |
| GET/store/subscribed | Pakkene du abonnerer på. |
| POST/store/subscribed | Abonner på en pakke via Intune eller RealmJoin, med automatisering, utsettelse, nattvindu og tidssone. |
| GET/store/subscribed/{id} | Ett abonnement. |
| GET/store/subscribed/status/{id} | Fremdrift for en abonnementsoperasjon. |
| POST/tenant/connect | Skriptet onboarding med en engangstoken. |
| POST/tenant/logingestion-config | Koble til Log Analytics-arbeidsområdet ditt. |
| POST/tenant/runbooks-config | Koble til Azure Automation-kontoen din. |
| GET/tenant/stats | Aktive og totale antall enheter, brukere og pakker. |
Partner- og visningsintegrasjoner har noen flere ruter, se API-referansen.
Spør enhetsparken din
Den innebygde MCP-serveren lar AI-assistenter som snakker Model Context Protocol slå opp ting i RealmJoin: statusen til en enhet, en maskin etter navn, spredningen av en pakke over enhetsparken. Tokener er navngitte, utløper, kan trekkes tilbake når som helst og viser når de sist ble brukt.
Seks verktøy med kun lesetilgang
PowerShell-modulen for RealmJoin
For tenanter som vil gi hver enkelt tillatelse for hånd, eller partnere som onboarder mange tenanter, tar modulen på PowerShell Gallery seg av oppsettet: onboarding med en token fra portalen, tilkobling av Log Analytics og Azure Automation.
Install-Module RealmJoin
Complete-RJTenantOnboarding -Token <token>
Set-RJLogAnalyticsWorkspace
Set-RJAutomationAccountLoggtabeller for KQL og Sentinel
RealmJoin skriver til arbeidsområdet ditt gjennom Logs Ingestion API med en datainnsamlingsregel, uten delte nøkler. Tre egne tabeller holder på det som har skjedd:
- RJAuditLogs_CL
- Hvem som endret hva
- RJOperationalLogs_CL
- Hva RealmJoin gjorde
- RJRunbookLogs_CL
- Hver runbookjobb
Åpen kildekode, der det hjelper deg
Delene du vil lese, bygge videre på eller gjenbruke er offentlige på GitHub.
Runbookbibliotek
175 runbooks for brukere, grupper, enheter og organisasjonen.
Utbedringsskript
Gjenkjennings- og utbedringsskript for Intune, synkronisert inn i portalen.
Hjelpemodul for runbooks
PowerShell-modulen bak
Use-RJInterfaceog slektningene dens.Dine egne runbooks
Et utgangspunkt for kundespesifikke runbooks.
Tilpassede pakker
Et startpunkt for å bygge dine egne pakker.
.NET-biblioteker
Lette klienter for Microsoft Graph og Azure, og Blazor-komponenter.
Koble RealmJoin til resten av stacken din.
ITSM-en din, SIEM-en din, AI-assistenten din. Start med en tenant og en API-hemmelighet.