Technical Account Module - Technical Assets

Overview

The 'Technical Asset' extends CzechIdM's technical account module capabilities by introducing a new entity type that groups and manages technical accounts. This module enables organizations to associate technical accounts with specific assets, assign guarantors and holders through both direct assignment and role-based mechanisms, and implement comprehensive audit trails for all operations.

Purpose

  • Centralize management of technical accounts under logical asset groupings
  • Enable role-based access control for asset-related operations
  • Provide audit capabilities for compliance requirements
  • Support notifications via NOTIFY event

Entities

┌──────────────────┐      ┌────────────────┐
│ TechnicalAccount │◄─ ─ ─│ TechnicalAsset │
└──────────────────┘      └────────────────┘
                                   │
                                   │      ┌─────────────────────────┐
                                   ├─────►│ TechnicalAssetGuarantor │◄────────┐
                                   │      └─────────────────────────┘         │     ┌─────────────┐
                                   │                                          ├─────│ IdmIdentity │
                                   │      ┌──────────────────────┐            │     └─────────────┘
                                   ├─────►│ TechnicalAssetHolder │◄───────────┘
                                   │      └──────────────────────┘
                                   │
                                   │      ┌─────────────────────────────┐
                                   ├─────►│ TechnicalAssetGuarantorRole │◄────┐
                                   │      └─────────────────────────────┘     │     ┌─────────┐
                                   │                                          ├─────│ IdmRole │
                                   │      ┌──────────────────────────┐        │     └─────────┘
                                   └─────►│ TechnicalAssetHolderRole │◄───────┘
                                          └──────────────────────────┘

The technical account has been extended with an optional attribute specifying which technical asset it belongs to. If a technical asset becomes disabled, the technical accounts belonging to it will become disabled as well. Note that this doesn't work in reverse - if a technical asset becomes enabled again, its technical accounts will stay disabled until set to enabled manually.

AttributeTypeDescription
technicalAssetUUIDoptional attribute specifying which technical asset the technical account belongs to
EvaluatorTypeDescriptionAttributes
TechnicalAccountByTechnicalAssetGuarantorEvaluatorRegularReturns technical accounts where the logged user is a guarantor of the parent technical asset - either directly by identity or indirectly by role. Technical accounts without an assigned technical asset are never matched by this evaluator.No attributes
TechnicalAccountByTechnicalAssetHolderEvaluatorRegularReturns technical accounts where the logged user is a holder of the parent technical asset - either directly by identity or indirectly by role. Technical accounts without an assigned technical asset are never matched by this evaluator.No attributes
TechnicalAccountByTechnicalAssetTransitiveEvaluatorTransitiveReturns technical accounts where the logged user has access to the parent technical asset. Permissions are transitively derived from the technical asset the technical account belongs to. Technical accounts without an assigned technical asset are never matched by this evaluator.Transfer permissions - a list of permissions to be transferred from a technical asset to its technical accounts; if the list is empty, all permissions held by the user for the given technical asset will be transferred to its technical accounts

The overview of technical accounts can be accessed via the "Systems" and "Accounts" agendas in the main menu. The technical accounts in this agenda can be filtered by the technical asset they belong to, as well as by the rest of their properties.

The primary entity representing a technical asset that can contain multiple technical accounts.

AttributeTypeDescription
idUUIDprimary identifier
nameStringasset name
descriptionStringasset description
disabledBooleanflag indicating whether the asset is disabled
externalIdStringidentifier assigned by an external system for integration purposes
externalCodeStringcode from an external system
validFromLocalDatevalidity start date
validTillLocalDatevalidity end date
Permission Description
ADMIN all permissions
COUNT permission to retrieve the count of entities
AUTOCOMPLETE permission to display the entity in autocomplete suggestions
READ permission to read the entity
CREATE permission to create the entity
UPDATE permission to edit entity attributes
DELETE permission to delete the entity
SETTOTECHNICALACCOUNT permission to assign a technical account to the given Technical Asset
TAMANUALLYENABLE permission to activate a manually deactivated Technical Asset
TAMANUALLYDISABLE permission to manually deactivate a Technical Asset
EvaluatorTypeDescriptionAttributes
TechnicalAssetByGuarantorEvaluatorRegularReturns technical assets where the logged user is a guarantor - either directly by identity or indirectly by role.No attributes
TechnicalAssetByHolderEvaluatorRegularReturns technical assets where the logged user is a holder - either directly by identity or indirectly by role.No attributes

Represents direct assignment of an identity as guarantor for a technical asset.

AttributeTypeDescription
idUUIDprimary identifier
externalIdStringidentifier assigned by an external system for integration purposes
technicalAssetUUIDid of the technical asset to be guaranted
guarantorUUIDid of the user to be guarantor
PermissionDescription
ADMINall permissions
COUNTpermission to retrieve the count of entities
AUTOCOMPLETEpermission to display the entity in autocomplete suggestions
READpermission to read the entity
CREATEpermission to create the entity
UPDATEpermission to edit entity attributes
DELETEpermission to delete the entity
EvaluatorTypeDescriptionAttributes
TechnicalAssetGuarantorByTechnicalAssetGuarantorEvaluatorRegularReturns technical asset guarantors where the logged user is a guarantor of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetGuarantorByTechnicalAssetHolderEvaluatorRegularReturns technical asset guarantors where the logged user is a holder of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetGuarantorByTechnicalAssetTransitiveEvaluatorTransitiveReturns technical asset guarantors where the logged user has access to the parent technical asset. Permissions are transitively derived from the technical asset the technical asset guarantor belongs to.Transfer permissions - a list of permissions to be transferred from a technical asset to its guarantors; if the list is empty, all permissions held by the user for the given technical asset will be transferred to its guarantors

Represents the assignment of a role to a technical asset, where granting this role to a user designates them as a guarantor of that asset

AttributeTypeDescription
idUUIDprimary identifier
externalIdStringidentifier assigned by an external system for integration purposes
technicalAssetUUIDid of the technical asset to be guaranted
roleUUIDid of the role which, when assigned to a user, makes them a guarantor
PermissionDescription
ADMINall permissions
COUNTpermission to retrieve the count of entities
AUTOCOMPLETEpermission to display the entity in autocomplete suggestions
READpermission to read the entity
CREATEpermission to create the entity
UPDATEpermission to edit entity attributes
DELETEpermission to delete the entity
EvaluatorTypeDescriptionAttributes
TechnicalAssetGuarantorRoleByTechnicalAssetGuarantorEvaluatorRegularReturns technical asset guarantor roles where the logged user is a guarantor of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetGuarantorRoleByTechnicalAssetHolderEvaluatorRegularReturns technical asset guarantor roles where the logged user is a holder of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetGuarantorRoleByTechnicalAssetTransitiveEvaluatorTransitiveReturns technical asset guarantor roles where the logged user has access to the parent technical asset. Permissions are transitively derived from the technical asset the technical asset guarantor role belongs to.Transfer permissions - a list of permissions to be transferred from a technical asset to its guarantor roles; if the list is empty, all permissions held by the user for the given technical asset will be transferred to its guarantor roles

Represents direct assignment of an identity as holder for a technical asset.

AttributeTypeDescription
idUUIDprimary identifier
externalIdStringidentifier assigned by an external system for integration purposes
technicalAssetUUIDid of the technical asset to be managed
holderUUIDid of the user to be holder
PermissionDescription
ADMINall permissions
COUNTpermission to retrieve the count of entities
AUTOCOMPLETEpermission to display the entity in autocomplete suggestions
READpermission to read the entity
CREATEpermission to create the entity
UPDATEpermission to edit entity attributes
DELETEpermission to delete the entity
EvaluatorTypeDescriptionAttributes
TechnicalAssetHolderByTechnicalAssetGuarantorEvaluatorRegularReturns technical asset holders where the logged user is a guarantor of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetHolderByTechnicalAssetHolderEvaluatorRegularReturns technical asset holders where the logged user is a holder of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetHolderByTechnicalAssetTransitiveEvaluatorTransitiveReturns technical asset holders where the logged user has access to the parent technical asset. Permissions are transitively derived from the technical asset the technical asset holder belongs to.Transfer permissions - a list of permissions to be transferred from a technical asset to its holders; if the list is empty, all permissions held by the user for the given technical asset will be transferred to its holders

Represents the assignment of a role to a technical asset, where granting this role to a user designates them as a holder of that asset

AttributeTypeDescription
idUUIDprimary identifier
externalIdStringidentifier assigned by an external system for integration purposes
technicalAssetUUIDid of the technical asset to be guaranted
roleUUIDid of the role which, when assigned to a user, makes them a holder
PermissionDescription
ADMINall permissions
COUNTpermission to retrieve the count of entities
AUTOCOMPLETEpermission to display the entity in autocomplete suggestions
READpermission to read the entity
CREATEpermission to create the entity
UPDATEpermission to edit entity attributes
DELETEpermission to delete the entity
EvaluatorTypeDescriptionAttributes
TechnicalAssetHolderRoleByTechnicalAssetGuarantorEvaluatorRegularReturns technical asset holder roles where the logged user is a guarantor of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetHolderRoleByTechnicalAssetHolderEvaluatorRegularReturns technical asset holder roles where the logged user is a holder of that technical asset - either directly by identity or indirectly by role.No attributes
TechnicalAssetHolderRoleByTechnicalAssetTransitiveEvaluatorTransitiveReturns technical asset holder roles where the logged user has access to the parent technical asset. Permissions are transitively derived from the technical asset the technical asset holder role belongs to.Transfer permissions - a list of permissions to be transferred from a technical asset to its holder roles; if the list is empty, all permissions held by the user for the given technical asset will be transferred to its holder roles

The overview of technical assets can be accessed via the "Technical assets" agenda in the main menu.

Column Description
NameName of the technical asset, unique across all technical assets
DescriptionDescription of the technical asset
GuarantorsGuarantors of the technical asset, including those listed directly and those who are guarantors via an assigned guarantor role. To prevent overcrowding, the list is truncated to 5 identities.
HoldersHolders of the technical asset, including those listed directly and those who are holders via an assigned holder role. To prevent overcrowding, the list is truncated to 5 identities.
Valid fromStart date of the technical asset's validity
Valid tillEnd date of the technical asset's validity
InactiveFlag indicating that the technical asset is inactive
Filter Description
Name or descriptionEnables full-text search within the name and description of the technical asset
Valid fromEnables searching for technical assets with a specific validity start date
Valid tillEnables searching for technical assets with a specific validity end date
GuarantorEnables searching for technical assets by guarantor (either direct or via a role)
HolderEnables searching for technical assets by holder (either direct or via a role)
InactiveEnables searching only for active or only for inactive technical assets
Bulk action Description Required permission
ReportBasic export of technical assetsalways available
Delete technical assetAllows deletion of technical assets, including subordinate entities (direct guarantors/holders and those via role). If the technical asset is assigned to technical accounts, this association is deleted.Delete
If you want to delete technical accounts assigned to a specific Technical Asset, you need to do it manually. Deleting is a destructive operation, that also results in deleting the accounts on end systems, so IdM is not doing it automatically.

After clicking on the magnifying glass icon or the name of a technical asset in the technical asset table, the detail view of the given technical asset is displayed, with "Basic information" as the default sub-agenda. If the user has the Update permission for a technical asset, they can edit the fields.

To deactivate/activate a technical asset, the user needs the TAMANUALLYDISABLE and TAMANUALLYENABLE permissions. Otherwise the respective button won't be displayed.

FieldDescription
NameName of the technical asset, unique across all technical assets
DescriptionDescription of the technical asset
Valid fromStart date of the technical asset's validity
Valid tillEnd date of the technical asset's validity
InactiveFlag indicating that the technical asset is inactive

The "Technical accounts" sub-agenda contains an overview of all technical accounts under the given technical asset.

Column Description
Account identifierAccount identifier on the system
System nameName of the system to which the technical account provides access
Account guarantorsGuarantors of the technical account, including those listed directly and those who are guarantors via an assigned guarantor role
Valid fromStart date of the technical account's validity
Valid tillEnd date of the technical account's validity
Is protected from deleteFlag indicating that the technical account is protected from deletion (it is in quarantine)
Protected untillDate until which the technical account is protected from deletion (when the quarantine expires and the account will be deleted)
FilterDescription
Account identifierEnables searching by technical account name; an exact match is required
SystemEnables searching by the name of the system to which the technical account provides access.
Technical account typeEnables searching by system mapping
Account guarantorEnables searching for technical accounts by guarantor (either direct or via a role)
Valid fromEnables searching for technical accounts with a specific validity start date
Valid tillEnables searching for technical accounts with a specific validity end date
Protected from deletionEnables searching only for technical accounts that are in quarantine, or only for those that are not
Bulk actionDescriptionRequired permissions
ReportBasic export of technical accountsalways available

This sub-agenda allows you to manage the direct guarantors of the technical asset, as well as guarantor roles, the assignment of which makes a user a guarantor.

This sub-agenda allows you to manage the direct holders of the technical asset, as well as holder roles, the assignment of which makes a user a holder.

This sub-agenda displays the audit log for the technical asset and its related entities.

ColumnDescription
Entity typeType of entity upon which the action was performed
Entity (IdM)Entity upon which the action was performed
Sub owner codeCode of the secondary related entity
ActionType of performed action
Executed byUsername of the user who performed the action
Date of revisionDate and time when the action was performed
Changed attributesList of attributes changed during the action
FilterDescriptin
DateEnables searching for actions performed within a specific period
Entity typeEnables searching by the type of entity upon which the action was performed.
Executed byEnables searching by the username of the user who performed the action; an exact match is required
Own group search by changed attributesEnables searching for actions during which the given list of attributes was changed

The audit table has no bulk actions.

  • by otmara