9. 인증과 TLS¶

Basic / Bearer¶

ZLinkHttpClient.create("https://api.internal").basicAuth("user", "secret").build();
ZLinkHttpClient.create("https://api.internal").bearerToken("eyJhbGci...").build();

둘 다 Authorization 헤더를 설정한다. redirect 시 Authorization은 same-origin 에서만 보존되고 cross-origin으로는 제거된다(10장).

HTTPS / TLS 검증¶

기본적으로 시스템 신뢰 저장소로 서버 인증서를 검증한다. 테스트 인증서(self-signed)를 신뢰하려면 trustCertificateFile(path)로 PEM 인증서를 지정한다. 내부적으로 JVM 기본 trust와 지정 인증서를 함께 보는 composite TrustManager를 SSLContext에 구성한다 — 즉 기본 신뢰에 추가되며(대체 아님) 공인 CA HTTPS는 계속 동작한다. hostname 검증은 항상 수행되며 끄는 옵션은 없다 (공통 spec 7.2).

ZLinkHttpClient.create("https://localhost:8443")
    .trustCertificateFile("test-ca.pem")
    .build();

mTLS client certificate¶

ZLinkHttpClient.create("https://mtls.internal")
    .clientCertificateFile("client-cert.pem", "client-key.pem")
    .build();

PEM 인증서(X.509)와 PKCS#8 키를 KeyManager로 구성해 SSLContext에 싣는다.

다음: Redirect · Retry · Cookie →