Impersonation

The user that has been granted impersonation rights has the same rights as the one whom it is impersonating.

Specified using the impersonate attribute.

Impersonation requires, that

  • An impersonation user ("master user") is configured in CRM.interface (see figure below)
  • the login matches the specified credentials
  • and the impersonate attribute is specified
If all the above listed conditions are fulfilled a login without password check using the credentials given in the impersonate attribute is performed.

The impersonate attribute consists of at least one name/value pair (separated by semicolon), each referencing a login. The first successful login is then used for the respective request or command. The following list describes the possible values for the name part:

  • user: the login name (as specified in the user attribute in Authentication)
  • rep: the name of the associated rep (table RepUser/ID, field Name/3)
  • email: the email address of the associated rep (table RepUser/ID, field E-mail1/27)

Example: (the value of the auth attribute is omitted for brevity)

<request auth="…" impersonate="user=USERNAME;rep=RepUserName;email=email@mail.com">
  <!-- command -->
</request>