Skip to main content

Accounts

Description

An account is the way an user is presented on a target system.  There can be user accounts as well as system-purpose accounts.

An account belongs to a system and that account can have specific permissions assigned to it. An account must have defined the account type, that is if the account is a single user, privileged, shared, or unmanaged.

The password policy is also mandatory to create an account. That password policy determines the conditions that the password must meet.

It is allowed to set a password for an account, which can be a generated password by the system, or a password set by the administrator user. That password must comply with the password policies defined. When the account is unmanaged, if the password change, it will not be sent to the target system.

The account can be displayed in black or gray color. The gray color is used to indicate that the account is unmanaged, that is because the agent is disconnected or because the agent is in Read-Only Mode.

Screen overview

image.png

image.png

Related objects

An account is related, in Soffid, to other objects:

    • UserUsers : owner users related to thisthe account.accounts
    • GroupsAgents : groupsthe totarget system in which thethat account belongs.is used (AD, Exchange, etc).
    • User type : user type of the onwer user or another one selected in the other account types
    • Password policies : password policy of the onwer user or another one selected in the other account types
    • Roles : the permissions that this account has associated with the system in which it is used. They can be assigned or revoked by users with administrator privileges.
    • SystemInformation systems : where the environmentroles inare which that account is used (AD, Exchange, etc).gathered
  • Password vault : password vault information

    • Standard attributes

    Basic

    On the basic account tab, you can view all the account attributes. It is allowed to add new accounts,  update or delete existing accounts and other options.

    Commons attributes
    • System: target system to which the account will be connected. When SSO is the system selected, the account name is assigned by Soffid, that is because SSO is a multi-system connector and can be many accounts with the same login name.
    • Name: name used to identify the account.
    • Login name: login name used in PAM navigations
    • Description: plain text with information about the account.
    • Type: there are four kinds of accounts:
      • Single user account: accounts should normally be user accounts and bound to a single user. We can see user accounts on the user management screen, and will mostly be created by Soffid.
      • Shared accounts: these accounts are shared among multiple users. They have an access control list to prevent unauthorized usage. Will be granted to users, groups or roles. Passwords on shared accounts might be set by operators or by the user. It depends on the password policy definition. A shared account could have related services.
      • High privilege accounts: shared among users, but only one user possesses it at one time. Through self-service portal, a high privilege account owner can check-in and check-out them. Will be granted to users, groups or roles. Passwords on these accounts will be set only by the user using the self-service portal. The user can set it for a period of time. After that, the system will change the password by a temporary one.
      • Unmanaged accounts: ignored by Soffid. They can be populated based on existing system accounts. Soffid will be able track any changes applied to this type of accounts on the managed system, but Soffid will not apply any change to the actual system. You should have a limited number of unmanaged accounts, but they are extremely useful during deployment phase.
    • Status: 
      • Enabled: the account can be used by the user. Soffid engine will disable it when the user does not match the access requirement policy.
      • Manually enabled: the account can be used by the user. Soffid engine will keep it enabled, even when the user does not match the access requirement policy.
      • Locked: the account is locked when a user tries to access with a fail password too many times  (5 times). The account will be enabled in a specific period of time (5 minutes).
      • Disabled: the account cannot be used by the user. Soffid engine will enable it when the user does matches the access requirement policy.
      • Manually enabled: the account cannot be used by the user. Soffid engine will keep it disabled, even when the user matches the access requirement policy.
      • Removed: the account no longer exists in the target system, but its image is kept in Soffid for audit purposes.
      • Archived: same status as "Removed" but useful if you need to differentiate it for a business process
    • Credential type: this field will be available when the system is filled with the SSO option. 
      • Password: this is the default value. This option will allow you to set the account password.
      • SSH key: this option will allow you to add a SSH key. This SSH key could be an existing key or a generated new key.
      • Kubernetes key: this option will allow you to enter a Yaml descriptor to configure the access.
    • Status: 
      • Enabled: the account can be used by the user. Soffid engine will disable it when the user does not match the access requirement policy.
      • Manually enabled: the account can be used by the user. Soffid engine will keep it enabled, even when the user does not match the access requirement policy.
      • Disabled: the account cannot be used by the user. Soffid engine will enable it when the user does matches the access requirement policy.
      • Manually enabled: the account cannot be used by the user. Soffid engine will keep it disabled, even when the user matches the access requirement policy.
      • Removed: the account no longer exists in the target system, but its image is kept in Soffid for audit purposes.
      • Locked: the account is locked when a user tries to access with a fail password too many times  (5 times). The account will be enabled in a specific period of time (5 minutes).
      • Archived: 
    • Password policy: the policy applied to this account. It is mandatory select a password policy. You can see more information on the User Type and Password policies pages. 
    💻 Image


    image.pngimage.png


    Owners, Managers, and SSO users

    Specify the list of users authorized to use this account. For accounts of type "single user", only one user can be specified. Other accounts can have more than one user. The users that can use this account can be specified either directly, by entering the user name, or indirectly, by entering a group or role name. At the latest, any user having that group or role will automatically be entitled to use this account.

    There are three access levels for each account and user:

      • SSO UserOwner: can use itit, by means ofmodify the SSOaccess control list, and set or PAMquery engines.the Theypassword cannotsing changeself-service theirportal password, not even throughor single sign sign-on engine.
      • Manager: can use it, and set or query the password (using self-service portal), depending on the password policy restriction.
      • OwnerSSO User: can use it,it modifyby means of the access control list, and setSSO or queryPAM theengines. passwordThey singcannot self-servicechange portaltheir orpassword, not even through single sign-sign on engine.
    💻 Image

    image.png

    image.png

    image.png

    Password synchronization
    • Server type: type of the server.
      • Linux
      • Windows
      • Database
    • Server name: descriptive name of the server
    • SSH Public key: SSH key for linux servers
    💻 Image

    image.png

    Password vault
    • Vault folder: personal or shared folder, depending on the account type, in which account data are stored.
    • Inherit new permissions: determines if the account will inherit the permissions granted to the folder that contains it.
    💻 Image

    image.pngimage.png

    Password synchronization
    • Server type: 
      • Linux
      • Windows
      • Database
    • Server name
    • SSH Public key
    💻 Image

     

    Launch properties

    Defines the properties to connect to the target system.

    • Login URL: URL to connect. You can add the port when you need it
    • Login name: account name to connect.
    • Launch type: connection type.
      • Simple
      • WebSSO
      • PAM Jump server: it is mandatory to select the Jump server group.
    💻 Image

    image.pngimage.png

    Audit information
    • Created onExternalId: accountnew creationattribute date.in Soffid 4 to keep a record of the unique identifier of the object in the final system (useful for synchronisation and renaming).
    • Last login: last registered access.
    • Last updatedsynchronization: last modified.registered synchronization.
    • Last password set: date of last password change.
    • Password expiration: password expiry date.
    • In use by: account owner
    • Password synchronization.: password synchronization date.
    • Created: account creation date.
    • Last change: last modified.
    • Created by: user who created the account
    • Updated by: last user who updated the account
    Image

    image.png

    System properties
    • From data: to add parameters
    • Type: possible values:
      • Windows
      • Linux
      • Database
    • SSH Private key: private key that establishes trust to be able to access the system without requiring a password.
    • SSH Public key: public key that establishes trust to be able to access the system without requiring a password.
    • Password synchronization: possible values:
      • Valid
      • Expired
      • Invalid
    Events history

    List of events on this account

    💻 Image

    image.png

    Services

    List of services on this account. The account type must be shared to view those services. All these services appear after agent reconciliation.

    💻 Image

     

    Soffid allows you to manage the existing services, you can add, update or remove services as well. This makes sense in the case of Linux machines. 

    💻 Image

     

    Roles

    A role is a collection of permissions that can be granted.

    On the roles tab, you can view the roles assigned to the account, it is shown information about the role name, description, application or start (and, if proceed, end) date of the role assignment. 

    You can also assign roles to the account, you can click the add symbol (+), select the role that you want to assign, depending on the role you must fill the scope, and finally set memberships properties.

    It is also possible to revoke roles to the account from the entitlement details or by selecting one or more records from the list and clicking the button with the subtraction symbol (-). 

    By clicking on a record, it is shown the detail  role assignment information.

    Additionally, you can download a CSV file with the roles information and you can also upload a CSV file to assign or revoke roles.

    💻 Image

    image.png

    Effective roles

    Hierarchy of permissions assigned to or inherited. 

    This screen details the effective roles for the selected account.

    • By direct assignment of the role: when you assign a role to an account, you are assigning to the account all the permissions defined for that role.
    • By belonging to a group: when you add a user to a group, the user will have all the roles assigned to the group.
    • By rules defined in the system: when a rule is satisfied for a user, the system assigns the roles defined in the rule to the user.
    💻 Image

    image.png

    Actions

    Account query actions

    Query

    Allows you to query accounts through different search systems, Quick, Basic and Advanced.

    Add or remove columns

    Allows you to show and hide columns in the table. You can also set the order in which the columns will be displayed. The selected columns and order will be saved for the next time Soffid displays the page to the user.

    Add new

    Allows you to add a new account in the system. You can choose that option on the hamburger icon or click the add button (+).To add a new account it will be mandatory to fill in the required fields

    Delete

    Allows you to remove one or more accounts by selecting one or more records and next clicking the button with the subtraction symbol (-).To perform that action, Soffid will ask you for confirmation, you could confirm or cancel the operation.

    Download CSV file

    Allows you to download a CSV file with the basic information of all accounts. 

    Bulk actions

    Allows massive operations to be performed on all system accounts.  With that operation, updates can be made to any of the account's parameters. First of all, you must select the records that you want to update, once you have selected them, you must choose the bulk action on the hamburger icon. For more information visit the Bulk action page.

    Account detail actions

    Apply changes

    Allows you to save the data of a new account or to update the data of a specific account. To save the data it will be mandatory to fill in the required fields

    Delete

    Allow you to remove the account. You can choose that option on the hamburger icon

    To perform that action, Soffid will ask you for confirmation, you could confirm or cancel the operation.

    Undo

    Allows you to quit without applying any changes.

    Set password

    This option depends on the credential type selected.

    Password: 

    • Allows you to set a new password to the account or a SSH key.
    • The password can be generated automatically, or you can set the password. 
    • It will be mandatory the password complies with the Password policies defined for the domain.
    • If an account is unmanaged, the password will not be sent to the target  system.
    💻 Image

    image.png


    SSH key:

    • Allows you to generate a new key or enter an existing key.
    💻 Image

     

     Kubernetes key:

    •  Allows you to  add a YAML descriptor


    💻 Image

     

    Show actual account properties

    Display the account attributes at the target system. To perform that action, Soffid needs to connect with the target system and get the account attributes that will be shown.
    Expand all Displays all the attributes of the different blocks.
    Collapse all Hide all attributes of the different blocks.
    "Types of views" Change the view type: Classic view, Modern view, Compact design.
    Roles

    Assign Role

    Allows you to assign a new role to the account. You can choose that option on the hamburger menu or click the add button (+).

    Then you need to select a role from the role list. If it is necessary, the next step will be to set the scope. Then you need to check and fill in the membership properties. And finally, apply changes.

    Revoke Role

    Allows you to revoke one by one or to revoke some roles at the same time.

    To revoke some roles at the same time, you need to select the roles, and then click the button with the subtraction symbol (-).

    To revoke one role, you can click the role, and then Soffid will show a form with the details. Then you can click the delete button (trash icon).

    Soffid will ask you for confirmation to perform that action, you could confirm or cancel the operation.

    Import

    Allows you to upload a CSV file with the role list to assign permission.

    First, you need to pick up a CSV file, that CSV has to contain a specific configuration. Then you need to check the content to be loaded, it is allowed to choose if you want or not load a specific attribute. And finally, you need to select the mappings for each column of the CSV file to import the data correctly and to click the Import button.

    Download CSV file

    Allows you to download a CSV file with all the information about account roles. 


    Back to top