Vous êtes déjà client NinjaOne ? Connectez-vous pour consulter d'autres guides et les dernières nouvelles.

Configuration du jeton OAuth d’API

  • Dernière mise à jour 10 août 2026

Sujet

Cet article explique comment utiliser OAuth 2.0 pour authentifier les requêtes adressées à l'API publique NinjaOne.

Environnement

API publique NinjaOne

Description

L'API publique NinjaOne utilise OAuth 2.0 pour authentifier les requêtes. OAuth 2.0 permet aux applications d'accéder aux ressources NinjaOne (telles que les informations de surveillance) mises à disposition via l'interface de programmation d'application (API).

Seuls les administrateurs système sont habilités à configurer les jetons OAuth pour l’API publique NinjaOne. Pour commencer à utiliser le protocole OAuth pour l’authentification de votre application auprès de NinjaOne, vous devez d’abord disposer d’un identifiant d’application OAuth fourni par NinjaOne. L’application OAuth configurera alors un accord d’autorisation pour vous. OAuth 2.0 prend en charge différents types d’accords. Cependant, l’API publique NinjaOne ne prend en charge que les types « code d’autorisation » et « accord implicite ».

Si vous avez des questions concernant la configuration de l’API, la documentation ou les jetons OAuth, vous pouvez contacter notre équipe API à l’adresse [email protected].

Générer une application cliente OAuth

Pour générer un identifiant d’application cliente OAuth dans NinjaOne, procédez comme suit.

  1. Accédez aux paramètres de l’API via Administration → Applications → API.
  2. Ouvrez l’onglet « ID d’applications clientes » et cliquez sur « + Ajouter une application cliente ».
API_add client app.png
Figure 1: Ajouter une nouvelle configuration d’application cliente dans NinjaOne
  1. Sélectionnez une option dans le menu déroulant « Plateforme d'application » pour générer davantage de champs de données.
Certains types d’autorisation peuvent ne pas être disponibles en fonction de votre sélection à cette étape.
  1. Utilisez le tableau suivant pour vous aider à remplir les champs correspondants.
ChampDescription
NomSaisissez le titre qui s'affichera comme nom de l'application cliente dans l'écran de consentement.
Ce nom s'affichera dans Administration → Applications → API → Jetons OAuth dans NinjaOne.
URL de redirectionSaisissez une ou plusieurs adresses vers lesquelles NinjaOne enverra les réponses OAuth. Ce paramètre n'est pas configurable lorsque vous utilisez l'option « Plateforme d'applications natives ».
Portées

Ces options permettent d’accéder à toutes les ressources API publiques d’un certain type.

  • Surveillance: accorde un accès en lecture seule aux données de surveillance et à la structure de l'organisation.
  • Gestion: permet de modifier les informations relatives aux appareils et à l'organisation, notamment de créer de nouvelles organisations, d'ajouter de nouveaux appareils, d'exécuter des scripts, etc.
  • Contrôle: active l'accès à distance via l'API.
Types d'autorisation autorisés

NinjaOne utilise les types d’autorisation OAuth 2.0 pour l’application cliente agissant au nom d’un utilisateur.

  • Code d'autorisation: le code d'autorisation est un code temporaire que le client échangera contre un jeton d'accès. NinjaOne obtient ce code auprès du serveur d'autorisation, où l'utilisateur peut consulter les informations demandées par le client et approuver ou refuser la demande.
  • Identifiants du client: ce flux contourne l’étape d’échange de code et constitue une alternative au code d’autorisation. À la place, le jeton d’accès est immédiatement renvoyé au client dans le fragment de chaîne de requête.
  1. Une fois la configuration terminée, cliquez sur « Enregistrer ».

Pour modifier ou supprimer l’ID d’une application cliente, placez le curseur de votre souris sur la ligne correspondante et sélectionnez l’option appropriée.

delete client app.png
Figure 2: Modifier ou supprimer la configuration d’une application cliente dans NinjaOne

Ressources supplémentaires

Consultez la documentation NinjaOne : API publique pour en savoir plus sur l'utilisation de l'API avec NinjaOne.

FAQ

Pour aller plus loin