[java] JMX 연결 프로토콜과 보안 설정

17 Nov 2023

java

JMX(Java Management Extensions)는 자바 애플리케이션의 모니터링 및 관리를 위한 기술입니다. JMX를 사용하기 위해서는 클라이언트와 JMX 에이전트 간의 연결 프로토콜을 설정해야 합니다. 또한, 보안을 위해 암호화 및 인증 기능을 활성화할 수도 있습니다.

JMX 연결 프로토콜

JMX 연결을 위해 가장 일반적으로 사용되는 프로토콜은 RMI(Remote Method Invocation)입니다. RMI를 통해 클라이언트는 JMX 에이전트와 통신하며, JMX MBean(관리 대상)의 속성을 조회하거나 작업을 수행할 수 있습니다. RMI를 사용하려면 다음과 같이 JMX 연결 프로퍼티를 설정해야 합니다.

import javax.management.remote.*;
import java.util.*;

public class JMXConnectionExample {
    public static void main(String[] args) throws Exception {
        // JMX 연결 프로퍼티 설정
        JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi");
        Map<String, Object> env = new HashMap<>();
        env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.rmi.registry.RegistryContextFactory");
        env.put(Context.PROVIDER_URL, "rmi://localhost:9999");
        JMXConnector connector = JMXConnectorFactory.connect(url, env);

        // JMX 연결
        MBeanServerConnection connection = connector.getMBeanServerConnection();

        // 원하는 작업 수행
        // ...
        
        // JMX 연결 종료
        connector.close();
    }
}

위 코드에서 주요 부분은 JMXServiceURL과 JMXConnectorFactory를 사용하여 RMI 연결을 설정하고, JMXConnector를 통해 실제로 연결하는 부분입니다. 연결 후에는 MBeanServerConnection을 통해 원하는 작업을 수행할 수 있습니다.

JMX 보안 설정

JMX 연결에 보안 기능을 추가하려면 JMXConnectorServer와 JMXAuthenticator를 사용해야 합니다. JMXConnectorServer는 클라이언트의 연결 요청을 받아들이고, JMXAuthenticator는 클라이언트의 인증을 처리합니다.

import javax.management.remote.*;
import javax.management.remote.rmi.*;
import java.rmi.registry.*;
import java.util.*;

public class JMXSecurityExample {
    public static void main(String[] args) throws Exception {
        // JMX 인증 설정
        Map<String, Object> env = new HashMap<>();
        env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.rmi.registry.RegistryContextFactory");
        env.put(Context.PROVIDER_URL, "rmi://localhost:9999");
        env.put(RMIConnectorServer.RMI_CLIENT_SOCKET_FACTORY_ATTRIBUTE,
                new RMIConnectorServerSocketFactory() {
                    // 클라이언트 소켓 인증을 위한 커스텀 소켓 팩토리 구현
                    public Socket createSocket(String host, int port) throws IOException {
                        // ...
                    }
                });
        env.put("jmx.remote.rmi.server.socket.factory.class",
                "javax.rmi.ssl.SslRMIServerSocketFactory");

        // JMX 연결 구성
        JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:9999/jmxrmi");
        JMXConnectorServer connector = JMXConnectorServerFactory.newJMXConnectorServer(url, env, null);
        JMXAuthenticator authenticator = new JMXAuthenticator() {
            // 사용자 인증 처리를 위한 커스텀 인증자 구현
            public Subject authenticate(Object credentials) {
                // ...
            }
        };
        connector.setAuthenticator(authenticator);
        connector.start();

        // 클라이언트의 연결 요청을 대기

        // JMX 연결 종료
        connector.stop();
    }
}

위 코드에서는 JMXServiceURL과 JMXConnectorServerFactory를 사용하여 RMI 연결을 설정하고, JMXAuthenticator를 이용해 사용자의 인증 처리를 수행합니다. 클라이언트 소켓 인증을 위해 커스텀 소켓 팩토리 및 SSL 소켓 팩토리를 등록합니다. 연결을 위해 JMXConnectorServer를 사용하고, setAuthenticator 메서드를 통해 인증자를 지정합니다.

JMX 연결 프로토콜과 보안 설정에 대한 자세한 내용은 Java SE API 문서를 참조하십시오.