Lire et examiner la documentation Automation Anywhere

Fermer les contenus

Contenus

Ouvrir les contenus

API de la Enterprise Control Room pour la gestion des informations d'identification de connexion aux robots

  • Mis à jour le : 5/10/2019

    API de la Enterprise Control Room pour la gestion des informations d'identification de connexion aux robots

    Utilisez l'API de connexion des robot : pour automatiser le processus de connexion permettant à un utilisateur disposant des privilèges appropriés de créer, mettre à jour ou supprimer des informations d'identification de connexion stockés dans le Credential Vault.

    Quand le robot : est déployé à partir de la Enterprise Control Room sur le Exécuteur de robots :, le robot : se connecte automatiquement au Exécuteur de robots : (si la machine est verrouillée/déconnectée). Le robot utilisera les informations d'identification stockées dans le Coffre d'accréditation pour la connexion automatique. Ces informations d'identification sont définies par l'utilisateur à l'aide de Outils → Options → Paramètres de connexion du Client Enterprise.

    Cependant, il peut arriver que le mot de passe Windows de l'utilisateur soit modifié, en particulier dans les entreprises où il existe une politique de rotation des mots de passe. Dans ce cas, l'utilisateur doit penser à mettre à jour le nouveau mot de passe dans Outils → Options → Paramètres de connexion.

    Pour automatiser le processus ci-dessus, la Enterprise Control Room 11.1 fournit une API directe pour créer, mettre à jour ou supprimer les informations d'identification de connexion stockées dans le Credential Vault.

    Deux étapes sont nécessaires pour utiliser cette API :

    1. Appeler l'API d'authentification
    2. Appeler l'API des informations d'identification de connexion

    API d'authentification

    Les détails de l'API d'authentification sont fournis dans l'article API de la Enterprise Control Room pour l'authentification.

    API d'informations d'identification de connexion

    Remarque : Seuls les administrateurs de la Enterprise Control Room (utilisateurs bénéficiant du rôle d'administrateur AAE) ont accès à l'API des identifiants de connexion ; autrement dit, si l'utilisateur invoquant l'API d'authentification a un rôle d'administrateur AAE, seul cet utilisateur est en mesure d'utiliser l'API des identifiants de connexion.
    En outre, cette API utilisera le jeton d'authentification obtenu à l'aide de l'API d'authentification. Le jeton d'authentification doit être transmis en tant qu'une des entrées d'en-tête à l'API d'informations d'identification de connexion.

    API : v1/credentialvault/external/credentials/loginsetting

    Si l'URL de la Enterprise Control Room est https://ultron.com:81, l'API sera : https://ultron.com:81/v1/credentialvault/external/credentials/loginsetting

    L'API utilise trois paramètres obligatoires en entrée au format JSON :

    1. Le nom de l'utilisateur .
    2. Le nom d'utilisateur de connexion (Windows) de l'utilisateur qui doit être mis à jour dans le Credential Vault pour cet utilisateur.
    3. Le mot de passe de connexion (Windows) de l'utilisateur qui doit être mis à jour dans le Credential Vault pour cet utilisateur.
      Remarque : Tous les paramètres sont obligatoires.

    Exemple :

    Si nous prenons un scénario « Authentification de la base de données » (où les utilisateurs sont stockés et authentifiés par la Enterprise Control Room)

    1. Le nom d'utilisateur est mike_williams
    2. Le nom d'utilisateur qualifié complet est ultron.com\mike.williams
    3. Le mot de passe de connexion étant abc123, le format JSON est

      { "Username": "mike_williams", "Windows_Username": "ultron.com\\mike.williams", "Windows_Password": "abc123" }

    À l'aide de l'API d'informations d'identification de connexion, les administrateurs de la Enterprise Control Room peuvent :

    1. créer les informations d'identification de connexion d'un utilisateur dans la Enterprise Control Room en utilisant la méthode « POST » ;
    2. mettre à jour les informations d'identification de connexion d'un utilisateur dans la Enterprise Control Room en utilisant la méthode « PUT » ;
    3. supprimer les informations d'identification de connexion d'un utilisateur à partir de la Enterprise Control Room en utilisant la méthode « DELETE ».

    Script VB pour créer les informations d'identification de connexion de l'utilisateur

    'AUTHENTICATION API - START

    Set objStream = CreateObject("ADODB.Stream")

    objStream.CharSet = "utf-8"

    objStream.Open

    objStream.LoadFromFile("D:\Deven.Deshpande\Office\Products\API for CV\auth-input.txt")

    restRequest = objStream.ReadText()

    objStream.Close

    Set objStream = Nothing

    contentType = "application/json"

    Set oWinHttp = CreateObject("WinHttp.WinHttpRequest.5.1")

    oWinHttp.Open "POST", "http://productslt12.aaspl-brd.com:81/v1/authentication", False

    oWinHttp.setRequestHeader "Content-Type", contentType

    oWinHttp.Send restRequest

    response = oWinHttp.StatusText

    MsgBox response

    Dim AuthToken

    'Set oJson = new aspJSON

    AuthToken = oWinHttp.ResponseText

    'oJson.loadJSON(AuthToken)

    'MsgBox oJson.data("token")

    MsgBox AuthToken

    'AUTHENTICATION API - ENDS

    '---------------------------------------------------

    'RESPONSE HEADER PARSING - START

    Dim sToken

    Dim posUser

    sToken = Right(AuthToken, Len(AuthToken) - 10)

    MsgBox(sToken)

    'sToken = Left(sToken, Len(sToken) - 4)

    posUser = InStr(sToken, "user")

    MsgBox posUser

    sToken = Left(sToken, posUser - 4)

    MsgBox(sToken)

    'RESPONSE HEADER PARSING - END

    'DEPLOYMENT API - START

    Set objStream_dep = CreateObject("ADODB.Stream")

    objStream_dep.CharSet = "utf-8"

    objStream_dep.Open

    objStream_dep.LoadFromFile("D:\Deven.Deshpande\Office\Products\API for CV\cred-input.txt")

    restRequest = objStream_dep.ReadText()

    objStream_dep.Close

    Set objStream = Nothing

    contentType = "application/json"

    Set oWinHttp = CreateObject("WinHttp.WinHttpRequest.5.1")

    oWinHttp.Open "PUT", "http://productslt12.aaspl-brd.com:81/v1/credentialvault/external/credentials/loginsetting", False

    oWinHttp.setRequestHeader "Content-Type", contentType

    oWinHttp.setRequestHeader "X-Authorization", sToken

    oWinHttp.Send restRequest

    response = oWinHttp.StatusText

    MsgBox response

    Dim DeployResponse

    DeployResponse = oWinHttp.ResponseText

    'MsgBox DeployResponse

    'DEPLOYMENT API - ENDS

    Contenu des fichiers d'entrée

    Applicable au script VB ci-dessus

    Le texte d'auth-input.txt aura la chaîne JSON en entrée pour l'authentification {"UserName":"admin","Password":"12345678"}

    Le texte pour deploy-input.txt aura la chaîne JSON en entrée pour le déploiement

    { "Username": "mike_williams", "Windows_Username": "ultron.com\\mike.williams", "Windows_Password": "abc123" }

    Envoyer le commentaire