# ShadowType (Complex Type)

### Namespace: http://midpoint.evolveum.com/xml/ns/public/common/common-3

Supertype: ObjectType
Local copy of any object on the provisioning resource that is related to provisioning. It may be account, group, role (on the target system), privilege, security label, organizational unit or anything else that is worth managing in identity management. In the minimal form it contains only identifiers and meta-data, but it may also be used for locally caching the account data (in local repository). This XML object provides a representation of the resource object in the IDM system, in the LOCAL REPOSITORY. It may represent a minimal data structure in IDM repository that contains only identifier and nothing else. It may also represent a rich structure with a lot of cached or fetched data. The actual content of this object depends on usage: on the specific interface and operation used and even on the system state and configuration.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
name | property PolyStringType | [0,1] | Human-readable, mutable name of the object.
description | property string | [0,1] | Free-form textual description of the object.
documentation | property string | [0,1] | AsciiDoc-formatted technical documentation of the object.
subtype | property string | [0,-1] | Type of the object.
fetchResult | property OperationResultType | [0,1] | Result of the operation that fetched this instance of the object.
extension | container ExtensionType | [0,1] | Extension container that provides generic extensibility mechanism.
parentOrgRef | reference ObjectReferenceType | [0,-1] | Set of the orgs (organizational units, projects, teams) that the object relates to.
trigger | container TriggerType | [0,-1] | Triggers for this object.
metadata | container MetadataType | [0,1] | Meta-data about object creation, modification, etc.
tenantRef | reference ObjectReferenceType | [0,1] | Reference to the tenant to which this object belongs.
lifecycleState | property string | [0,1] | Lifecycle state of the object.
operationExecution | container OperationExecutionType | [0,-1] | Description of recent operations executed on this object (or related objects in special cases).
lensContext | container LensContextType | [0,1] | Model context describing executed operation
policySituation | property anyURI | [0,-1] | The policy situation(s) of this object.
triggeredPolicyRule | property EvaluatedPolicyRuleType | [0,-1] | Triggered policy rules for this object.
policyException | container PolicyExceptionType | [0,-1] | Recorded exception from a policy rule.
diagnosticInformation | property DiagnosticInformationType | [0,-1] | Diagnostic information attached to this object.
indestructible | property boolean | [0,1] | Protection against accidental deletion.
effectiveMarkRef | reference ObjectReferenceType | [0,-1] | Object marks assigned to the shadow.
policyStatement | container PolicyStatementType | [0,-1] | Policy statements to manually add or exclude effective marks of shadow.
effectiveOperationPolicy | container ObjectOperationPolicyType | [0,1] | Effective provisioning policy derived from Shadow marks and resource configuration.
resourceRef | reference ObjectReferenceType | [0,1] | Reference to a resource that this resource object shadow belongs to.
shadowLifecycleState | property ShadowLifecycleStateType | [0,1] | The state in the shadow lifecycle.
purpose | property ShadowPurposeType | [0,1] | Purpose for existence (or non-existence) of a resource object referenced by the shadow.
dead | property boolean | [0,1] | Description of operation during the processing of account failed.
deathTimestamp | property dateTime | [0,1] | When we learned about the fact that the shadow is dead? The reason behind this property is to be able to distinguish "freshly dead" shadows so that full synchronization may be invoked if this timestamp is after fullSynchronizationTimestamp.
pendingOperation | container PendingOperationType | [0,-1] | Description of an operation which execution is pending for this shadow.
synchronizationSituation | property SynchronizationSituationType | [0,1] | The most recent synchronization situation.
synchronizationTimestamp | property dateTime | [0,1] | The timestamp of the most recent synchronization.
fullSynchronizationTimestamp | property dateTime | [0,1] | The timestamp of the most recent full synchronization.
synchronizationSituationDescription | property SynchronizationSituationDescriptionType | [0,-1] | Complex description of synchronization situations.
correlation | container ShadowCorrelationStateType | [0,1] | State of the shadow correlation process.
objectClass | property QName | [0,1] | The reference to a type definition for this object.
primaryIdentifierValue | property string | [0,1] | Value of the primary (unique) identifier; converted to a string if it's of a different type.
auxiliaryObjectClass | property QName | [0,-1] | The reference to additional type definitions for this object.
kind | property ShadowKindType | [0,1] | Kind of a shadow.
intent | property string | [0,1] | The intended usage type or purpose of the object.
tag | property string | [0,1] | Tag value used to discriminate multiple accounts that have the same resource+kind+intent combination.
protectedObject | property boolean | [0,1] | Protected shadows cannot be changed.
ignored | property boolean | [0,1] | Ignored shadows will not be processed during synchronization.
assigned | property boolean | [0,1] | Set to true if the object is "legally" assigned, i.
exists | property boolean | [0,1] | Set to true if the object is known to exist on the resource.
iteration | property int | [0,1] |
iterationToken | property string | [0,1] |
attributes | container ShadowAttributesType | [0,1] | Attributes of this shadow.
referenceAttributes | container ShadowReferenceAttributesType | [0,1] | Reference attributes.
associations | container ShadowAssociationsType | [0,1] | Associations of this shadow.
association | container ShadowAssociationType | [0,-1] | Legacy associations of this shadow.
activation | container ActivationType | [0,1] | TODO For more details see the ActivationType documentation.
credentials | container CredentialsType | [0,1] | The set of account credentials (such as passwords).
cachingMetadata | property CachingMetadataType | [0,1] | The shadow is essentially a bunch of metadata and cached data about the actual resource object.
contentDescription | property ShadowContentDescriptionType | [0,1] | Describes the content of the shadow, mainly regarding the source (repository / resource), plus other limitations.
behavior | container ShadowBehaviorType | [0,1] | Shadow behavioral data.

- ### Items

  - #### name

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Human-readable, mutable name of the object. It may also be an identifier (login name, group name). It is usually unique in the respective context of interpretation. E.g. the name of the UserType subtype is usually unique in the whole system. The name of the ShadowType subtype is usually unique in the scope of resource (target system) that it belongs to.

    The name may not be human-readable in a sense to display to a common end-user. It is intended to be displayed to IDM system administrator. Therefore it may contain quite a "ugly" structures such as LDAP DN or URL.

    Name is mutable. It is considered to be ordinary property of the object. Therefore it can be changed by invoking usual modifyObject operations. However, change of the name may have side effects (rename process).

    Although name is specified as optional by this schema, it is in fact mandatory for most object types. The reason for specifying the name as optional is that the name may be generated by the system instead of supplied by the clients. However, all objects stored in the repository must have a name.

  - #### description

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Free-form textual description of the object. This is meant to be displayed in the user interface.

  - #### documentation

    Flags: RAM,runtime

    Multiplicity: [0,1]

    AsciiDoc-formatted technical documentation of the object.

  - #### subtype

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Type of the object. It is used to distinguish what a specific object represents. Whether it is a different kind of organizational unit, project, team, or different kind of user, etc.

  - #### fetchResult

    Flags: RAM,runtime,oper

    Multiplicity: [0,1]

    Result of the operation that fetched this instance of the object. It is mostly used to indicate that the object is not complete or there is some problem with the object. This is used instead of exception if the object is part of larger structures (lists as in list/search operations or composite objects). If not present then the "SUCCESS" state is assumed.

    This field is TRANSIENT. It must only be used in runtime. It should never be stored in the repository.

  - #### extension

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Extension container that provides generic extensibility mechanism. Almost any extension property can be placed in this container. This mechanism is used to extend objects with new properties. The extension is treated exactly the same as other object properties by the code (storage, modifications, etc), except that the system may not be able to understand their meaning.

  - #### parentOrgRef

    Flags: RAM,oper

    Multiplicity: [0,-1]

    Set of the orgs (organizational units, projects, teams) that the object relates to. This usually means that the object belongs to them but it may have other meanings as well (e.g. user manages an organizational unit).

  - #### trigger

    Flags: RAM,runtime,oper

    Multiplicity: [0,-1]

    Triggers for this object. They drive invocations of corresponding trigger handlers at specified time.

  - #### metadata

    Flags: RAM,runtime,oper

    Multiplicity: [0,1]

    Meta-data about object creation, modification, etc.

  - #### tenantRef

    Flags: RAM,oper

    Multiplicity: [0,1]

    Reference to the tenant to which this object belongs. It is a computed value set automatically by midPoint. It is determined from the organizational structure. Even though this value is computed it is also stored in the repository due to performance reasons.

  - #### lifecycleState

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Lifecycle state of the object. This property defines whether the object represents a draft, proposed definition, whether it is active, deprecated, archived, and so on. See "Object Lifecycle" in the documentation.

  - #### operationExecution

    Flags: RAM,runtime,oper

    Multiplicity: [0,-1]

    Description of recent operations executed on this object (or related objects in special cases). The number of operations to be kept here is configurable.

  - #### lensContext

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Model context describing executed operation

  - #### policySituation

    Flags: RAM,runtime,oper

    Multiplicity: [0,-1]

    The policy situation(s) of this object. The situations are result of evaluation of the policy rules. This property is recorded for each object and can be used for reporting, diagnostics, target selection in certification campaigns, etc.

  - #### triggeredPolicyRule

    Flags: RAM,runtime,oper

    Multiplicity: [0,-1]

    Triggered policy rules for this object. (Not necessarily complete; subject to specified storage strategy.) This is EXPERIMENTAL functionality. It is possibly to change in the near future.

  - #### policyException

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Recorded exception from a policy rule. The exceptions that are approved are recoded here to avoid re-evaluating and re-approving them all the time. This is EXPERIMENTAL functionality. It is likely to change in the near future.

  - #### diagnosticInformation

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Diagnostic information attached to this object.

  - #### indestructible

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Protection against accidental deletion. If set to true then this object cannot be deleted. If the object needs to be deleted then it has to be modified first to reset this flag.

  - #### effectiveMarkRef

    Flags: RAM

    Multiplicity: [0,-1]

    Object marks assigned to the shadow. When stored in the repository, this includes appied policy statements.

  - #### policyStatement

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Policy statements to manually add or exclude effective marks of shadow.

  - #### effectiveOperationPolicy

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Effective provisioning policy derived from Shadow marks and resource configuration. Currently supported for shadows only. Transient: not stored in the repository.

  - #### resourceRef

    Flags: RAM

    Multiplicity: [0,1]

    Reference to a resource that this resource object shadow belongs to.

  - #### shadowLifecycleState

    Flags: RAM,runtime,AVals:7

    Multiplicity: [0,1]

    The state in the shadow lifecycle. Always related to the current point of time, regardless of the point-in-time setting in get/search operation options. (E.g. an account retrieved with the point-in-time = future that has a pending DELETE operation will be returned with dead=true, but shadowLifecycleState will be reaping.) Currently TRANSIENT, i.e. it is not stored in the repository.

  - #### purpose

    Flags: RAM,runtime,AVals:2

    Multiplicity: [0,1]

    Purpose for existence (or non-existence) of a resource object referenced by the shadow. E.g. it specifies whether the resource object is fully operational, whether it is not completely prepared yet, it may indicate why we are keeping the resource object instead of deleting it, and so on. It can be thought of as a "business lifecycle", specifying the reason for this object or shadow. This information is maintained by midPoint, it is not directly projected to the resource. This information supplements the resource object data, it keeps additional information that the resource does not have. It is different from shadowLifecycleState, as shadowLifecycleState specifies the technical state in which resource object is (e.g. not created yet, not deleted yet). On the other hand, purpose represents the business information, the reason or intention that we have with the object. For example, "incomplete" purpose describes an account that is technically in a perfect shape, technically fully operation, yet user is not able to use that account yet. This is also different from the regular lifecycleState. The lifecycleState of a shadow is meant to be reflected directly to resource object. E.g. lifecycleState of a shadow should be taken from lifecycle state of account, from one of its attributes (similarly to administrativeStatus). On the other hand, "purpose" is an information kept only by midPoint, not directly synchronized to the resource. The "purpose" will work for all resources, regardless of whether they support lifecycle state (and its fidelity), activation or any other details.

  - #### dead

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Description of operation during the processing of account failed.

  - #### deathTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    When we learned about the fact that the shadow is dead? The reason behind this property is to be able to distinguish "freshly dead" shadows so that full synchronization may be invoked if this timestamp is after fullSynchronizationTimestamp. (In the future, though, we should make synchronization reactions more "declarative" so that all dead shadows could be synchronized. But that is a longer-term plan.)

  - #### pendingOperation

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Description of an operation which execution is pending for this shadow. This may be asynchronous operation in progress. E.g. operation that has to be manually completed by human operator. It may also be operation that could not be completed because there was a temporary error while communicating with the resource. There may be also operations that are in fact already executed, but we have not yet received the feedback. Or operations that are executed but are still kept in the shadow for review by midPoint administrator.

  - #### synchronizationSituation

    Flags: RAM,runtime,AVals:5

    Multiplicity: [0,1]

    The most recent synchronization situation. Regardless of the channel. This simple enumeration property is used for (indexed) search of shadows in certain situation. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.

  - #### synchronizationTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The timestamp of the most recent synchronization. Regardless of the channel or result. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.

  - #### fullSynchronizationTimestamp

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The timestamp of the most recent full synchronization. Regardless of the channel or result. It does not provide any further details. More details can be found in the "synchronizationSituationDescription" property.

  - #### synchronizationSituationDescription

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Complex description of synchronization situations. This is multi-valued property and it should store only a single value for each channel (the most recent one). All the older values should be removed on each update.

  - #### correlation

    Flags: RAM,runtime

    Multiplicity: [0,1]

    State of the shadow correlation process. It contains statistical data (e.g. start/end timestamps), result of the (last) correlation - determined situation, candidate owner(s), performer OIDs and their comments - as well as correlator-specific data, like ID Match request and reference IDs. Relevance of the data: The data are deleted when the new correlation process starts after the previous one ended. This fact is determined by checking that the correlationEndTimestamp (set by the previous correlation process) has a non-null value. However, until that time, we must keep the data intact. For example, ID Match correlation typically uses correlatorState/referenceId property as a kind of unique user identifier that is to be used in an inbound mapping.

  - #### objectClass

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The reference to a type definition for this object. The reference should point to the object class definition (complex type definition in resource schema). The attributes contained in the "attributes" element below are expected to comply with the type definition specified in this element (with addition of auxiliary object class definitions). Formally, minOccurs is 0 here but unless a reasonable default is provided, the value must be present.

  - #### primaryIdentifierValue

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Value of the primary (unique) identifier; converted to a string if it's of a different type.

  - #### auxiliaryObjectClass

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    The reference to additional type definitions for this object. The reference should point to object class definition (complex type definition in resource schema) and this definition should be marked as auxiliary. The attributes contained in the "attributes" element below are expected to comply with the type definition specified in the objectClass element merged with definitions specified in this element.

  - #### kind

    Flags: RAM,runtime,AVals:5

    Multiplicity: [0,1]

    Kind of a shadow. This means the type of shadow use. E.g. an account, entitlement, etc.

  - #### intent

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The intended usage type or purpose of the object. E.g. for accounts it may be "user", "admin", "test".

  - #### tag

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Tag value used to discriminate multiple accounts that have the same resource+kind+intent combination.

  - #### protectedObject

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Protected shadows cannot be changed. They are out of IDM control. This is only informational property. Changing it will have no effect on whether object is protected or not. Object protection is a strict policy that cannot be easily overridden. This is "virtual" property. It is not stored in the repository.

  - #### ignored

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Ignored shadows will not be processed during synchronization.

  - #### assigned

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Set to true if the object is "legally" assigned, i.e. if there is a valid assignment for this object. It shows the value from the last recompute of the object.

  - #### exists

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Set to true if the object is known to exist on the resource. There may be shadows for objects that do not exist yet (e.g. create operations in progress) or shadows for objects that we know nothing about yet.

  - #### iteration

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### iterationToken

    Flags: RAM,runtime

    Multiplicity: [0,1]

  - #### attributes

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Attributes of this shadow. The exact form depends on the context: 1. For resource-level shadows, both simple and reference attributes are here. 2. For model-level shadows, the simple attributes are here, and MAYBE the reference ones as well. (After they were converted into associations.) 3. For repository-level shadows, only the simple attributes are here. The reference ones are moved (at least for now) into "referenceAttributes" container.

  - #### referenceAttributes

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Reference attributes. Present only in the repository-level shadows.

  - #### associations

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Associations of this shadow. Present only in model-level shadows.

  - #### association

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Legacy associations of this shadow. Not used anymore.

  - #### activation

    Flags: RAM,runtime

    Multiplicity: [0,1]

    TODO For more details see the ActivationType documentation.

  - #### credentials

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The set of account credentials (such as passwords).

  - #### cachingMetadata

    Flags: RAM,runtime

    Multiplicity: [0,1]

    The shadow is essentially a bunch of metadata and cached data about the actual resource object. This caching metadata structure describes when the cached data were retrieved - therefore how fresh they are.

  - #### contentDescription

    Flags: RAM,runtime,oper,AVals:5

    Multiplicity: [0,1]

    Describes the content of the shadow, mainly regarding the source (repository / resource), plus other limitations. Transient property, not to be stored in the repository.

  - #### behavior

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Shadow behavioral data. In a more specific meaning: behavioral data of an agent (user or system), usually represented in midPoint by shadow. This data structure records informational data about the agent's behavior, such as authentications, interaction with external systems and so on. Such data are inherently _observed_, e.g. they are not configured by the user.