[java] Apache XML Security 라이브러리를 활용하여 안전한 XML 문서 처리하기

21 Dec 2023

java

XML은 데이터를 저장하고 전달하기 위한 인기있는 형식입니다. 그러나 XML 문서를 처리할 때는 보안 문제가 발생할 수 있습니다. Apache XML Security 라이브러리는 XML 문서를 안전하게 처리할 수 있도록 다양한 암호화 및 디지털 서명 기능을 제공합니다. 이 라이브러리를 사용하여 안전한 XML 문서 처리를 구현하는 방법에 대해 알아보겠습니다.

Apache XML Security 라이브러리 소개

Apache XML Security 라이브러리는 XML 기반 보안 표준을 구현하는 Java 및 C++ 라이브러리입니다. 이 라이브러리는 XML Signature 및 XML Encryption과 같은 보안 표준을 준수하여 XML 문서의 무결성 및 기밀성을 보장합니다.

Apache XML Security 라이브러리 사용하기

Apache XML Security 라이브러리를 사용하여 안전한 XML 문서 처리를 위해 다음 단계를 따릅니다.

단계 1: 라이브러리 추가

Maven 프로젝트의 경우, pom.xml 파일에 다음 의존성을 추가합니다:

<dependency>
    <groupId>org.apache.santuario</groupId>
    <artifactId>xmlsec</artifactId>
    <version>2.2.3</version>
</dependency>

Gradle 프로젝트의 경우, build.gradle 파일에 다음 의존성을 추가합니다:

implementation 'org.apache.santuario:xmlsec:2.2.3'

단계 2: XML 서명 생성

import org.apache.xml.security.Init;
import org.apache.xml.security.exceptions.XMLSecurityException;
import org.apache.xml.security.signature.XMLSignature;
import org.apache.xml.security.transforms.Transforms;
import org.w3c.dom.Document;

public class XmlSigner {
    public static void signXml(Document document, String privateKeyFilePath, String publicKeyFilePath) throws XMLSecurityException {
        Init.init();

        XMLSignature signature = new XMLSignature(document, privateKeyFilePath, XMLSignature.ALGO_ID_SIGNATURE_RSA_SHA256, Transforms.TRANSFORM_C14N11_EXCL_OMIT_COMMENTS);
        document.getDocumentElement().appendChild(signature.getElement());

        signature.sign();
    }
}

단계 3: XML 서명 확인

import org.apache.xml.security.Init;
import org.apache.xml.security.exceptions.XMLSecurityException;
import org.apache.xml.security.signature.XMLSignature;
import org.w3c.dom.Document;

public class XmlVerifier {
    public static boolean verifyXml(Document document, String publicKeyFilePath) throws XMLSecurityException {
        Init.init();

        XMLSignature signature = new XMLSignature(document, null);
        NodeList signatures = document.getElementsByTagNameNS(XMLSignature.XMLNS, "Signature");

        if (signatures.getLength() == 0) {
            return false;
        }

        signature.load(((Element) signatures.item(0)), publicKeyFilePath);
        return signature.checkSignatureValue(signature.getKeyInfo().getPublicKey());
    }
}

단계 4: XML 암호화

import org.apache.xml.security.Init;
import org.apache.xml.security.encryption.XMLCipher;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

public class XmlEncryptor {
    public static void encryptXml(Document document, Element elementToEncrypt, String encryptionKeyFilePath) throws XMLSecurityException {
        Init.init();

        XMLCipher xmlCipher = XMLCipher.getInstance(XMLCipher.AES_128);
        xmlCipher.init(XMLCipher.ENCRYPT_MODE, null);

        xmlCipher.setKey(encryptionKeyFilePath.getBytes());
        EncryptedData encryptedData = xmlCipher.getEncryptedData();

        xmlCipher.doFinal(document, elementToEncrypt, true);
    }
}

단계 5: XML 복호화

import org.apache.xml.security.Init;
import org.apache.xml.security.encryption.XMLCipher;
import org.w3c.dom.Document;
import org.w3c.dom.Element;

public class XmlDecryptor {
    public static void decryptXml(Document document, String decryptionKeyFilePath) throws XMLSecurityException {
        Init.init();

        XMLCipher xmlCipher = XMLCipher.getInstance();
        xmlCipher.init(XMLCipher.DECRYPT_MODE, null);
        xmlCipher.setKEK(KeyInfoProvider.getSharedKey());
        xmlCipher.doFinal(document, elementToDecrypt);
    }
}

마치며

Apache XML Security 라이브러리를 사용하면 XML 문서를 안전하게 처리할 수 있습니다. 이러한 암호화, 서명 및 기타 보안 기능은 기밀성과 무결성이 중요한 애플리케이션에서 중요한 역할을 합니다.

이러한 기능 사용 시에는 추가적인 보안 상의 고려 사항이 필요하며, 보안 전문가의 조언을 받는 것이 좋습니다.

더 많은 세부 정보는 Apache XML Security 웹 사이트에서 확인할 수 있습니다.