Pour ajouter une connexion personnalisée, importez votre collection Postman. Les demandes dans le fichier JSON Postman sont les actions. Une fois que vous avez importé la collection, les actions deviennent disponibles pour une utilisation dans les workflows d'automatisation.

Pour des informations générales, consultez Connecteurs personnalisés.

Conditions préalables

  • Créez une collection à l'aide du processus décrit dans Utiliser Postman pour les connecteurs personnalisés.
  • Le service que vous prévoyez de connecter doit prendre en charge la REST API et les types de contenu JSON.
  • Workspace ONE Intelligence a besoin d'accéder aux points de terminaison d'API. Si les services se trouvent derrière un pare-feu, utilisez le Unified Access Gateway comme proxy inverse.
  • Si vous utilisez OAuth2 pour l'authentification, vous devez disposer des détails d'autorisation afin que Workspace ONE Intelligence puisse récupérer, actualiser et accéder aux jetons du service.
    • URL du jeton Oauth2
    • Client Secret
    • ID client
    • Type d'autorisation (Informations d'identification du client ou Mot de passe)

Procédure

  1. Dans Workspace ONE Intelligence, accédez à Paramètres > Intégrations > Connexions d'automatisation et sélectionnez Ajouter une connexion personnalisée.
  2. Configurez la connexion personnalisée.
    Paramètres Descriptions
    Nom de la connexion Entrez un nom identifiable pour la connexion.
    URL de base Entrez l'URL du service pour que Workspace ONE Intelligence puisse s'authentifier.

    L'URL du service et l'URL de la connexion personnalisée doivent correspondre.

    Type d'authentification Sélectionnez le type d'authentification à utiliser pour accéder au service.

    Workspace ONE Intelligence remplace les en-têtes d'authentification Postman dans les collections avec ce paramètre.

    Si votre service utilise un type d'authentification basé sur un en-tête unique, ajoutez l'en-tête à toutes vos demandes dans la collection Postman et configurez l'URL de base. Dans ce scénario, Workspace ONE Intelligence utilise les en-têtes configurés dans la collection Postman. Les types d'authentification basés sur l'en-tête utilisent une clé API ou un jeton, par exemple.

    • Authentification basique
      • Nom d'utilisateur
      • Mot de passe

      Pour autoriser l'accès à Workspace ONE Intelligence, entrez les informations d'identification.

    • Authentification OAuth2
      • URL du jeton Oauth2
      • Client Secret
      • ID client
      • Type d'autorisation (Informations d'identification du client ou Mot de passe)

      Entrez les détails pour que Workspace ONE Intelligence puisse récupérer et actualiser les jetons du service et y accéder.

    • Aucune authentification

      Si vous ne voulez pas que Workspace ONE Intelligence remplace les en-têtes d'authentification, sélectionnez cet élément de menu.

  3. Pour importer votre fichier JSON Postman, utilisez le lien Sélectionnez à partir de votre ordinateur au milieu de l'interface utilisateur.
    L'interface utilisateur affiche la collection avec ses demandes. Ces demandes Postman sont désormais disponibles comme actions pour les automatisations.
  4. Dans la liste des actions importées, vous pouvez tester, modifier et supprimer l'action.
    Paramètres Descriptions
    Supprimer
    • Si une action que vous souhaitez supprimer est utilisée dans d'autres automatisations, le système désactive ces automatisations et supprime l'action. Vous devez modifier et réactiver ces automatisations pour leur permettre de continuer à fonctionner.
    • La suppression n'est pas réversible.
    Modifier
    • Vous pouvez modifier le nom et la description des actions.
    • Le système prend les noms et les descriptions à partir du JSON Postman importé.
    • Pour modifier les détails de la demande d'action, modifiez la collection Postman, puis réimportez-la dans votre connexion personnalisée.
    Test

    Utilisez l'élément de menu Tester pour vous assurer que la connexion fonctionne. Le système teste la demande configurée dans la collection Postman.

Que faire ensuite

Ajoutez l'action à un workflow à l'aide de la catégorie Workspace ONE UEM > Terminaux. Pour plus d'informations, reportez-vous à la section Configuration des workflows.