Contenu
L'API publique de NinjaRMM utilise OAuth2 pour authentifier les demandes. OAuth 2.0 permet aux applications d'accéder aux ressources de NinjaRMM (telles que les informations de surveillance) mises à disposition via l'API.
Environnement
API NinjaOne
Description
À propos
Pour commencer à utiliser le protocole OAuth pour l'authentification de votre application avec NinjaOne, vous devez d'abord disposer d'un identifiant OAuth du système NinjaOne. L'application OAuth mettra en place une autorisation pour vous. OAuth 2.0 prend en charge différents types de subventions. Toutefois, l'API publique de NinjaOne prend en charge les éléments suivants code d'autorisation et implicite implicites.
Retrouvez vos paramètres API sous Administration → Apps → API.
Générer une application client OAuth
- Dans la page API de NinjaOne, ouvrez l'onglet Client app IDs et cliquez sur Add client app.
Image 1 : Ajouter une nouvelle configuration d'application client dans NinjaOne
- Sélectionnez une option dans la liste déroulante Plate-forme d'application pour générer davantage de champs de données.
- Utilisez le tableau suivant pour vous aider à remplir les champs applicables.
| Champ | Description |
|---|---|
| Nom | Saisissez le titre qui sera affiché comme nom de l'application client dans l'écran de consentement. Ce nom sera affiché dans la section Administration → Apps → API → OAuth Tokens dans NinjaOne. |
| Redirection d'URL | Entrez une ou plusieurs URL où NinjaOne enverra les réponses OAuth. Ceci n'est pas configurable lorsque l'on utilise la plateforme d'applications natives. Il s'agit d'utiliser un hôte local. |
| Périmètres | Cela permet d'accéder à toutes les ressources API publiques d'un certain type : Suivi, gestion et contrôle. Activez la case à cocher à côté du type pour l'activer.
|
| Types d'autorisation permis | Les types de subventions OAuth 2.0 sont utilisés pour l'application cliente agissant au nom d'un utilisateur. Pour minimiser les risques de sécurité, limitez les types de subventions autorisées au code d'autorisation, au jeton de rafraîchissement et à l'autorisation implicite.
|
Une fois la configuration terminée, cliquez sur Save en haut de la page. Vous verrez votre identifiant client, que vous pouvez copier et utiliser lorsque l'application interagit avec NinjaOne.
Pour modifier ou supprimer un identifiant d'application client, déplacez votre curseur sur la ligne et sélectionnez l'option appropriée sur le côté droit de la page.
Image 3 : Modifier ou supprimer la configuration d'une application client dans NinjaOne