Module java.management

Package javax.management.remote

Interface JMXAuthenticator

public interface JMXAuthenticator

Interface to define how remote credentials are converted into a JAAS Subject. This interface is used by the RMI Connector Server, and can be used by other connector servers.

The user-defined authenticator instance is passed to the connector server in the environment map as the value of the attribute JMXConnectorServer.AUTHENTICATOR. For connector servers that use only this authentication system, if this attribute is not present or its value is null then no user authentication will be performed and full access to the methods exported by the MBeanServerConnection object will be allowed.

If authentication is successful then an authenticated subject filled in with its associated principals is returned. Authorization checks will be then performed based on the given set of principals.

Since:

1.5

Method Summary

Modifier and Type	Method	Description
Subject	authenticate(Object credentials)	Authenticates the MBeanServerConnection client with the given client credentials.

Method Details

authenticate

Subject authenticate(Object credentials)

Authenticates the MBeanServerConnection client with the given client credentials.

Parameters:

credentials - the user-defined credentials to be passed into the server in order to authenticate the user before creating the MBeanServerConnection. The actual type of this parameter, and whether it can be null, depends on the connector.

Returns:

the authenticated subject containing its associated principals.

Throws:

SecurityException - if the server cannot authenticate the user with the provided credentials.