Versions Compared

Old Version 15

changes.mady.by.user Igor Shakhbazyan

Saved on

compared with

New Version Current

changes.mady.by.user Ilya Teterin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Version is actual before DEF0014794 is fixed. When it is fixed, re-merge v.17 from branch DOC0000345.

Impersonationis used to test changes in system configuration settings and in access rights. Impersonation is also used to demonstrate the implementation of automated processes in different roles.

Tip

Role required: impersonator.

Two following parties are engaged in the Impersonation process: 

  • Impersonator – can log in as another user temporarily.

  • Impersonated user – on behalf of whom the session is being performed.

If a user has the impersonator role, they can impersonate other users. If an administrator

...

 has an

...

impersonator role

...

,

...

they can impersonate users

...

and administrators. The impersonator has access to

...

what

...

the user can access in the system

...

, including the same tools, UI layout, etc. The instance records

...

impersonator's activities

...

on behalf of the impersonated user, but specifies that it was within the impersonation session

...

. 

Impersonate a user

Tip

Before you begin

Role required: impersonator

To impersonate a user, please complete the steps below:

  1. In the banner

...

  1. , click on your user name or profile photo to open the user menu.

...

  1. Select Impersonate. The Impersonate dialog box appears.

  2. Start typing the name of the user you need to impersonate; once it appears in the selection field, select it.

    • You need to type at least two symbols.

To return to your original login session,

...

please do the

...

Info

When you try to impersonate a user who is locked out or is inactive, the system generates a warning message and interrupts a process. To go on, you need to activate this user first.

Impersonation logs

Impersonations are logged in the System History storage, like any other user activity. But the system point that the action was made within the impersonation session, so the impersonated user name will be specified in the Username column, and impersonator username will be specified near it in brackets like displayed on screenshot below.

following steps:

  1. Click on your user name or profile photo to open the user menu.

  2. Click Back to me.

Image Added

Info

  • An inactive or locked-out user will be unavailable for impersonation. To impersonate this user, activate or unlock them first.

  • You cannot impersonate Guest User and System User. 

  • To find the user you need, type their 

    Tooltip
    linkHrefURLhttps://docs.simpleone.ru/display/SAPI/Users#:~:text=First%20Name,User%27s%20last%20name.
    appendIconKein Icon
    linkTextDisplay Name

    Display Name

     instead of Login. 

    Tooltip
    onlyIcontrue
    appendIconinfo-filled
    iconColorblue

    Image Added


    Note

    Please note that the Display Name field can be empty. To find such records for further fixing, you can filter records in the User table by applying the following conditions in the Condition Builder:

    [Displayable Name] is [empty] 


Impersonation logs

Every time a user starts or stops impersonating another user, a related record appears in the Main Log (sys_log) storage. The format of the Message field in the record is:

Panel
titleColor#ffffff
Impersonation {start|end}: <impersonated_user> by: <impersonator>

where both the impersonated user and impersonator are specified in the Display Name (username) format.

Both the Impersonation start and Impersonation end log records get created on behalf of the user whose identity will be used for further actions:  

  • Impersonation start record: Impersonated user
  • Impersonation end record: Impersonator

See the screenshot below for an example:

Image Added

Actions of impersonated users are registered in System Logs, like any other user activity.

Each log record resulting from an action of an impersonated user appears in the relevant log storage, as it would do without impersonation (refer to the Logging article for more details.): 

  • Main Log (sys_log)

  • History (sys_history)

  • Script Log (sys_log_exception)

  • Exception Log (sys_log_script)

  • Record Deletion Log (sys_record_deletion_log)

A record logged for an impersonated user action can be recognized by the value of its Username field. In such a record, the impersonator's username in brackets follows the username of the impersonated user:

Image Added


Table of Contents
absoluteUrltrue
printablefalse

...