Action d'API personnalisée

Effectuez un appel HTTP personnalisé et authentifié à l'API Okta Privileged Access.

La carte Action d'API personnalisée vous permet d'effectuer des appels API de votre choix vers Okta Privileged Accessl'API . L'objectif principal de cette carte est de générer des opérations de flux si les autres cartes d'action ne prennent pas en charge votre cas d'utilisation.

La carte Action d'API personnalisée génère et envoie automatiquement l'URL à l'API Okta Privileged Access à l'aide des identifiants fournis. Le champ URL liée contient le chemin d'accès au point de terminaison vers lequel vous souhaitez envoyer la requête.

L'Action API personnalisée n'effectue aucune validation logique pour les opérations. Par exemple, cela n'empêche pas une requête DELETE de contenir un corps HTTP. Consultez la documentation de l' Okta Privileged AccessAPI pour vérifier que vous appelez l'API correctement.

Options

Champ Définition Type Obligatoire

Type de requête

Voici les méthodes de requête HTTP prises en charge, ou verbes HTTP, dans un appel API personnalisé (voir Méthodes de requête HTTP).

  • GET : Récupère des données d'un serveur web en fonction des paramètres. Cette méthode demande une représentation de la ressource spécifiée. Si une requête réussit, un message de réponse 200 (OK) est retourné avec le contenu demandé.

  • POST : Envoie des données à un serveur web en fonction des paramètres, par exemple, charger un fichier. Plusieurs requêtes POST peuvent aboutir à un résultat différent d'un seul POST. Soyez prudent pour éviter d'envoyer plusieurs requêtes POST par inadvertance. Si une requête réussit, un message de réponse 200 (OK) est retourné.

  • PUT : Envoie des données à stocker à un emplacement spécifique sur un serveur web en fonction des paramètres, comme charger un fichier. Contrairement aux requêtes POST, les requêtes PUT sont idempotentes. Pour les requêtes réussies, le résultat d'une seule requête PUT est le même que plusieurs requêtes PUT identiques. Si une requête réussit, un message de réponse 200 (OK), 201 (Created) ou 204 (No Content) est retourné.

  • PATCH : Applique des modifications partielles à une ressource sur un serveur web en fonction des paramètres. PATCH n'est pas idempotente. Plusieurs requêtes PATCH pourraient avoir des conséquences non souhaitées. Si un PATCH réussit, un message de réponse 200 (OK) ou 204 (No Content) est retourné.

  • DELETE : Supprime la ressource spécifiée si elle existe du serveur web en fonction des paramètres. Si un DELETE réussit, un message de réponse 200 (OK) est retourné.

Liste déroulante TRUE

Entrée

Champ Définition Type Obligatoire

Requête

URL liée

L'adresse URL du serveur Web que vous essayez d'appeler. Spécifiez l'URL relative comme /{insert_remaining_URL}.

Vous pouvez spécifier des paramètres de requête dans l'URL relative à l'aide de ?, ou spécifier les paramètres de requête sous forme de paire clé/valeur dans l'entrée Requête.

Pour l'API Okta Privileged Access située à https://{OktaOrg}.pam.okta.com/v1/teams/{teamname}/{endpoint}, l'URL liée est /{endpoint}.

Par exemple, pour l'API Okta Privileged Access : https://myorg.pam.okta.com/v1/teams/adminteam/sudo_command_bundles, l' URL liée est /sudo_command_bundles.

 Texte TRUE

Requête

Spécifiez tous les paramètres de requête supplémentaires qui doivent être inclus sous forme de paires clé/valeur.

Par exemple, {"name":"something-urgent"}.

 Objet FALSE

En-têtes

Spécifiez tous les en-têtes requis en plus de authorization ou content-type, puisque le connecteur gère déjà ces en-têtes.

 Objet FALSE

Corps

Spécifiez un corps de requête au format JSON.

Cette entrée n'est disponible que pour les requêtes POST, PUT et PATCH.

 Objet FALSE

Sortie

Champ Définition Type

Réponse

Code de statut

Résultat de l'opération. Le connecteur retourne un code de statut HTTP qui indique si l'action effectuée par la carte a réussi ou échoué. Par exemple :

  • Un code de statut 201 Created indique un succès où une nouvelle ressource a été créée.
  • Une erreur 403 Forbidden indique que la requête HTTP n'a pas été traitée parce que les permissions nécessaires étaient manquantes.

Pour une liste complète des codes de statut possibles, voir Codes de statut HTTP.

 Nombre

En-têtes

Contexte détaillé du code de statut, sans lien avec le corps de la sortie. Les en-têtes de réponse dépendent de l'option de requête HTTP sélectionnée. Tous les en-têtes ne sont pas des en-têtes de réponse. Ceci est semblable à {"Content-type":"application/json"}.

 Objet

Corps

Données retournées par votre requête HTTP sélectionnée.

Par exemple, les données d'une requête GET.

 Objet