نام (NAME)

pdfsig - ابزار امضاهای دیجیتال در قالب سند انتقال‌پذیر (PDF)

خلاصه دستور (SYNOPSIS)

pdfsig [گزینه‌ها] [فایل-PDF] [فایل-خروجی]

توضیحات (DESCRIPTION)

pdfsig امضاهای دیجیتال موجود در یک سند PDF را اعتبارسنجی می‌کند. همچنین هویت هر امضاکننده (فیلد commonName و نام متمایز کامل گواهی امضاکننده)، زمان و تاریخ امضا، الگوریتم هش استفاده‌شده برای امضا، نوع امضا به همان صورت که در سند PDF قید شده و محدوده‌های امضاشده را همراه با بیانیه‌ای مبنی بر اینکه آیا کل سند امضا شده است یا خیر نمایش می‌دهد. این ابزار همچنین می‌تواند اسناد PDF را امضا کند (با گزینه‌های -add-signature یا -sign).

دستور pdfsig از گواهی‌های معتبر ذخیره‌شده در پایگاه‌داده خدمات امنیت شبکه (NSS) یا در سامانه S/MIME مربوط به GnuPG موسوم به (gpgsm) استفاده می‌کند.

دستور pdfsig همچنین از پروتکل برخط وضعیت گواهی (OCSP) (برای اطلاعات بیشتر به http://en.wikipedia.org/wiki/Online_Certificate_Status_Protocol مراجعه کنید) برای جستجوی برخط گواهی و بررسی ابطال نشدن آن استفاده می‌کند (مگر اینکه گزینه -no-ocsp مشخص شده باشد).

اگر از پیشانه NSS استفاده شود، پایگاه‌داده NSS در مسیرهای زیر جستجو می‌شود:

1: اگر گزینه -nssdir مشخص شده باشد، دایرکتوری تعیین‌شده با این گزینه.
2: پایگاه‌داده گواهی‌های NSS در نمایه پیش‌فرض فایرفاکس، یعنی $HOME/.mozilla/firefox/*.default*.
3: پایگاه‌داده گواهی‌های NSS سیستمی در /etc/pki/nssdb.
4: پایگاه‌داده گواهی‌های NSS کاربر در $HOME/.pki/nssdb.

اگر از پیشانه GPG استفاده شود، گواهی S/MIME از متغیر $GNUPGHOME خوانده می‌شود که پیش‌فرض آن $HOME/.gnupg است.

گزینه‌ها (OPTIONS)

-nssdir [prefix]directory: دایرکتوری پایگاه‌داده حاوی فایل‌های پایگاه‌داده گواهی و کلید را مشخص می‌کند. برای جزئیات مربوط به پیشوند به گزینه -d در certutil(1) مراجعه کنید. در صورت عدم تعیین، سایر مسیرهای جستجوی شرح‌داده‌شده در بخش توضیحات (DESCRIPTION) استفاده می‌شوند.
-nss-pwd password: گذرواژه لازم برای دسترسی به پایگاه‌داده NSS (در صورت وجود) را مشخص می‌کند.
-nocert: گواهی را اعتبارسنجی نمی‌کند.
-no-ocsp: بررسی برخط ابطال گواهی با OCSP را انجام نمی‌دهد (همچنان از فهرست‌های محلی ابطال گواهی (CRL) استفاده می‌شود).
-assert-signer fpr_or_file: این گزینه بررسی می‌کند که آیا امضای پوشش‌دهنده کل سند با کلید تعیین‌شده ایجاد شده است یا خیر. کلید یا به‌صورت یک اثرانگشت یا فایلی شامل فهرست اثرانگشت‌ها مشخص می‌شود. اثرانگشت باید در قالب فشرده (بدون دونقطه یا فاصله میان نویسه‌ها) وارد یا فهرست شود. اگر fpr_or_file یک فایل را مشخص کند، خطوط خالی و خطوطی که با علامت هش (#) شروع می‌شوند نادیده گرفته می‌شوند. تنها برای پیشانه GnuPG در دسترس است.
-no-appearance: هنگام امضای فیلدهای موجود، اطلاعات ظاهری امضا (نام امضاکننده و تاریخ) را اضافه نمی‌کند.
-aia: استفاده از افزونه دسترسی به اطلاعات مرجع (AIA) را برای دریافت گواهی‌های مفقود جهت ایجاد زنجیره گواهی فعال می‌کند.
-dump: تمامی امضاها را در قالب بومی آن‌ها در دایرکتوری جاری ذخیره می‌کند. به احتمال زیاد این قالب یک بسته CMS/PKCS7 بدون فاصله‌گذاری یا با فاصله‌گذاری صفر (unpadded یا zero-padded) است.
-add-signature: یک امضای جدید به سند اضافه می‌کند.
-new-signature-field-name name: نام فیلدی که هنگام افزودن یک امضای جدید باید استفاده شود را مشخص می‌کند. به‌طور پیش‌فرض از یک شناسه تصادفی استفاده خواهد شد.
-sign field: سند را در فیلد امضای موجود و مشخص‌شده در سند امضا می‌کند (باید امضانشده باشد). فیلد می‌تواند با نام فیلد (رشته) یا n-امین فیلد امضا در سند (عدد صحیح) مشخص شود.
-nick nickname: از گواهی با نام مستعار داده‌شده برای امضا استفاده می‌کند (پیشانه NSS). اگر نام مستعار با pkcs11: آغاز شود، به عنوان یک شناسه یکنواخت منبع PKCS#11 در نظر گرفته می‌شود (پیشانه NSS). اگر نام مستعار به‌صورت اثرانگشت داده شود، همان گواهی استفاده خواهد شد (پیشانه GPG).
-backend backend: از پیشانه مشخص‌شده برای امضاهای رمزنگاری استفاده می‌کند.
-kpw password: از گذرواژه داده‌شده برای کلید امضا استفاده می‌کند (در صورتی که کلید محافظت‌شده با گذرواژه نباشد ممکن است به این گزینه نیازی نباشد).
-digest algorithm: از الگوریتم خلاصه‌ساز داده‌شده برای امضا استفاده می‌کند (پیش‌فرض: SHA256).
-reason reason: رشته دلیل داده‌شده را برای امضا تنظیم می‌کند (پیش‌فرض: دلیلی تنظیم نشده است).
-enable-pgp: امضاهای pgp را در پیشانه GnuPG فعال می‌کند. تنها برای پیشانه GnuPG در دسترس است.
-etsi: امضایی از نوع ETSI.CAdES.detached به جای adbe.pkcs7.detached ایجاد می‌کند.
-list-nicks: نام‌های مستعار موجود در پایگاه‌داده NSS را فهرست می‌کند.
-list-backends: پیشانه‌های موجود برای امضاهای رمزنگاری را فهرست می‌کند.
-v: اطلاعات حق نشر و نگارش را چاپ می‌کند.
-h: اطلاعات نحوه استفاده را چاپ می‌کند. (-help و --help معادل یکدیگر هستند.)

مثال‌ها (EXAMPLES)

pdfsig signed_file.pdf: اطلاعات امضای فایل signed_file.pdf را نمایش می‌دهد.
pdfsig input.pdf output.pdf -add-signature -nss-pwd password -nick my-cert -reason 'for fun!': یک فایل pdf جدید به نام output.pdf با محتویات input.pdf ایجاد می‌کند که توسط گواهی 'my-cert' امضا شده است.
pdfsig input.pdf output.pdf -add-signature -nss-pwd password -nick 'pkcs11:token=smartcard0;object=Second%20certificate;type=cert': مشابه حالت قبل، اما از یک نشانی PKCS#11 URI طبق تعریف IETF RFC 7512 برای انتخاب گواهی مورد استفاده جهت امضا بهره می‌برد.
pdfsig input.pdf output.pdf -sign 0 -nss-pwd password -nick my-cert -reason 'for fun!': یک فایل pdf جدید به نام output.pdf با محتویات input.pdf ایجاد می‌کند که توسط گواهی 'my-cert' امضا شده است. فایل input.pdf باید از قبل یک فیلد امضای موجود و امضانشده داشته باشد.

نویسندگان (AUTHORS)

حق نشر نرم‌افزار و مستندات pdfsig متعلق به سال‌های 1996-2004 شرکت Glyph & Cog, LLC و سال‌های 2005-2015 توسعه‌دهندگان Poppler است - http://poppler.freedesktop.org

همچنین ببینید (SEE ALSO)

pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1), pdftohtml(1), pdftoppm(1), pdftops(1), pdftotext(1), pdfseparate(1), pdfunite(1), certutil(1)