Comment intégrer l’API fournisseur NordPass

Introduction

L’API fournisseur permet aux partenaires MSP d’accéder aux données d’utilisation pour les organisations gérées, y compris la consommation de licences et le statut de l’organisation. Cet article explique comment intégrer les services NordPass MSP à vos outils de gestion Business à l’aide de l’API fournisseur. 

 

Avant de commencer

L’API fournisseur fournit des informations d’utilisation quotidienne et mensuelle pour toutes les organisations gérées par un MSP, notamment :

  • Nombre de licences consommées et niveau
  • Statut de la période d’essai
  • Indicateurs non destinés à la revente (NFR)

 

Les points de terminaison de NordPass suivent les principes de l’API REST et utilisent exclusivement JSON dans les corps de requête. Si nécessaire, vous devez utiliser un en-tête « Content-Type: application/json » et former une charge utile JSON valide dans le corps de la requête. Vous recevrez une réponse JSON valide en cas de succès ou des informations d’erreur en cas d’échec.

 

Voici comment faire

Comment générer votre clé privée

Pour authentifier les requêtes API, vous devez générer des données JWT pour votre entreprise. Pour ce faire, suivez ces étapes :

  1. Ouvrez le panneau d’administration MSP, puis cliquez sur le bouton Intégrations, situé sur le côté droit. 
  2. Ensuite, sélectionnez le bouton fournisseur API fournisseur et cliquez sur le bouton Générer une clé privée.
  3. Enregistrez les données et conservez-les dans un endroit sûr. Ensuite, cochez la case près de « J’ai fait une copie des données ci-dessus » et cliquez sur le bouton Terminé.

    Remarque : si vous perdez votre clé privée, vous devrez en générer une nouvelle.

 

Comment révoquer ou régénérer une clé API

Si votre clé privée est perdue ou compromise, procédez comme suit :

  1. Ouvrez le panneau d’administration MSP, puis cliquez sur le bouton Intégrations, situé sur le côté droit. 
  2. Ensuite, sélectionnez le bouton API fournisseur et cliquez sur Révoquer la clé privée.
  3. Une fois que l’invite contextuelle apparaît, sélectionnez le bouton Révoquer pour confirmer votre choix.

    Remarque : la révocation d’une clé privée désactive immédiatement toutes les intégrations existantes qui l’utilisent.

 

Conseils supplémentaires

  • Conservez votre clé privée en toute sécurité et limitez l’accès à celle-ci.
  • Révoquez immédiatement la clé si vous pensez qu’elle a été compromise.

Cet article vous a-t-il été utile ?