Lire et examiner la documentation Automation Anywhere

Automation Anywhere Automation 360

Fermer les contenus

Contenus

Ouvrir les contenus

API Créer un nouvel utilisateur

  • Mis à jour le : 2021/01/28

    API Créer un nouvel utilisateur

    Utilisez l’API Créer un nouvel utilisateur pour créer un nouvel utilisateur dans la Control Room.

    Prérequis

    Afficher et gérer les utilisateurs et les rôles

    Authentifiez-vous avec un utilisateur jouissant des autorisations ADMINISTRATION suivantes :

    Afficher les utilisateurs
    Les utilisateurs disposant de ces autorisations peuvent créer et gérer des utilisateurs. Ce sont des autorisations administrateur. Il est recommandé de n’accorder aux utilisateurs non administrateurs que des autorisations limitées de création et de gestion d’utilisateurs. Apprenez à créer un rôle bénéficiant d’autorisations limitées pouvant être attribué à des utilisateurs.
    Créer des utilisateurs
    Créer de nouveaux utilisateurs dans le Control Room.
    Modifier les utilisateurs
    Modifiez tous les utilisateurs dans le Control Room, y compris les utilisateurs créés par d’autres administrateurs.
    Supprimer des utilisateurs
    Supprimez n’importe quel utilisateur dans le Control Room.
    Afficher les rôles

    Les utilisateurs disposant de cette autorisation peuvent afficher les rôles auxquels ils ont accès.

    Gérer les rôles

    Les utilisateurs peuvent créer, modifier et supprimer les rôles auxquels ils ont accès.

    Voir les licences

    Les utilisateurs disposant de ces autorisations peuvent afficher et gérer les licences de périphérique. Les licences de périphérique permettent aux utilisateurs d’effectuer certaines tâches spécifiques. Par exemple, les Bot Creators ont besoin d’une licence de périphérique de type DÉVELOPPEMENT pour créer des bots.

    Gérer les licences de périphérique des utilisateurs

    Les utilisateurs disposant de cette autorisation peuvent attribuer des licences de périphériques aux autres utilisateurs.

    Paramètres minimum requis
    • Rôles  : Chaque utilisateur doit posséder au moins un rôle.

      L’accessibilité basée sur les rôles permet un accès approprié aux données et actions pertinentes.

      Dans le corps de la requête, nous avons attribué cette autorisation AAE_Basic (ID : 2)

      Rôles et autorisations

    • nom d’utilisateur : Chaîne (255 max)
    • adresse e-mail : Doit être conforme au format standard d’e-mail (username@domain.com)
    • mot de passe : Chaîne : 8 à 15 caractères. Caractères autorisés : a-z, A-Z, 0-9, @, -, _, !, #, $, %, &, et . (point)
    Paramètres facultatifs
    • "enableAutoLogin": true
    • "username": "AnyUser"
    • "firstName": "Tester"
    • "lastName": "Writer"
    • "email": "username@mydomain.com"
    • "password": "anypassword"
    • "description": "Test des API de gestion des utilisateurs"
    • "licenseFeatures": [ DEVELOPMENT, RUNTIME, IQBOTRUNTIME, ANALYTICSCLIENT, ANALYTICSAPI ]

      Les utilisateurs peuvent être créés sans licence de périphérique attribuée. Il existe des Rôles et autorisations qui activent des privilèges pour des utilisateurs et des rôles spécifiques.

    • URL : http://<your_control_room_url>/v1/usermanagement/users

      Remplacez le contenu entre crochets par l’URL de votre Control Room.

    • Méthode : POST
    • Utilisez le Swagger installé avec votre Control Room pour tester les API. Voir les API disponibles sur : http://<your_control_room_url>/swagger/
    • Vous pouvez également utiliser un client REST pour effectuer cette tâche.

    Procédure

    1. Ajoutez le jeton d’authentification à l’en-tête de la requête.
    2. Utilisez la méthode POST et l’URL du point de terminaison :<your_control_room_url>/v1/usermanagement/users
    3. Dans le corps de requête, ajoutez les paramètres obligatoires.
      Pour l’accès SSO (Single Sign-On) basé sur SAML ou l’accès AD (Active Directory), le mot de passe n’est pas requis. Le mot de passe est obligatoire pour une authentification de base de données.

      Corps de requête :

      {
       {
        "roles": [
          {
            "id": 2
          }
        ],
        "domain": "string",
        "email": "ad@ma.com",
        "enableAutoLogin": true,
        "username": "mdadmin1",
        "firstName": "MDadmin2",
        "lastName": "ADadmin",
        "description": "string",
        "disabled": true,
        "password": "changeme",
        "licenseFeatures": [
          "DEVELOPMENT"
        ]
      }
      
    4. Envoyez la requête.
      Corps de réponse :
      {
          "id": 2075,
          "username": "mdadmin1",
          "domain": "string",
          "firstName": "MDadmin2",
          "lastName": "ADadmin",
          "version": 0,
          "principalId": 2075,
          "deleted": false,
          "roles": [
              {
                  "name": "AAE_Basic",
                  "id": 2,
                  "version": 0
              }
          ],
          "sysAssignedRoles": [],
          "groupNames": [],
          "permissions": [
              {
                  "id": 7526,
                  "action": "viewuserrolebasicinfo",
                  "resourceId": null,
                  "resourceType": "usermanagement"
              },
              {
                  "id": 7,
                  "action": "run",
                  "resourceId": null,
                  "resourceType": "repositorymanager"
              },
              {
                  "id": 94,
                  "action": "view",
                  "resourceId": null,
                  "resourceType": "botstore"
              },
              {
                  "id": 61,
                  "action": "createstandard",
                  "resourceId": null,
                  "resourceType": "credentialattribute"
              },
              {
                  "id": 92,
                  "action": "view",
                  "resourceId": null,
                  "resourceType": "packagemanager"
              },
              {
                  "id": 97,
                  "action": "register",
                  "resourceId": null,
                  "resourceType": "devices"
              },
              {
                  "id": 29,
                  "action": "view",
                  "resourceId": null,
                  "resourceType": "repositorymanager"
              },
              {
                  "id": 120,
                  "action": "view",
                  "resourceId": null,
                  "resourceType": "dashboard"
              }
          ],
          "licenseFeatures": [
              "DEVELOPMENT"
          ],
          "emailVerified": false,
          "passwordSet": false,
          "questionsSet": false,
          "enableAutoLogin": true,
          "disabled": true,
          "clientRegistered": false,
          "description": "string",
          "createdBy": 1513,
          "createdOn": "2020-11-20T20:17:26Z",
          "updatedBy": 1513,
          "updatedOn": "2020-11-20T20:17:26Z",
          "publicKey": null,
          "appType": null,
          "routingName": null,
          "appUrl": null,
          "email": "ad@ma.com"
      }
      L’API REST répond à chaque requête par un code de réponse HTTP. Pour plus d’informations sur les codes de réponse, consultez Codes de réponse de l'API.
    Envoyer le commentaire