Local Interface TransportSecurity::OwnCredentials

Local Interface TransportSecurity::OwnCredentials

local interface OwnCredentials
    inherits from TransportSecurity::TransportCredentials
This interface is the own credentials. Objects of this interface are created by the CredentialsAcquirer.

Attribute Index

creds_state
The creds_state attribute contains the validity state of the credentials.
the_acceptor
This attribute is Null if creds_usage is not accepting.
the_initiator
This attribute is Null if creds_usage is not initiating.

Operation Index

externalize_credentials
The externalize_credentials operation writes the credentials to a form that may be able to be used by other programs, such as a Kerberos Session Credentials Cache.
release_credentials
This function releases the credentials from use and from the default credentials list, if it is present on it.
supports_csi_version
This operation stipulates the transport support for CSI.

Attributes

creds_state
readonly attribute CredentialsState creds_state;

The creds_state attribute contains the validity state of the credentials.

the_acceptor
readonly attribute CredentialsAcceptor the_acceptor;

This attribute is Null if creds_usage is not accepting.

the_initiator
readonly attribute CredentialsInitiator the_initiator;

This attribute is Null if creds_usage is not initiating.


Operations

externalize_credentials
void externalize_credentials(in ExternalizationType externalization_type,
                             in string dest_url);

The externalize_credentials operation writes the credentials to a form that may be able to be used by other programs, such as a Kerberos Session Credentials Cache. This operation will raise a System Exception of BAD_PARAM, if the type is invalid for the mechanism, or url is invalid, or cannot be accessed.

For Kerberos, you can get the credentials dumped to a credentials cache file by, using the type of "CredCache", and a FILE: url, such as in the following:

 creds.externalize("CredCache","FILE:/tmp/krb5cc_user");
 

Parameters:
externalization_type - The externalization_type parameter holds the type of externalization desired. Identifiers are specific to mechanisms.
dest_url - The dest_url parameter must hold a valid writable URL, such as "FILE:/tmp/krb5cc".

release_credentials
void release_credentials();

This function releases the credentials from use and from the default credentials list, if it is present on it. The credentials shall not be actually released from use until all its pending work is done.

supports_csi_version
boolean supports_csi_version(in CSIVersion version);

This operation stipulates the transport support for CSI. If CSIv1 is true, then CSIv2 contexts are not supported over transports derived from these Credentials. If CSIv2 is true, and CSIv1 is false, a CSIv2 ServiceContext message must accompany GIOP requests over the transport.


Generated by the ORBacus IDL-to-HTML translator