---

TAO_SecurityManager Class Reference

Implementation of the SecurityLevel2::SecurityManager interface. More...

#include <SecurityManager.h>

Inheritance diagram for TAO_SecurityManager:

[legend]Collaboration diagram for TAO_SecurityManager:

[legend]List of all members.

Public Methods
	TAO_SecurityManager (void)
	Constructor.
SecurityLevel2::SecurityManager Methods
Methods exposed by the SecurityLevel2::SecurityManager interface.
virtual Security::MechandOptionsList *	supported_mechanisms (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
virtual SecurityLevel2::CredentialsList *	own_credentials (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
virtual SecurityLevel2::RequiredRights_ptr	required_rights_object (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
	Return a reference to the RequiredRights object.
virtual SecurityLevel2::PrincipalAuthenticator_ptr	principal_authenticator (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
	Return a reference to the PrincipalAuthenticator object.
virtual SecurityLevel2::AccessDecision_ptr	access_decision (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
	Return a reference to the AccessDecision object.
virtual SecurityLevel2::AuditDecision_ptr	audit_decision (ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
	Return a reference to the AuditDecision object.
virtual SecurityLevel2::TargetCredentials_ptr	get_target_credentials (CORBA::Object_ptr obj_ref ACE_ENV_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
virtual void	remove_own_credentials (SecurityLevel2::Credentials_ptr creds ACE_ENV_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
virtual CORBA::Policy_ptr	get_security_policy (CORBA::PolicyType policy_type ACE_ENV_ARG_DECL_WITH_DEFAULTS) throw (CORBA::SystemException)
TAO-specific Methods
Methods used internally by TAO's Security Service.
void	add_own_credentials (SecurityLevel2::Credentials_ptr creds ACE_ENV_ARG_DECL)
Protected Methods
	~TAO_SecurityManager (void)
	Destructor.
Private Attributes
TAO_SYNCH_MUTEX	lock_
	Lock used to synchronize access to the SecurityManager's state.
SecurityLevel2::CredentialsList	own_credentials_
SecurityLevel2::PrincipalAuthenticator_var	principal_authenticator_
	Reference to the PrinicipalAuthenticator.

---

Detailed Description

Implementation of the SecurityLevel2::SecurityManager interface.

A reference to the SecurityManager object can be retrieved by calling CORBA::ORB::resolve_initial_references ("SecurityManager");

---

Constructor & Destructor Documentation

TAO_SecurityManager::TAO_SecurityManager (  void    )

Constructor.

TAO_SecurityManager::~TAO_SecurityManager (  void    )  [protected]

Destructor. Protected destructor to enforce the fact this class is reference counted, and should not be destroyed using delete() by anything other than the reference counting mechanism.

---

Member Function Documentation

SecurityLevel2::AccessDecision_ptr TAO_SecurityManager::access_decision (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return a reference to the AccessDecision object. The AccessDecision object can be used to determine accessibility of objects.

void TAO_SecurityManager::add_own_credentials (  SecurityLevel2::Credentials_ptr creds    ACE_ENV_ARG_DECL )

This method is generally only used by the PrincipalAuthenticator when credentials are created and authenticated.

SecurityLevel2::AuditDecision_ptr TAO_SecurityManager::audit_decision (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return a reference to the AuditDecision object. The AuditDecision object can be used to determine what needs to be audited for a given object.

CORBA::Policy_ptr TAO_SecurityManager::get_security_policy (  CORBA::PolicyType policy_type    ACE_ENV_ARG_DECL_WITH_DEFAULTS )  throw (CORBA::SystemException) [virtual]

Return the security policy currently in effect corresponding to the given policy type.

SecurityLevel2::TargetCredentials_ptr TAO_SecurityManager::get_target_credentials (  CORBA::Object_ptr obj_ref    ACE_ENV_ARG_DECL_WITH_DEFAULTS )  throw (CORBA::SystemException) [virtual]

Return the TargetCredentials associated with the given object reference.

SecurityLevel2::CredentialsList * TAO_SecurityManager::own_credentials (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return the list of Credentials currently associated with the application itself, i.e. its own credentials.

SecurityLevel2::PrincipalAuthenticator_ptr TAO_SecurityManager::principal_authenticator (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return a reference to the PrincipalAuthenticator object. The PrincipalAuthenticator is used to authenticate principals and create credentials for them.

void TAO_SecurityManager::remove_own_credentials (  SecurityLevel2::Credentials_ptr creds    ACE_ENV_ARG_DECL_WITH_DEFAULTS )  throw (CORBA::SystemException) [virtual]

Note: A CORBA::BAD_PARAM exception will be thrown if the given credential is not in the SecurityManager's "own credentials" list.

SecurityLevel2::RequiredRights_ptr TAO_SecurityManager::required_rights_object (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return a reference to the RequiredRights object. The RequiredRights object is only useful to the application if the application needs to perform its own rights-based access control.

Security::MechandOptionsList * TAO_SecurityManager::supported_mechanisms (  ACE_ENV_SINGLE_ARG_DECL_WITH_DEFAULTS    )  throw (CORBA::SystemException) [virtual]

Return a sequence containing the security mechanisms supported by the Security Service.

---

Member Data Documentation

TAO_SYNCH_MUTEX TAO_SecurityManager::lock_ [private]

Lock used to synchronize access to the SecurityManager's state.

SecurityLevel2::CredentialsList TAO_SecurityManager::own_credentials_ [private]

List of SecurityManager's own credentials, i.e. those created by its PrincipalAuthenticator.

SecurityLevel2::PrincipalAuthenticator_var TAO_SecurityManager::principal_authenticator_ [private]

Reference to the PrinicipalAuthenticator.

---

The documentation for this class was generated from the following files:

• SecurityManager.h
• SecurityManager.cpp

---