local interface TransportInitiator
inherits from TransportSecurity::CredentialsInitiator
An object of the TransportInitiator interface
is associated with Transport OwnCredentials.
Its operations create or reuse secure context
establishers.
readonly attribute ContextEstablisherList context_establishers;The context_establishers attribute contains a list of available context establishers.
readonly attribute unsigned long high_port;The high_port attribute represents the high end of the range of ports from which the establisher will try to allocate.
readonly attribute string host;This is IIOP after all, so we list the host/network interface device from which this establisher will establish contexts.
readonly attribute unsigned long low_port;The low_port attribute represents the low end of the range of ports from which the establisher will try to allocate.
ListenerId add_initiating_context_establishment_listener(in InitiatingContextEstablishmentListener listener);The add_initiating_context_establishment_listener operation adds an initiating listener, which is called when new contexts are established with the context establishers that are created by this initiator. The listener is given a Listener identifier that can only be used to remove the listener.
These listeners are needed by certain auditing functions.
ContextEstablisherList create_context_establishers(in string host,
in unsigned long port,
in CredsDirective creds_directive,
in FeatureDirective client_authentication,
in FeatureDirective target_authentication,
in FeatureDirective confidentiality,
in FeatureDirective integrity,
in CSIVersion csi_version,
in IOP::TaggedComponentSeq transport_components);
The create_context_establishers operation is used by the
Transport Security framework to create a set of NEW
ContextEstablishers.
void decrement_work();The decrement_work operation is used by the ClientRequestInterceptor when a request is done.
ContextEstablisher get_context_establisher(in ContextEstablisherId id);FOR INTERNAL USE OWNLY. This operation returns the context establisher for its identifier. WHAT IS THIS USED FOR? THIS IS USED FOR INTEGRATION WITH THE OCI (because of the IOR profiles are selected before the intercept calls. However, this call could be used to quickly figure out ownership of a ContextEstablisher should the identities mandated to be unique and prefixed with the OwnCredentials id.
void increment_work();The increment_work operation is used by the ClientRequestInterceptor when a request is made.
boolean is_usable(in string host,
in unsigned long port,
in CredsDirective creds_directive,
in FeatureDirective client_authentication,
in FeatureDirective target_authentication,
in FeatureDirective confidentiality,
in FeatureDirective integrity,
in CSIVersion csi_version,
in IOP::TaggedComponentSeq transport_components);
The is_usable operation is used by the Transport Security framework
to see if this initiator can handle the specified policy
against the components of the target's IOR.
void remove_initiating_context_establishment_listener(in ListenerId id);The remove_initiating_context_establishment_listener operation removes the listener. This operation raises a BAD_PARAM exception if the listener id is not registered.
boolean supports_csi_version(in CSIVersion csi_version);The supports_csi_version operation returns true if this initiator supports the particular CSI version.
boolean supports_invoc_options(in CSIIOP::AssociationOptions invocation_options_supported,
in CSIIOP::AssociationOptions invocation_options_required);
The supports_invoc_options operation is used by the
framework to discover if this initiator can be used to
create the desired secure association.
Note:Presently not used, may be deprecated.