# 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.