Lesen und beachten Sie die Automation Anywhere-Dokumentation

Automation Anywhere Automation 360

Inhalt schließen

Inhalte

Inhalt öffnen

Konfigurieren Sie mithilfe der API Anmeldeinformationen mit Attributwerten

  • Aktualisiert: 1/31/2021
    • Automation 360 v.x
    • Erkunden
    • RPA Workspace

Konfigurieren Sie mithilfe der API Anmeldeinformationen mit Attributwerten

Erstellen Sie eine Anmeldeinformation mit einem Standardattribut, und fügen Sie zwei zusätzliche Attribute mit Benutzereingabewerten hinzu.

Vorbereitungen

Anmerkung: Sie können die Control Room APIs im anzeigen Community Edition, aber die API-Funktionalität ist eingeschränkt. Sie benötigen eine lizenzierte Automation 360 Edition, um auf die volle Funktionalität der APIs zugreifen zu können.
  • Verwenden Sie die Authentifizierungs -API, um ein JSON-Webtoken zu generieren.
  • Alle Rollen verfügen über die Berechtigung Meine Anmeldeinformationen und Schließfächer verwalten, die zum Konfigurieren von Anmeldeinformationen und Attributen erforderlich ist. Für die Verwendung dieses Endpunkts sind keine zusätzlichen Berechtigungen erforderlich.
In diesem Beispiel konfigurieren Sie eine Anmeldeinformation mit drei Attributen, die den E-Mail-Hostnamen, den Benutzernamen und das Kennwort enthalten.

Prozedur

  1. Fügen Sie das Authentifizierungstoken zum Anforderungsheader hinzu.
  2. Erstellen von Anmeldedaten Verwenden Sie die POST-Methode und die Endpunkt-URL: <Your_Control_Room_url>/v2/credentialVault/Credentials.
    Anforderungsgremium: Diese Beispielanforderung enthält die folgenden erforderlichen Parameter:
    • UserProvided: ein boolescher Wert, der konfiguriert, ob das Attribut die Eingabe eines Benutzers (true) erfordert oder Standard für alle Benutzer (false) ist.
    • Masked: ein boolescher Wert, der konfiguriert, ob der Attributwert mit Sternchen (true) maskiert oder für Benutzer (false) sichtbar ist.
    {
      "name": "Email",
      "attributes": [
      	{
          "name": "hostname",
          "userProvided": false,
          "masked": false
        } 	
      ]
    }
  3. Senden Sie die Anfrage.
    Antwortteil: In einer erfolgreichen Anforderung gibt dieser Endpunkt die folgenden Daten zurück:
    • id: eine eindeutige numerische Kennung für die Zugangsdaten.
    • Attribute:id: eine eindeutige numerische Kennung für das Attribut.
    {
        "id": "1630",
        "name": "Email",
        "description": "",
        "ownerId": "1508",
        "attributes": [
            {
                "id": "3335",
                "name": "hostname",
                "description": "",
                "userProvided": false,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366448Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            }
        ],
        "createdBy": "1508",
        "createdOn": "2020-12-28T22:04:41.366460Z",
        "updatedBy": "1508",
        "updatedOn": "2020-12-28T22:04:41.366464Z",
        "version": "0"
    }
    Die REST-API antwortet auf jede Anforderung mit einem HTTP-Antwortcode. Antwortcodes finden Sie unter API-Antwortcodes.
  4. Weisen Sie dem Attribut hostname den Anmeldeinformationen einen Standardwert zu. Verwenden Sie die POST-Methode und die Endpunkt-URL:<your_Control_room_url>/v2/credentialvault/credentialtresor/{credentialId}/attributevalues.
    {
      "list": [
        {
          "credentialAttributeId": "3335",
          "value": "mail.example.com"
        }
      ]
    }
  5. Senden Sie die Anfrage.
    Antwortteil:
    {
      "list": [
        {
          "id": "1630",
          "credentialAttributeId": "3335",
          "value": "mail.example.com",
          "userId": "1508",
          "createdBy": "1508",
          "createdOn": "2020-12-28T22:04:41.366460Z",
          "updatedBy": "1508",
          "updatedOn": "2020-12-28T22:04:41.366464Z",
          "version": "0"
        }
      ]
    }
  6. Fügen Sie den E -Mail -Anmeldeinformationen den Benutzernamen und das Kennwort hinzu. Verwenden Sie die PUT-Methode und die Endpunkt-URL:<your_Control_Room_url>/v2/credentialvault/credentialId/{credentialId}.
    Anforderungsgremium: Da Sie die Anmeldeinformations-ID in der Anforderungs-URL angegeben haben, ist es nicht erforderlich, die Anmeldeinformations-ID oder den Namen im Anforderungskörper anzugeben. In diesem Beispiel werden die Attribute username und password mit Werten konfiguriert, die von jedem Benutzer eine andere Eingabe akzeptieren. Darüber hinaus wird das Attribut password so konfiguriert, dass der eingegebene Wert mit Sternchen maskiert wird.
    {
        "attributes": [
      	{
          "name": "username",
          "userProvided": true,
          "masked": false
        },
         {
          "name": "password",
          "userProvided": true,
          "masked": true
        }	
      ]
    }
  7. Senden Sie die Anfrage.
    Antwortteil: Der Antwortkörper gibt die Anmeldedaten mit Details zu den drei Attributen zurück.
    {
        "id": "1630",
        "name": "Email",
        "description": "",
        "ownerId": "1508",
        "attributes": [
            {
                "id": "3335",
                "name": "hostname",
                "description": "",
                "userProvided": false,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366448Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            },
            {
                "id": "3336",
                "name": "username",
                "description": "",
                "userProvided": true,
                "masked": false,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366450Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            },
            {
                "id": "3337",
                "name": "password",
                "description": "",
                "userProvided": true,
                "masked": true,
                "createdBy": "1508",
                "createdOn": "2020-12-28T22:04:41.366450Z",
                "updatedBy": "1508",
                "updatedOn": "2020-12-28T22:04:41.366450Z",
                "version": "0",
                "passwordFlag": false
            }
        ],
        "createdBy": "1508",
        "createdOn": "2020-12-28T22:04:41.366460Z",
        "updatedBy": "1508",
        "updatedOn": "2020-12-28T22:06:35.366464Z",
        "version": "2"
    }

Nächste Maßnahme

Wenn Sie die Schritte zum Konfigurieren des befolgen Credential Vault, gehen Sie wie folgt vor: Weisen Sie der Locker API Anmeldeinformationen zu.
Feedback senden