FileDocCategorySizeDatePackage
SecurityService.javaAPI DocGlassfish v2 API4529Fri May 04 22:34:58 BST 2007com.sun.enterprise.iiop.security

SecurityService

public interface SecurityService

Fields Summary
public static final int
STATUS_PASSED
public static final int
STATUS_FAILED
public static final int
STATUS_RETRY
Constructors Summary
Methods Summary
public com.sun.enterprise.iiop.security.SecurityContextgetSecurityContext(org.omg.CORBA.Object effective_target)
This is called by the CSIv2 interceptor on the client before sending the IIOP message.

param
the effective_target field of the PortableInterceptor ClientRequestInfo object.
return
a SecurityContext which is marshalled into the IIOP msg by the CSIv2 interceptor.

public voidreceivedReply(int reply_status, org.omg.CORBA.Object effective_target)
This is called by the CSIv2 interceptor on the client after a reply is received.

param
the reply status from the call. The reply status field could indicate an authentication retry. The following is the mapping of PI status to the reply_status field PortableInterceptor::SUCCESSFUL -> STATUS_PASSED PortableInterceptor::SYSTEM_EXCEPTION -> STATUS_FAILED PortableInterceptor::USER_EXCEPTION -> STATUS_PASSED PortableInterceptor::LOCATION_FORWARD -> STATUS_RETRY PortableInterceptor::TRANSPORT_RETRY -> STATUS_RETRY
param
the effective_target field of the PI ClientRequestInfo object.

public voidsendingReply(com.sun.enterprise.iiop.security.SecurityContext context)
This is called by the CSIv2 interceptor on the server before sending the reply.

param
the SecurityContext which arrived in the IIOP message.

public intsetSecurityContext(com.sun.enterprise.iiop.security.SecurityContext context, byte[] object_id, java.lang.String method)
This is called by the CSIv2 interceptor on the server after receiving the IIOP message. If authentication fails a FAILED status is returned. If a FAILED status is returned the CSIV2 interceptor will marshall the MessageError service context and throw the NO_PERMISSION exception.

param
the SecurityContext which arrived in the IIOP message.
return
the status

public voidunsetSecurityContext()
This is called on the server to unset the security context this is introduced to prevent the re-use of the thread security context on re-use of the thread.