Node.JS에서 서명된 PDF의 서명 제거

Wed, 07 Oct 2026 14:49:25 +0000

서명된 PDF 문서에서 서명을 제거하는 것은 추가 처리나 보관을 위해 깨끗한 사본이 필요할 때 흔히 요구되는 작업입니다. GroupDocs.Signature Cloud SDK for Node.js는 PDF 서명을 프로그래밍 방식으로 조작할 수 있는 강력한 라이브러리를 제공합니다. 이 튜토리얼에서는 Node.js를 사용하여 PDF에서 모든 서명을 삭제하는 방법을 배우고, 전체 코드 예제를 확인하며, REST API에 대한 동등한 cURL 명령도 살펴봅니다.

Node.JS에서 서명된 PDF 문서의 서명을 제거하는 5단계

다음 단계에서는 GroupDocs.Signature Cloud SDK for Node.js를 사용하여 서명된 PDF 문서에서 서명 제거하는 방법을 보여줍니다.

자격 증명을 사용한 구성 초기화: 클라이언트 ID와 비밀을 보유하는 Configuration 객체를 생성합니다.

const config = new Configuration({
    clientId: process.env.GROUPDOCS_CLIENT_ID,
    clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
});

API 클라이언트 및 Signature API 인스턴스 만들기: 구성을 사용하여 ApiClient를 만든 다음 SignatureApi를 만듭니다.

const apiClient = new ApiClient(config);
const signatureApi = new SignatureApi(apiClient);

소스 PDF 파일 정보 정의: GroupDocs 저장소에 있는 PDF의 filePath를 설정합니다.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.pdf";

출력 경로가 포함된 삭제 요청 준비: DeleteSignaturesRequest를 생성하고, fileInfo를 할당한 다음, 결과를 저장할 위치를 지정합니다.

const deleteRequest = new DeleteSignaturesRequest();
deleteRequest.fileInfo = fileInfo;
deleteRequest.outputPath = "output.pdf";

요청을 실행하고 결과를 처리합니다: deleteSignatures를 호출하고 응답을 처리합니다.

try {
    const result = await signatureApi.deleteSignatures(deleteRequest);
    console.log("All signatures removed successfully.");
    console.log("Result file stored at:", result.path);
} catch (err) {
    console.error("Failed to remove signatures:", err);
}

각 클래스에 대한 자세한 내용은 API 참조를 참조하십시오.

PDF에서 모든 서명 제거 - 전체 코드 예제

다음 예제는 서명된 PDF 문서에서 서명을 제거하는 전체 워크플로우를 보여줍니다.

const { Configuration, ApiClient, SignatureApi, DeleteSignaturesRequest, FileInfo } = require("@groupdocs/signature-cloud");

async function removeSignaturesFromPdf() {
    // Initialize configuration with your GroupDocs credentials
    const config = new Configuration({
        clientId: process.env.GROUPDOCS_CLIENT_ID,
        clientSecret: process.env.GROUPDOCS_CLIENT_SECRET
    });

// Create API client and Signature API instance
    const apiClient = new ApiClient(config);
    const signatureApi = new SignatureApi(apiClient);

// Define source PDF file (must be already uploaded to GroupDocs storage)
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.pdf"; // path in GroupDocs storage

// Prepare request to delete all signatures and store result as a new file
    const deleteRequest = new DeleteSignaturesRequest();
    deleteRequest.fileInfo = fileInfo;
    deleteRequest.outputPath = "output.pdf"; // resulting file path in storage

try {
        const result = await signatureApi.deleteSignatures(deleteRequest);
        console.log("All signatures removed successfully.");
        console.log("Result file stored at:", result.path);
    } catch (err) {
        console.error("Failed to remove signatures:", err);
    }
}

removeSignaturesFromPdf();

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에서 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 문의하십시오.

cURL을 사용하여 REST API로 PDF 서명 제거

아래는 GroupDocs REST API를 통해 동일한 작업을 수행하는 cURL 명령입니다.

인증하고 액세스 토큰을 얻기

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

소스 PDF를 GroupDocs 스토리지에 업로드

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary @input.pdf

삭제 서명 작업 실행

curl -X POST "https://api.groupdocs.cloud/v2.0/signature/delete" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "outputPath": "output.pdf"
         }'

결과 PDF 다운로드

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

전체 API 계약은 API Reference를 참조하십시오.

환경 준비하기

npm을 통해 라이브러리를 설치하고 Node.js 버전이 최소 요구 사항을 충족하는지 확인하십시오.

npm install groupdocs-signature-cloud

최신 패키지는 다운로드 페이지에서 다운로드할 수 있습니다. 유효한 GroupDocs 계정이 있고 클라이언트 자격 증명을 생성했는지 확인하십시오.

PDF 서명 제거에 이상적인 GroupDocs.Signature Cloud SDK for Node.js는 무엇인가요

모든 서명 유형 삭제 - 텍스트, 이미지, 바코드, QR 코드 및 디지털 서명을 지원합니다.
클라우드 스토리지 통합 - GroupDocs 클라우드에 저장된 파일과 직접 작업하여 로컬 파일 처리를 없앱니다.
높은 성능 - 대용량 PDF 문서 및 배치 처리에 최적화되었습니다.
포괄적인 API - 전체 REST 엔드포인트가 Node.js 라이브러리에 반영되어 코드 또는 cURL 중 선택할 수 있는 유연성을 제공합니다.
안전한 처리 - 모든 작업이 HTTPS를 통해 수행되며 계정 권한을 준수합니다.

보다 깊은 통찰을 위해, 공식 문서를 참조하십시오.

서명 삭제 옵션 미세 조정

기본 요청은 모든 서명을 제거하지만, 다음과 같은 옵션을 조정할 수 있습니다:

outputPath - 서명되지 않은 PDF에 대해 다른 폴더 또는 파일 이름을 선택하십시오.
fileInfo.password - 원본 PDF가 비밀번호로 보호된 경우, 여기에서 비밀번호를 설정하십시오.

출력 경로 설정 예시 (이미 위 코드 스니펫에 표시됨):

deleteRequest.outputPath = "output.pdf";

추가 매개변수는 API 참조에 나열되어 있습니다.

PDF에서 서명 제거를 위한 모범 사례

파일 존재 여부 확인 요청을 보내기 전에 불필요한 API 호출을 방지합니다.
환경 변수를 사용하여 클라이언트 자격 증명을 소스 제어에서 제외합니다.
서명되지 않은 결과를 별도 폴더에 저장하여 원본 서명 문서를 보존합니다.
오류를 우아하게 처리 예외를 잡고 오류 세부 정보를 기록합니다.
다양한 서명 유형으로 테스트하여 삭제 작업이 모든 시나리오에서 정상적으로 작동하는지 확인합니다.

결론

서명된 PDF 문서에서 서명을 제거하는 작업은 GroupDocs.Signature Cloud SDK for Node.js를 사용하면 간단해집니다. 이 라이브러리는 인증, 스토리지 액세스 및 삭제 작업을 몇 줄의 코드만으로 처리하며, REST API도 cURL을 통해 동일한 기능을 제공합니다. 프로덕션 사용을 위해 적절한 라이선스를 획득해야 함을 기억하세요; 가격 정보는 제품 페이지에서 확인할 수 있으며, 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. 이러한 도구를 사용하면 모든 Node.js 워크플로우에서 PDF 서명 제거를 자동화할 수 있습니다.

자주 묻는 질문

GroupDocs.Signature Cloud SDK for Node.js를 사용하여 서명된 PDF 문서에서 서명을 제거하는 방법은?
라이브러리는 클라이언트 ID와 비밀 키를 사용해 인증한 후 DeleteSignatures 엔드포인트를 호출하여 지정된 PDF에서 모든 서명을 제거합니다. 자세한 내용은 GroupDocs.Signature Cloud SDK for Node.js 문서를 참조하세요.
GroupDocs 클라우드 스토리지에 저장된 PDF에서 서명을 삭제할 수 있나요?
예. FileInfo 객체에 저장 경로를 제공하면 SDK가 파일에 직접 접근합니다. 스토리지 처리에 대해서는 공식 문서를 참조하십시오.
원본 서명된 PDF 사본을 보관해야 한다면 어떻게 해야 하나요?
DeleteSignaturesRequest에서 다른 outputPath를 지정하여 원본 파일은 그대로 두고 새 파일에 서명이 없도록 합니다.
이 기능을 프로덕션에서 사용하려면 특별 라이선스가 필요합니까?
프로덕션 사용을 위해서는 유효한 라이선스가 필요합니다. 임시 라이선스는 임시 라이선스 페이지에서 얻을 수 있습니다.

pdf signature removal on Document Processing REST APIs | GroupDocs Cloud