To enable the sending of ATNA audit messages
from message flows on your integration node, use a configurable service to
add ATNA configuration details to your integration node, including the location of the ATNA audit repository.
About this task
You must create a UserDefined configurable service to configure settings that are used by
the ATNAAudit nodes in all the message flows that run on your
integration node.
Procedure
To create a new configurable service that controls the
settings used by your ATNAAudit nodes,
complete the following steps:
- Create a new UserDefined configurable service named ATNA,
see: Creating a configurable
service in the IBM® Integration Bus product
documentation
Note: The configurable
service must be named ATNA.
- Create a property for each element in the following table
and assign appropriate values to the properties.
Note: The
configurable service must contain each of the properties that is listed
in the table, even if they are entered with an empty value. If any
property that is listed in the table is missing from the configurable
service, your ATNAAudit nodes
produce an error and fail to start.
Property |
Value |
Example |
auditEnabled |
true if audit messages
should be sent to the repository, or false if
no audit messages should be sent. Note: ATNA audit messages are only
sent from an ATNAAudit node
when the auditEnabled property is set to true in
the configurable service and the Audit enabled property
is selected in the ATNAAudit node,
see ATNAAudit node.
|
true |
auditEnterpriseSiteID |
Any text value. This value is used in the
AuditSourceIdentification element of ATNA
audit messages as the value of AuditEnterpriseSiteID for all messages sent by the
integration node. |
MySiteName |
auditHumanRequestor |
Any text value. This value is used in the ActiveParticipant
element of ATNA audit messages as the value of
UserID for all messages sent by the integration node. This
value is only used in audit messages that have a human requestor. |
Admin |
auditRepositoryURI |
URI of the audit repository to which messages
are sent, including the transport (UDP or TLS), the address and the
port. |
udp://myrepository.myorg.com:3001 |
auditSourceID |
Any text value. This value is used in the
AuditSourceIdentification element of ATNA
audit messages as the value of AuditSourceID for all messages sent by the integration node. |
OTHER_MYCO |
auditSystemAlternativeUserID |
Any text value. This value is used in the ActiveParticipant element
of the ATNA audit message
as the value of AlternativeUserID for all messages
sent by the system. This value correlates to either the source or
destination participant, depending on the transaction. Note In IHE
audit transactions, this is defined as the JVM's process ID for the
sending system participant. If you leave this value empty, the node
will attempt to resolve and use the process ID. |
MyAltUserID |
auditSystemUserID |
Any text value. This value is used in the ActiveParticipant element
of the ATNA audit message
as the value of UserID for all messages sent by the
system. This value correlates to either the source or destination
participant, depending on the type of audit message and transaction. |
MyUserID |
auditSystemUserName |
Any text value. This value is used in the ActiveParticipant element
of the ATNA audit message
as the value of UserName for all messages sent by
the system. In transactions involving XUA, this field is overwritten
with the properly-formatted XUA username contained in the XML audit
message. |
MyUserName |
Results
You have configured your integration node so that ATNA audit messages can be sent to an ATNA audit repository from message flows running on the integration node.