What is the difference between events and commands?#
The distinction is subtle but important. Many of the possible child elements of <input> can be interpreted either as commands or as events, depending on the context, and have essentially the same syntax.
In general, for elements that can be used as either a command or as notification of an event the following applies:
- If the element is being sent to the shim (ie Connected Application) then the element is a command
- If the element is being sent to Identity Manager (ie EDirectory) then the element is an event notification.
When the shim sends an event notification to Identity Manager the shim is informing Identity Manager of something that occurred in the application. Identity Manager will then determine, based on configurable policies, which commands, if any, must be sent to the Identity Vault. When Identity Manager sends a command to the shim, Identity Manager has already taken an Identity Vault event as input, applied the appropriate policies, and determined that the change in the application represented by the command is necessary.