C++ Security Reference

Using Security in CORBA Applications

SecurityLevel2::Current::principal_authenticator

Synopsis

Returns the PrincipalAuthenticator.

OMG IDL Definition

readonly attribute PrincipalAuthenticator
                    principal_authenticator;

Description

The PrincipalAuthenticator returned by the principal_authenticator attribute is of actual type Tobj::PrincipalAuthenticator. Therefore, it can be used both as a Tobj::PrincipalAuthenticator and as a SecurityLevel2::PrincipalAuthenticator.

Note: This method raises CORBA::BAD_INV_ORDER if it is called on an invalid SecurityCurrent object.

Return Values

Returns the PrincipalAuthenticator.

SecurityLevel2::Credentials

Synopsis

Represents a particular principal's credential information that is specific to a process. A Credentials object that supports the SecurityLevel2::Credentials interface is a locality-constrained object. Any attempt to pass a reference to the object outside its locality, or any attempt to externalize the object using the CORBA::ORB::object_to_string() operation, results in a CORBA::Marshall exception.

OMG IDL Definition

#ifndef _SECURITY_LEVEL_2_IDL
#define _SECURITY_LEVEL_2_IDL

#include <SecurityLevel1.idl>

#pragma prefix "omg.org"

module SecurityLevel2 
  {
  interface Credentials
    {
    attribute Security::AssociationOptions 
                            invocation_options_supported;
    attribute Security::AssociationOptions 
                            invocation_options_required;
Security::AttributeList 
    get_attributes(
      in   Security::AttributeTypeList     attributes );

    boolean 
    is_valid(
      out  Security::UtcT                  expiry_time );

};
  };
#endif /* _SECURITY_LEVEL_2_IDL */

C++ Declaration

class SecurityLevel2
  {
  public:
    class	Credentials;
    typedef	Credentials *	Credentials_ptr;

  class  Credentials : public virtual CORBA::Object
    {
    public:
      static Credentials_ptr _duplicate(Credentials_ptr obj);
      static Credentials_ptr _narrow(CORBA::Object_ptr obj);
      static Credentials_ptr _nil();

      virtual Security::AssociationOptions
         invocation_options_supported() = 0;
      virtual void
         invocation_options_supported(
            const Security::AssociationOptions  options ) = 0;
      virtual Security::AssociationOptions
         invocation_options_required() = 0;
      virtual void
         invocation_options_required(
            const Security::AssociationOptions  options ) = 0;

      virtual Security::AttributeList * 
        get_attributes(
          const Security::AttributeTypeList & attributes) = 0;

      virtual CORBA::Boolean 
        is_valid( Security::UtcT_out expiry_time) = 0;

    protected:
      Credentials(CORBA::Object_ptr obj = 0);
      virtual ~Credentials() { }

    private:
      Credentials( const Credentials&) { }
      void operator=(const Credentials&) { }
    };  // class Credentials
  };  // class SecurityLevel2