바코드 및 QR 코드를 사용한 Java 파일 서명 방법
소개
파일이 변조되지 않았음을 how to sign java 기술을 사용해 증명하는 방법이 궁금했나요? 복잡한 암호화 설정 없이 프로그래밍 방식으로 문서를 인증할 방법이 필요했나요? 전통적인 디지털 서명은 특정 사용 사례에 과도할 수 있습니다. 때때로 아카이브, 백업 또는 자동화된 워크플로를 다룰 때 파일 무결성을 확인할 가볍고 스캔 가능한 방법만 필요합니다. 바로 바코드와 QR 코드 서명이 그런 경우에 적합합니다.
이 튜토리얼에서는 GroupDocs.Signature를 사용하여 how to sign java를 구현하는 방법을 배웁니다. 백업 시스템 및 소프트웨어 배포에 최적화된 TAR 아카이브 서명에 중점을 두지만, 이러한 기술은 다양한 문서 형식에서도 적용됩니다. 문서 관리 시스템을 구축하든 파일에 추가 보안 레이어를 추가하든, 여기가 바로 시작점입니다.
배우게 될 내용:
- Java에서 바코드 및 QR 코드 서명을 구현한 실용적인 예제
- 각 서명 유형을 언제 사용해야 하는지와 그 이유에 대한 이해
- 일반적인 서명 문제에 대한 실용적인 해결책
- 즉시 적용 가능한 실제 통합 패턴
- 프로덕션 시스템을 위한 성능 최적화 팁
그럼 바로 시작해봅시다—암호학 학위는 필요 없습니다.
빠른 답변
- Java에서 바코드 서명을 처리하는 라이브러리는? GroupDocs.Signature for Java.
- 어떤 서명 유형이 더 많은 데이터를 저장하나요? QR 코드 (최대 4,296개의 알파벳-숫자 문자).
- 100 MB 이상의 큰 TAR 파일에 서명할 수 있나요? 예—백그라운드 스레드를 사용하고 JVM 힙을 늘리세요.
- 인터넷 연결이 필요합니까? 아니요, 라이브러리는 완전히 오프라인에서 작동합니다.
- 프로덕션에 라이선스가 필요합니까? 예, 유효한 GroupDocs.Signature 라이선스가 필수입니다.
디지털 서명 Java란?
Digital signature java는 바코드 또는 QR 코드와 같은 검증 가능한 시각 토큰을 Java에서 생성된 파일에 직접 삽입하여 파일의 진위와 무결성을 증명하는 과정입니다. 서명된 이후 파일이 변경되지 않았음을 빠르고 사람이 읽을 수 있는 형태로 증명하면서, 동시에 GroupDocs.Signature API를 통해 프로그래밍 방식 검증도 가능하게 합니다.
바코드 또는 QR 코드 서명을 사용하는 이유
GroupDocs.Signature는 50개 이상의 입력 및 출력 형식(PDF, DOCX, XLSX, HTML, PNG, TAR 등)을 지원하며 전체 파일을 메모리에 로드하지 않고도 수백 페이지 문서를 처리할 수 있습니다. 바코드와 QR 코드는 스캔 가능한 자체 포함 인증 증명을 제공하여 많은 내부 워크플로에서 외부 인증 기관이 필요하지 않게 합니다.
| 요소 | 바코드 (Code128) | QR 코드 |
|---|---|---|
| 데이터 용량 | ~80 문자 | 최대 4,296개의 알파벳-숫자 문자 |
| 읽기 가능성 | 바코드 스캐너 필요 | 스마트폰 카메라로 사용 가능 |
| 공간 효율성 | 가로로 더 컴팩트 | 정사각형 영역 필요 |
| 적합한 경우 | 간단한 ID, 타임스탬프, 짧은 코드 | URL, JSON 데이터, 상세 메타데이터 |
| 오류 정정 | 최소 | 내장 (손상에서 복구 가능) |
일반적인 지침
- 바코드는 빠르고 스캔 가능한 ID 또는 타임스탬프에 사용하세요.
- QR 코드는 더 풍부한 데이터를 삽입하거나 스마트폰 호환성이 필요할 때 사용하세요.
- 두 가지를 모두 결합하면 최대 중복성과 감사 가능성을 확보할 수 있습니다.
사전 요구 사항
- GroupDocs.Signature for Java Library – 버전 23.12 이상
- Java Development Kit (JDK) – 버전 8 이상
- IDE – IntelliJ IDEA, Eclipse 또는 Java 호환 편집기
- Basic Java knowledge – 클래스와 import에 익숙해야 합니다
환경 설정
GroupDocs.Signature를 프로젝트에 추가하는 것은 간단합니다. 빌드 도구를 선택하세요:
Maven (pom.xml에 추가):
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-signature</artifactId>
<version>23.12</version>
</dependency>
Gradle (build.gradle에 추가):
implementation 'com.groupdocs:groupdocs-signature:23.12'
수동 다운로드: Maven이나 Gradle을 사용하지 않나요? GroupDocs.Signature releases에서 JAR 파일을 직접 받아 클래스패스에 추가하세요.
라이선스 획득
GroupDocs는 유연한 라이선스 옵션을 제공합니다:
- 무료 체험: 테스트에 적합—신용카드 필요 없음. 시작하기
- 임시 라이선스: 평가 기간을 더 늘리고 싶나요? 개발 중 전체 기능 접근을 위해 임시 라이선스 요청
- 프로덕션 라이선스: 배포 준비가 되면 필요에 맞게 라이선스 구매
추가 유용한 링크
팁: 먼저 무료 체험으로 솔루션을 프로토타이핑하고, 커밋하기 전에 시간이 더 필요하면 임시 라이선스를 확보하세요.
GroupDocs.Signature for Java 설정
Signature 클래스는 GroupDocs.Signature에서 모든 서명 작업의 진입점입니다. 메모리에 로드된 단일 파일을 나타내며 시각 서명을 추가, 검색 또는 삭제하는 메서드를 제공합니다.
귀하의 TAR 파일을 가리키는 Signature 인스턴스를 생성합니다. 이 인스턴스는 파일을 메모리에 로드하여 처리합니다:
import com.groupdocs.signature.Signature;
public class InitializeSignature {
public static void main(String[] args) {
Signature signature = new Signature("your-document-path");
// Additional setup and usage here...
}
}
중요: 작업이 끝나면 항상 Signature 객체를 닫으세요(또는 try‑with‑resources 사용) — 대용량 파일에서 메모리 누수를 방지합니다.
바코드와 QR 코드 서명 선택
어떤 서명 유형을 사용해야 할지 모르겠나요? 빠른 결정 가이드를 확인하세요:
| 요소 | 바코드 (Code128) | QR 코드 |
|---|---|---|
| 데이터 용량 | ~80 문자 | 최대 4,296개의 알파벳-숫자 문자 |
| 읽기 가능성 | 바코드 스캐너 필요 | 스마트폰 카메라로 사용 가능 |
| 공간 효율성 | 가로로 더 컴팩트 | 정사각형 영역 필요 |
| 적합한 경우 | 간단한 ID, 타임스탬프, 짧은 코드 | URL, JSON 데이터, 상세 메타데이터 |
| 오류 정정 | 최소 | 내장 (손상에서 복구 가능) |
일반적인 지침
- 바코드는 빠르고 스캔 가능한 ID 또는 타임스탬프에 사용하세요.
- QR 코드는 더 풍부한 데이터를 삽입하거나 스마트폰 호환성이 필요할 때 사용하세요.
- 두 가지를 모두 결합하면 최대 중복성과 감사 가능성을 확보할 수 있습니다.
구현 가이드
바코드로 TAR 아카이브 서명
바코드 서명의 이유
바코드는 컴팩트하고 스캔 가능하기 때문에 TAR 아카이브에 최적입니다. 타임스탬프, 버전 번호, 사용자 ID 또는 체크섬 값을 삽입하여 빠르게 검증할 수 있습니다.
단계
1. 서명 초기화
먼저 TAR 파일에 대한 Signature 인스턴스를 생성합니다:
import com.groupdocs.signature.Signature;
final Signature signature = new Signature("path/to/your/archive.tar");
팁: 100 MB 이상의 큰 TAR 파일은 서명 작업을 백그라운드 스레드에서 실행하여 UI 응답성을 유지하세요.
2. 바코드 옵션 구성BarcodeSignature 클래스는 바코드 내용, 유형 및 배치를 정의합니다. BarcodeOptions 객체에 이러한 설정이 저장됩니다:
import com.groupdocs.signature.options.sign.BarcodeSignOptions;
import com.groupdocs.signature.domain.barcodes.BarcodeTypes;
BarcodeSignOptions bcOptions = new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
bcOptions.setLeft(100); // X position in pixels
bcOptions.setTop(100); // Y position in pixels
BarcodeOptions를 사용하면 바코드의 시각적 모양과 위치를 지정할 수 있습니다.BarcodeTypes는 Code128, Code39 등 지원되는 바코드 심볼을 나열하는 열거형입니다.
무엇을 하는 코드인가요?
"12345678"은 바코드에 인코딩된 데이터입니다—실제 ID, 타임스탬프 또는 검증 코드로 교체하세요.BarcodeTypes.Code128은 데이터 용량과 스캔 신뢰성의 균형을 맞춥니다.- 위치 값 (100, 100)은 바코드를 좌상단에서 100 px 떨어진 곳에 배치합니다.
원할 수 있는 커스터마이징 옵션:
bcOptions.setWidth(200); // Barcode width in pixels
bcOptions.setHeight(50); // Barcode height in pixels
bcOptions.setForeColor(Color.BLACK); // Barcode color
bcOptions.setBackgroundColor(Color.WHITE); // Background color
3. 문서 서명 및 저장
서명 작업을 실행하고 서명된 아카이브를 저장합니다:
import com.groupdocs.signature.domain.SignResult;
String outputFilePath = "output/path/SignWithBarcode/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, bcOptions);
반환된 SignResult 객체는 작업 성공 여부와 서명이 배치된 위치를 알려줍니다.
흔히 발생하는 실수: sign() 호출 전에 출력 디렉터리가 존재하는지 확인하세요. 라이브러리는 상위 디렉터리를 자동으로 생성하지 않습니다.
QR 코드로 TAR 아카이브 서명
QR 코드를 사용할 때
구조화된 데이터(JSON, XML)를 저장하거나 검증 URL을 삽입하거나 스마트폰 스캔을 지원해야 할 때 QR 코드가 빛을 발합니다.
단계
1. 서명 초기화
앞과 동일하게 Signature 인스턴스를 생성합니다:
final Signature signature = new Signature("path/to/your/archive.tar");
2. QR 코드 옵션 구성
삽입하려는 데이터를 사용해 QR 코드를 설정합니다:
import com.groupdocs.signature.options.sign.QrCodeSignOptions;
import com.groupdocs.signature.domain.qrcodes.QrCodeTypes;
QrCodeSignOptions qrOptions = new QrCodeSignOptions("12345678", QrCodeTypes.QR);
qrOptions.setLeft(400); // X position
qrOptions.setTop(400); // Y position
QrCodeTypes는 생성할 QR 코드 유형(표준 QR, DataMatrix, Aztec 등)을 지정하는 열거형입니다.
실제 예시 – 검증 데이터를 포함한 JSON 페이로드를 삽입합니다:
String verificationData = "{\"version\":\"1.0\",\"timestamp\":\"2025-01-02T10:30:00Z\",\"user\":\"john.doe\"}";
QrCodeSignOptions qrOptions = new QrCodeSignOptions(verificationData, QrCodeTypes.QR);
QR 코드 유형 옵션:
QrCodeTypes.QR– 표준 QR 코드(가장 일반적)QrCodeTypes.DataMatrix– 작은 데이터에 더 컴팩트QrCodeTypes.Aztec– 곡면에 적합
3. 문서 서명 및 저장
바코드와 동일하게 서명 과정을 완료합니다:
String outputFilePath = "output/path/SignWithQRCode/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, qrOptions);
성능 참고: 오류 정정 계산 때문에 QR 코드 생성이 바코드보다 약간 느리지만, 대부분의 경우(보통 몇 밀리초) 차이는 무시할 수 있습니다.
다중 서명으로 TAR 아카이브 서명
다중 서명을 사용하는 이유
- 중복성 – 하나의 서명이 손상돼도 다른 서명이 검증 가능
- 다양한 대상 – 스캐너용 바코드, 스마트폰용 QR 코드
- 계층형 데이터 – 바코드에 빠른 ID, QR 코드에 상세 메타데이터
- 규정 준수 – 일부 규정은 다중 검증 방법을 요구
단계
1. 서명 초기화
앞과 동일하게 초기화합니다:
final Signature signature = new Signature("path/to/your/archive.tar");
2. 다중 옵션 구성
두 서명 유형을 생성하고 리스트에 결합합니다:
import java.util.ArrayList;
import java.util.List;
// Set up barcode (reusing from earlier example)
BarcodeSignOptions bcOptions = new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
bcOptions.setLeft(100);
bcOptions.setTop(100);
// Set up QR code (different position to avoid overlap)
QrCodeSignOptions qrOptions = new QrCodeSignOptions("12345678", QrCodeTypes.QR);
qrOptions.setLeft(400);
qrOptions.setTop(400);
// Combine them
List<com.groupdocs.signature.options.sign.SignOptions> listOptions = new ArrayList<>();
listOptions.add(bcOptions);
listOptions.add(qrOptions);
팁: 서명을 전략적으로 배치하세요—코너나 방해되지 않는 영역이 TAR 아카이브에 가장 적합합니다.
3. 문서 서명 및 저장
옵션 리스트를 sign() 메서드에 전달합니다:
String outputFilePath = "output/path/SignWithMultipleSignatures/archive_signed.tar";
SignResult signResult = signature.sign(outputFilePath, listOptions);
GroupDocs는 각 서명을 순차적으로 처리하여 문서 메타데이터에 삽입합니다. 리스트 순서는 검증에 영향을 주지 않습니다.
실제 사용 사례
1. 소프트웨어 배포 파이프라인
시나리오: 소프트웨어 패키지를 TAR 아카이브로 배포하고 변조되지 않았음을 증명.
솔루션: JSON 페이로드를 포함한 QR 코드로 각 릴리스를 서명합니다:
String releaseData = String.format(
"{\"version\":\"%s\",\"buildDate\":\"%s\",\"sha256\":\"%s\"}",
version, buildDate, checksum
);
작동 원리: 사용자는 QR 코드를 스캔해 설치 전 패키지 무결성을 검증할 수 있으며, GPG 키 관리가 필요 없습니다.
2. 자동 백업 시스템
시나리오: 매일 백업되는 TAR 아카이브에 감사 추적이 필요.
솔루션: 백업 타임스탬프와 서버 ID를 포함한 바코드를 추가합니다:
String backupId = String.format("SRV01-%s", LocalDateTime.now().format(formatter));
BarcodeSignOptions bcOptions = new BarcodeSignOptions(backupId, BarcodeTypes.Code128);
작동 원리: 아카이브를 열지 않고도 백업 진위성을 빠르게 시각적으로 검증합니다.
3. 문서 관리 시스템
시나리오: 아카이브로 저장된 법적 문서는 변조 방지 검증이 필요.
솔루션: 동일 아카이브에 바코드(빠른 스캔)와 QR 코드(상세 메타데이터)를 모두 사용합니다.
4. 공급망 추적
시나리오: 여러 조직을 거쳐 파일 패키지를 추적.
솔루션: 추적 URL이 포함된 QR 코드를 삽입해 검증 API와 연결합니다:
String trackingUrl = "https://verify.yourcompany.com/track/" + uniqueId;
QrCodeSignOptions qrOptions = new QrCodeSignOptions(trackingUrl, QrCodeTypes.QR);
일반적인 문제와 해결책
문제 1: 서명 후 “Signature not found”
증상: sign()은 성공했지만 서명이 보이지 않음.
원인: 잘못된 위치, 원본 파일 덮어쓰기, TAR 뷰어 제한.
해결책:
// Always verify the signing succeeded
SignResult result = signature.sign(outputFilePath, bcOptions);
if (result.getSucceeded().size() > 0) {
System.out.println("Signature added successfully at: " + outputFilePath);
} else {
System.err.println("Signing failed: " + result.getFailed());
}
// Use absolute paths to avoid confusion
String absolutePath = new File(outputFilePath).getAbsolutePath();
문제 2: 대용량 TAR 파일에서 OutOfMemoryError
증상: 500 MB 이상의 아카이브에서 JVM이 충돌.
해결책: 힙 크기(-Xmx)를 늘리고 Signature 객체를 즉시 해제하세요:
java -Xmx2G -jar your-application.jar
또는 청크 처리 구현:
// For very large files, consider signing metadata separately
// rather than embedding in the TAR itself
문제 3: 서명 데이터가 잘림
증상: 긴 문자열이 잘려 나감.
원인: Code128 용량 초과(≈ 80 문자).
해결책: 더 긴 페이로드는 QR 코드로 전환:
// Bad: Too much data for Code128
BarcodeSignOptions bcOptions = new BarcodeSignOptions(veryLongString, BarcodeTypes.Code128);
// Good: Use QR code instead
QrCodeSignOptions qrOptions = new QrCodeSignOptions(veryLongString, QrCodeTypes.QR);
문제 4: 라이선스 검증 오류
증상: 프로덕션에서 LicenseException 또는 “Trial version” 경고 발생.
해결책: 어떤 Signature 인스턴스를 만들기 전에 라이선스를 로드하세요:
import com.groupdocs.signature.License;
License license = new License();
license.setLicense("path/to/GroupDocs.Signature.lic");
// Now create signatures
Signature signature = new Signature("document.tar");
팁: 라이선스는 애플리케이션 시작 시 한 번만 로드하고, 각 서명 작업마다 로드하지 마세요.
문제 5: 위치 값이 예상대로 작동하지 않음
증상: 서명이 예상치 못한 위치에 나타남.
원인: 픽셀과 포인트 혼동.
해결책: GroupDocs는 기본적으로 픽셀을 사용합니다. 정확한 배치를 위해:
bcOptions.setLeft(100); // 100 pixels from left edge
bcOptions.setTop(100); // 100 pixels from top edge
// If you need percentage-based positioning:
bcOptions.setHorizontalAlignment(HorizontalAlignment.Center);
bcOptions.setVerticalAlignment(VerticalAlignment.Center);
통합 패턴
패턴 1: REST API 서비스
서명을 마이크로서비스로 노출합니다:
@RestController
@RequestMapping("/api/signature")
public class SignatureController {
@PostMapping("/sign")
public ResponseEntity<SignatureResponse> signFile(
@RequestParam("file") MultipartFile file,
@RequestParam("signatureType") String type) {
try {
// Save uploaded file temporarily
File tempFile = File.createTempFile("upload-", ".tar");
file.transferTo(tempFile);
// Sign based on type
Signature signature = new Signature(tempFile.getAbsolutePath());
SignOptions options = type.equals("barcode")
? createBarcodeOptions()
: createQROptions();
String outputPath = generateOutputPath();
SignResult result = signature.sign(outputPath, options);
// Return signed file
return ResponseEntity.ok(new SignatureResponse(outputPath, result));
} catch (Exception e) {
return ResponseEntity.status(500).body(null);
}
}
}
패턴 2: 배치 처리 파이프라인
파이프라인에서 여러 아카이브를 서명합니다:
public class BatchSigner {
public void signArchiveBatch(List<File> archives) {
ExecutorService executor = Executors.newFixedThreadPool(4);
archives.forEach(archive -> {
executor.submit(() -> {
try {
signSingleArchive(archive);
} catch (Exception e) {
logger.error("Failed to sign: " + archive.getName(), e);
}
});
});
executor.shutdown();
executor.awaitTermination(1, TimeUnit.HOURS);
}
private void signSingleArchive(File archive) throws Exception {
Signature signature = new Signature(archive.getAbsolutePath());
// ... signing logic
}
}
패턴 3: 이벤트 기반 아키텍처
아카이브가 생성될 때 서명을 트리거합니다:
@Component
public class ArchiveCreatedListener {
@EventListener
public void onArchiveCreated(ArchiveCreatedEvent event) {
CompletableFuture.runAsync(() -> {
signArchive(event.getFilePath());
});
}
private void signArchive(String filePath) {
// ... signing logic
}
}
성능 고려 사항
메모리 관리
문제: 각 Signature 인스턴스가 전체 파일을 메모리에 로드합니다.
모범 사례:
// Bad: Creating multiple instances for same file
Signature sig1 = new Signature("file.tar");
Signature sig2 = new Signature("file.tar"); // Loads again!
// Good: Reuse the instance
try (Signature signature = new Signature("file.tar")) {
signature.sign(output1, options1);
signature.sign(output2, options2); // Same instance, different outputs
}
파일 크기 최적화
- 작은 파일 (< 10 MB) – 동기식으로 서명
- 중간 파일 (10‑100 MB) – 백그라운드 스레드 사용
- 큰 파일 (> 100 MB) – 메타데이터를 별도로 서명하거나 스트리밍 API 사용 고려
서명 복잡도 (표준 서버에서 대략적인 시간)
| 서명 유형 | 문서당 시간 |
|---|---|
| 단일 바코드 | 50‑100 ms |
| 단일 QR 코드 | 100‑200 ms |
| 다중 서명 | 150‑300 ms |
최적화 팁: 수천 개 파일을 처리할 때는 배치 처리하고 스레드 풀을 사용하세요(위 배치 처리 패턴 참고).
라이브러리 업데이트
GroupDocs는 정기적으로 성능 개선을 릴리스합니다. 주요 배포 전에 항상 changelog를 확인하세요.
업데이트 전략
- 스테이징 환경에서 새 버전 테스트
- 호환성 깨지는 변경 사항 검토
- 실제 파일로 벤치마크
- 점진적으로 롤아웃
프로덕션을 위한 모범 사례
1. 라이선스 상태 검증
License license = new License();
if (!license.isLicensed()) {
logger.warn("Running in trial mode - features may be limited");
}
2. 견고한 오류 처리 구현
try {
signature.sign(outputPath, options);
} catch (Exception e) {
logger.error("Signature failed", e);
// Don't just swallow exceptions - log or re-throw
throw new SignatureException("Failed to sign document", e);
}
3. 설명적인 서명 데이터 사용
// Bad: Meaningless ID
new BarcodeSignOptions("12345678", BarcodeTypes.Code128);
// Good: Self-documenting data
String signatureData = String.format("DOC-%s-%s",
docType,
LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME)
);
new BarcodeSignOptions(signatureData, BarcodeTypes.Code128);
4. 서명 포맷 버전 관리
임베드된 JSON에 버전 번호를 포함해 검증 로직을 미래에도 대비하세요:
String qrData = String.format(
"{\"v\":\"1.0\",\"type\":\"archive\",\"timestamp\":\"%s\"}",
timestamp
);
5. 실제 파일로 테스트 – 메모리 및 성능 문제를 조기에 발견하려면 프로덕션 규모 아카이브로 항상 검증하세요.
결론
이제 바코드와 QR 코드를 사용해 how to sign java를 구현하기 위한 탄탄한 기반을 갖추었습니다. 배운 내용은 다음과 같습니다:
- 바코드와 QR 코드 서명을 사용해 TAR 아카이브(및 기타 문서) 서명 방법
- 특정 요구에 따라 각 서명 유형을 선택하는 시점
- 프로덕션에 적용하기 전에 일반적인 문제를 해결하는 방법
- REST API, 배치 처리, 이벤트 기반 시스템을 위한 실제 통합 패턴
- 어떤 크기의 파일도 처리할 수 있는 성능 최적화 기법
다음 단계
search()메서드로 서명 검증 탐색- 다른 문서 형식 시도—GroupDocs.Signature는 PDF, DOCX, XLSX, PNG 등 지원
- 서명 외관 커스터마이징(색상, 크기, 테두리)
- 서명을 프로그래밍 방식으로 검증하는 API 구축
GroupDocs.Signature의 기능은 이 가이드를 훨씬 뛰어넘습니다. 텍스트 서명, 이미지 서명, 메타데이터 추출 등 고급 기능을 확인하려면 GroupDocs.Signature for Java Documentation을 살펴보세요.
질문이 있거나 구현을 공유하고 싶다면 다른 개발자들의 도움을 받을 수 있는 GroupDocs 커뮤니티 포럼에 참여하세요.
자주 묻는 질문
Q: TAR 아카이브 외에 다른 문서에 서명할 수 있나요?
A: 물론입니다! GroupDocs.Signature는 PDF, DOCX, XLSX, PNG 등 50개 이상의 파일 형식을 지원합니다. Signature 생성자에서 파일 확장자만 해당 형식으로 바꾸면 됩니다.
Q: 서명 후 어떻게 검증하나요?
A: search() 메서드를 사용해 서명을 찾고 검증합니다:
Signature signature = new Signature("signed-document.tar");
BarcodeSearchOptions searchOptions = new BarcodeSearchOptions();
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, searchOptions);
Q: 서명이 변조에 대해 안전한가요?
A: 바코드와 QR 코드 서명은 시각적 검증을 제공하지만 디지털 인증서처럼 암호학적으로 강력하지는 않습니다. 최대 보안을 위해 전통적인 PKI와 결합하거나 서명 해시를 외부 데이터베이스에 저장하세요.
Q: 서명에 저장할 수 있는 최대 데이터는 얼마인가요?
- Code128 바코드: 약 80개의 알파벳-숫자 문자
- QR 코드 (Version 40): 최대 4,296개의 알파벳-숫자 문자 또는 7,089개의 숫자 문자
Q: 서명 외관을 커스터마이징할 수 있나요?
A: 네! 색상, 크기, 테두리 등을 제어할 수 있습니다:
bcOptions.setForeColor(Color.BLUE);
bcOptions.setBackgroundColor(Color.YELLOW);
bcOptions.setBorder(new Border());
bcOptions.getBorder().setColor(Color.RED);
bcOptions.getBorder().setWeight(2);
Q: 파일을 두 번 서명하면 어떻게 되나요?
A: 각 sign() 호출은 새로운 서명을 추가합니다. 기존 서명을 교체하려면 먼저 delete() 메서드로 삭제하세요.
Q: 메모리 부족 없이 큰 파일을 처리하려면?
A: JVM 힙(-Xmx)을 늘리고 Signature 객체를 즉시 해제하며, 다중 기가바이트 아카이브는 메타데이터를 별도로 서명하는 것을 고려하세요.
Q: 서명에 인터넷 연결이 필요합니까?
A: 아니요. 라이브러리를 설치하면 GroupDocs.Signature는 완전히 오프라인에서 작동합니다.
최종 업데이트: 2026-10-06
테스트 환경: GroupDocs.Signature 23.12 for Java
작성자: GroupDocs