Une API pour vos outils. Un serveur MCP pour votre IA.
La Customer API couvre les appareils, les comptes administrateur locaux, les runbooks, l'app store et la configuration du tenant, avec une documentation OpenAPI que vous pouvez essayer dans le navigateur. Le serveur MCP donne aux assistants IA un accès en lecture seule à votre parc. Et le module PowerShell scripte l'onboarding.
- OpenAPI avec documentation interactive
- Serveur MCP avec six outils
- Module PowerShell
- Runbooks open source
# 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_…" } } }}
La Customer API
Une API REST par tenant, authentifiée avec votre ID de tenant et un secret d'API. Chaque domaine s'active séparément, de sorte qu'une intégration helpdesk accède à LAPS et à rien d'autre.
OpenAPI et Scalar
La spécification sous
/openapi/v1.json, une référence interactive sous/scalar/v1.Scopes par tenant
Huit domaines d'API plus le serveur MCP, chacun activé séparément.
Limites de débit
Les endpoints d'appareils à 30 et MCP à 60 requêtes par minute et par tenant.
Audit
Les appels qui modifient quelque chose sont consignés dans votre workspace, comme les actions du portail.Lire la documentation · Ouvrir la référence de l'API
Endpoints
Les routes exposées aux clients, regroupées par domaine. Filtrez pour n'en voir qu'un.
| Route | Ce qu'elle fait |
|---|---|
| GET/device/list | Les appareils avec leurs utilisateurs principal et secondaires et leur dernier contact. |
| GET/device/{id}/state | L'état complet d'un appareil par ID RealmJoin, Entra ou Intune, ou seulement les chemins que vous demandez. |
| POST/laps/request | Demande un compte de support ; renvoie le temps jusqu'au prochain check-in de l'appareil. |
| POST/laps/retrieve | Récupère le mot de passe du compte de support une fois celui-ci mis sous séquestre. |
| POST/runbook/{runbookName}/run | Exécute un runbook et attend le résultat, pour des jobs allant jusqu'à une heure. |
| POST/runbook/{runbookName}/start | Démarre un runbook en arrière-plan et renvoie un ID de job. |
| GET/runbook/jobs/{jobID}/status | Le statut d'un job. |
| GET/runbook/jobs/{jobID}/output/text | La sortie en texte. |
| GET/runbook/jobs/{jobID}/output/streams | Tous les flux de sortie. |
| GET/runbook/jobs/{jobID}/exception/text | Le texte d'exception d'un job en échec. |
| GET/store/apps | Recherche et pagination dans le Package Store. |
| GET/store/apps/{id} | Un package avec ses détails. |
| GET/store/subscribed | Les packages auxquels vous êtes abonné. |
| POST/store/subscribed | Abonne un package via Intune ou RealmJoin, avec automatisation, report, fenêtre nocturne et fuseau horaire. |
| GET/store/subscribed/{id} | Un abonnement. |
| GET/store/subscribed/status/{id} | La progression d'une opération d'abonnement. |
| POST/tenant/connect | Onboarding scripté avec un token à usage unique. |
| POST/tenant/logingestion-config | Connecte votre workspace Log Analytics. |
| POST/tenant/runbooks-config | Connecte votre compte Azure Automation. |
| GET/tenant/stats | Le nombre d'appareils, d'utilisateurs et de packages, actifs et au total. |
Les intégrations partenaires et d'affichage disposent de quelques routes supplémentaires ; voir la référence de l'API.
Interrogez votre parc
Le serveur MCP intégré permet aux assistants IA qui parlent le Model Context Protocol de consulter RealmJoin : l'état d'un appareil, une machine par son nom, la diffusion d'un package dans le parc. Les tokens sont nommés, expirent, peuvent être révoqués à tout moment et indiquent leur dernière utilisation.
Six outils en lecture seule
Le module PowerShell RealmJoin
Install-Module RealmJoin
Complete-RJTenantOnboarding -Token <token>
Set-RJLogAnalyticsWorkspace
Set-RJAutomationAccountDes tables de logs pour KQL et Sentinel
- RJAuditLogs_CL
- Qui a changé quoi
- RJOperationalLogs_CL
- Ce que RealmJoin a fait
- RJRunbookLogs_CL
- Chaque job de runbook
Open source, là où cela vous est utile
Les parties que vous voudriez lire, étendre ou réutiliser sont publiques sur GitHub.
Bibliothèque de runbooks
175 runbooks pour les utilisateurs, les groupes, les appareils et l'organisation.
Scripts de remédiation
Scripts Intune de détection et de remédiation, synchronisés dans le portail.
Module d'assistance pour runbooks
Le module PowerShell derrière
Use-RJInterfaceet consorts.Vos propres runbooks
Un point de départ pour des runbooks spécifiques au client.
Packages personnalisés
Une base de départ pour construire vos propres packages.
Bibliothèques .NET
Des clients légers pour Microsoft Graph et Azure, et des composants Blazor.
Connectez RealmJoin au reste de votre stack.
Votre ITSM, votre SIEM, votre assistant IA. Commencez avec un tenant et un secret d'API.