'\" t .\" Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" .\" This code is free software; you can redistribute it and/or modify it .\" under the terms of the GNU General Public License version 2 only, as .\" published by the Free Software Foundation. .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" .\" You should have received a copy of the GNU General Public License version .\" 2 along with this work; if not, write to the Free Software Foundation, .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" .\" Arch: generic .\" Software: JDK 8 .\" Date: 21 November 2013 .\" SectDesc: Security Tools .\" Title: jarsigner.1 .\" .if n .pl 99999 .TH jarsigner 1 "21 November 2013" "JDK 8" "ابزارهای امنیتی" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" jarsigner-openjdk8 \- ابزار امضا و اعتبارسنجی فایل‌های JAR در OpenJDK 8 .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fBjarsigner\fR [ \fIoptions\fR ] \fIjar\-file\fR \fIalias\fR .fi .nf \fBjarsigner\fR \fB\-verify\fR [ \fIoptions\fR ] \fIjar\-file\fR [\fIalias \&.\&.\&.\fR] .fi .sp .TP \fIoptions\fR گزینه‌های خط فرمان. بخش گزینه‌ها را ببینید. .TP -verify .br گزینه .B \-verify می‌تواند صفر یا چند نام مستعار مخزن کلید (keystore alias) را بعد از نام فایل JAR دریافت کند. هنگامی که گزینه .B \-verify مشخص می‌شود، دستور .B jarsigner بررسی می‌کند که گواهی استفاده‌شده برای اعتبارسنجی هر مدخل امضاشده در فایل JAR با یکی از نام‌های مستعار مخزن کلید مطابقت داشته باشد. این نام‌های مستعار در مخزن کلید مشخص‌شده با .B \-keystore یا در مخزن کلید پیش‌فرض تعریف شده‌اند. اگر گزینه .B \-strict نیز مشخص شده باشد و دستور .B jarsigner هشدارهای شدیدی شناسایی کند، پیام "jar verified, with signer errors" نمایش داده می‌شود. .TP \fIjar-file\fR فایل JAR که باید امضا شود. اگر گزینه .B \-strict نیز مشخص شده باشد و دستور .B jarsigner هشدارهای شدیدی شناسایی کند، پیام "jar signed, with signer errors" نمایش داده می‌شود. .TP \fIalias\fR نام‌های مستعار در مخزن کلید تعیین‌شده توسط .B \-keystore یا در مخزن کلید پیش‌فرض تعریف می‌شوند. .SH "توضیحات (DESCRIPTION)" ابزار .B jarsigner دو هدف اصلی دارد: .TP 0.2i \(bu امضای فایل‌های آرشیو جاوا (JAR). .TP 0.2i \(bu اعتبارسنجی امضاها و بررسی یکپارچگی فایل‌های JAR امضاشده. .PP قابلیت JAR امکان بسته‌بندی فایل‌های کلاس، تصاویر، صداها و سایر داده‌های دیجیتال را در یک تک‌فایل جهت توزیع سریع‌تر و آسان‌تر فراهم می‌کند. ابزاری به نام .B jar به توسعه‌دهندگان امکان ساخت فایل‌های JAR را می‌دهد. (از نظر فنی، هر فایل zip نیز می‌تواند یک فایل JAR تلقی شود، هرچند وقتی توسط دستور .B jar ایجاد شده یا توسط دستور .B jarsigner پردازش می‌شود، فایل‌های JAR شامل یک فایل .B META-INF/MANIFEST.MF نیز خواهند بود.) .PP امضای دیجیتال رشته‌ای از بیت‌ها است که از روی داده‌ها (داده‌های در حال امضا) و کلید خصوصی یک هویت (شخص، شرکت و غیره) محاسبه می‌شود. همانند یک امضای دست‌نویس، امضای دیجیتال ویژگی‌های مفید بسیاری دارد: .TP 0.2i \(bu اصالت آن می‌تواند از طریق محاسباتی با استفاده از کلید عمومی متناظر با کلید خصوصی تولیدکننده امضا اعتبارسنجی شود. .TP 0.2i \(bu با فرض مخفی ماندن کلید خصوصی، قابل جعل نیست. .TP 0.2i \(bu تابعی از داده‌های امضاشده است و در نتیجه نمی‌توان آن را به عنوان امضای داده‌های دیگر نیز به کار برد. .TP 0.2i \(bu داده‌های امضاشده قابل تغییر نیستند. اگر داده‌ها تغییر کنند، امضا دیگر به عنوان امضای معتبر تایید نخواهد شد. .PP برای تولید امضای یک نهاد برای یک فایل، آن نهاد باید ابتدا یک جفت کلید عمومی/خصوصی مرتبط با خود و یک یا چند گواهی تاییدکننده کلید عمومی خود داشته باشد. گواهی، بیانیه‌ای با امضای دیجیتال از یک نهاد است که تایید می‌کند کلید عمومی نهادی دیگر دارای مقداری مشخص است. .PP دستور .B jarsigner از اطلاعات کلید و گواهی موجود در یک مخزن کلید (keystore) برای تولید امضاهای دیجیتال برای فایل‌های JAR استفاده می‌کند. مخزن کلید پایگاه‌داده‌ای از کلیدهای خصوصی و زنجیره‌های گواهی X.509 مرتبط با آنها است که کلیدهای عمومی متناظر را اعتبارسنجی می‌کنند. دستور .B keytool برای ایجاد و مدیریت مخازن کلید استفاده می‌شود. .PP دستور .B jarsigner از کلید خصوصی یک نهاد برای تولید امضا استفاده می‌کند. فایل JAR امضاشده شامل مواردی از جمله نسخه‌ای از گواهی موجود در مخزن کلید برای کلید عمومی متناظر با کلید خصوصی استفاده‌شده برای امضای فایل است. دستور .B jarsigner می‌تواند امضای دیجیتال فایل JAR امضاشده را با استفاده از گواهی درون آن (در فایل بلوک امضا) تایید کند. .PP دستور .B jarsigner می‌تواند امضاهایی شامل برچسب زمانی (timestamp) ایجاد کند که به سیستم‌ها یا مستقرکنندگان (از جمله Java Plug-in) امکان می‌دهد بررسی کنند آیا فایل JAR زمانی که گواهی امضا هنوز معتبر بوده امضا شده است یا خیر. علاوه بر این، رابط‌های برنامه‌نویسی (API) به برنامه‌ها اجازه می‌دهند اطلاعات برچسب زمانی را دریافت کنند. .PP در حال حاضر، دستور .B jarsigner تنها می‌تواند فایل‌های JAR ساخته‌شده با دستور .B jar یا فایل‌های zip را امضا کند. فایل‌های JAR مشابه فایل‌های zip هستند، با این تفاوت که فایل .B META-INF/MANIFEST.MF نیز دارند. وقتی دستور .B jarsigner یک فایل zip را امضا می‌کند، یک فایل .B META-INF/MANIFEST.MF ساخته می‌شود. .PP رفتار پیش‌فرض دستور .B jarsigner امضای یک فایل JAR یا zip است. از گزینه .B \-verify برای اعتبارسنجی یک فایل JAR امضاشده استفاده کنید. .PP دستور .B jarsigner همچنین پس از امضا یا اعتبارسنجی تلاش می‌کند گواهی امضاکننده را ارزیابی کند. اگر خطای اعتبارسنجی یا هر مشکل دیگری وجود داشته باشد، این دستور پیام‌های هشدار تولید می‌کند. اگر گزینه .B \-strict را مشخص کنید، این دستور با هشدارهای شدید مانند خطا رفتار خواهد کرد. بخش خطاها و هشدارها را ببینید. .SS "نام‌های مستعار مخزن کلید (KEYSTORE ALIASES)" تمام موجودیت‌های مخزن کلید از طریق نام‌های مستعار یکتا (aliases) قابل دسترسی هستند. .PP هنگامی که از دستور .B jarsigner برای امضای یک فایل JAR استفاده می‌کنید، باید نام مستعار مدخلی در مخزن کلید را که حاوی کلید خصوصی مورد نیاز برای تولید امضا است مشخص کنید. به عنوان مثال، دستور زیر فایل JAR به نام .B MyJARFile.jar را با کلید خصوصی مرتبط با نام مستعار .B duke در مخزن کلید .B mystore در دایرکتوری .B working امضا می‌کند. از آنجا که فایل خروجی مشخص نشده است، فایل .B MyJARFile.jar را با فایل JAR امضاشده بازنویسی می‌کند. .sp .nf \f3jarsigner \-keystore /working/mystore \-storepass \fP .fi .nf \f3 \-keypass MyJARFile\&.jar duke\fP .fi .nf \f3\fR .fi .sp مخازن کلید با رمز عبور محافظت می‌شوند، بنابراین رمز عبور مخزن باید مشخص شود. در صورت عدم ذکر آن در خط فرمان، از شما پرسیده خواهد شد. به طور مشابه، کلیدهای خصوصی در یک مخزن کلید با رمز عبور محافظت می‌شوند، بنابراین رمز عبور کلید خصوصی باید مشخص گردد و اگر در خط فرمان ذکر نشود و با رمز عبور مخزن یکسان نباشد، از شما پرسیده می‌شود. .SS "محل مخزن کلید (KEYSTORE LOCATION)" دستور .B jarsigner دارای گزینه .B \-keystore برای تعیین URL مخزن کلید مورد استفاده است. مخزن کلید به طور پیش‌فرض در فایلی به نام .B .keystore در دایرکتوری خانگی کاربر بر اساس مشخصه سیستمی .B user.home ذخیره می‌شود. .PP در سیستم‌های Oracle Solaris، مقدار .B user.home به طور پیش‌فرض دایرکتوری خانگی کاربر است. .PP جریان ورودی از گزینه .B \-keystore به متد .B KeyStore.load پاس داده می‌شود. اگر .B NONE به عنوان URL مشخص شود، یک جریان خالی (null) به متد .B KeyStore.load منتقل می‌شود. مقدار .B NONE زمانی باید مشخص شود که کلاس .B KeyStore مبتنی بر فایل نباشد، برای مثال هنگامی که روی یک دستگاه توکن سخت‌افزاری قرار دارد. .SS "پیاده‌سازی مخزن کلید (KEYSTORE IMPLEMENTATION)" کلاس .B KeyStore ارائه‌شده در بسته .B java.security تعدادی رابط تعریف‌شده برای دسترسی و اصلاح اطلاعات موجود در مخزن کلید فراهم می‌کند. شما می‌توانید چندین پیاده‌سازی عینی مختلف داشته باشید که هر پیاده‌سازی برای نوع خاصی از مخزن کلید است. .PP در حال حاضر، دو ابزار خط فرمان وجود دارند که از پیاده‌سازی‌های مخزن کلید استفاده می‌کنند (شامل .B keytool و .BR jarsigner ) و همچنین یک ابزار گرافیکی به نام Policy Tool. از آنجا که کلاس .B KeyStore به طور عمومی در دسترس است، کاربران JDK می‌توانند برنامه‌های امنیتی بیشتری بنویسند که از آن استفاده کنند. .PP یک پیاده‌سازی پیش‌فرض داخلی توسط Oracle ارائه شده است که مخزن کلید را به صورت فایل پیاده‌سازی کرده و از نوع انحصاری مخزن کلید به نام JKS استفاده می‌کند. پیاده‌سازی داخلی از هر کلید خصوصی با رمز عبور اختصاصی آن محافظت کرده و یکپارچگی کل مخزن کلید را با یک رمز عبور (احتمالاً متفاوت) محافظت می‌کند. .PP پیاده‌سازی‌های مخزن کلید مبتنی بر ارائه‌دهنده (provider-based) هستند، به این معنی که رابط‌های برنامه‌نویسی ارائه‌شده توسط کلاس .B KeyStore بر اساس یک Service Provider Interface (SPI) پیاده‌سازی شده‌اند. یک کلاس انتزاعی متناظر .B KeystoreSpi نیز در بسته .B java.security وجود دارد که متدهای SPI را که ارائه‌دهندگان باید پیاده‌سازی کنند تعریف می‌کند. اصطلاح ارائه‌دهنده به یک بسته یا مجموعه‌ای از بسته‌ها اشاره دارد که پیاده‌سازی عینی زیرمجموعه‌ای از سرویس‌ها را که توسط Java Security API قابل دسترسی هستند فراهم می‌کنند. برای ارائه یک پیاده‌سازی مخزن کلید، کلاینت‌ها باید یک ارائه‌دهنده را پیاده‌سازی کرده و پیاده‌سازی زیرکلاس .B KeystoreSpi را فراهم کنند، همان‌گونه که در راهنمای پیاده‌سازی ارائه‌دهنده در مستندات جاوا شرح داده شده است: .PP برنامه‌ها می‌توانند انواع مختلفی از پیاده‌سازی‌های مخزن کلید را از ارائه‌دهندگان مختلف با استفاده از متد فکتوری .B getInstance در کلاس .B KeyStore انتخاب کنند. نوع مخزن کلید، ساختار ذخیره‌سازی و قالب داده‌های اطلاعات مخزن کلید و همچنین الگوریتم‌های محافظت از کلیدهای خصوصی و یکپارچگی خود مخزن را تعریف می‌کند. پیاده‌سازی‌های مخزن کلید با انواع مختلف با یکدیگر سازگار نیستند. .PP دستورات .B jarsigner و .B policytool می‌توانند مخازن کلید مبتنی بر فایل را از هر مکانی که با یک URL قابل تعریف باشد بخوانند. علاوه بر این، این دستورات می‌توانند مخازن کلید غیر مبتنی بر فایل نظیر موارد ارائه‌شده توسط MSCAPI در ویندوز و PKCS11 در تمام پلتفرم‌ها را نیز بخوانند. .PP برای دستورات .B jarsigner و .BR keytool ، می‌توانید نوع مخزن کلید را در خط فرمان با گزینه .B \-storetype مشخص کنید. برای Policy Tool، می‌توانید نوع مخزن کلید را با دستور .I Edit در منوی .I KeyStore تعیین کنید. .PP اگر به صراحت نوع مخزن کلید را مشخص نکنید، ابزارها پیاده‌سازی مخزن کلید را بر اساس مقدار مشخصه .B keystore.type تعریف‌شده در فایل مشخصه‌های امنیتی انتخاب می‌کنند. فایل مشخصه‌های امنیتی .B java.security نام دارد و در دایرکتوری مشخصه‌های امنیتی JDK در مسیر .B java.home/lib/security قرار دارد، که در آن .B java.home دایرکتوری محیط زمان اجرا (دایرکتوری .B jre در JDK یا دایرکتوری اصلی JRE) است. .PP هر ابزار مقدار .B keystore.type را دریافت کرده و سپس تمام ارائه‌دهندگان نصب‌شده را بررسی می‌کند تا ارائه‌دهنده‌ای را پیدا کند که مخازن کلید آن نوع را پیاده‌سازی کرده است. سپس از پیاده‌سازی مخزن کلید آن ارائه‌دهنده استفاده می‌کند. .PP کلاس .B KeyStore یک متد استاتیک به نام .B getDefaultType تعریف می‌کند که به برنامه‌ها و اپلت‌ها اجازه می‌دهد مقدار مشخصه .B keystore.type را بازیابی کنند. خط کد زیر یک نمونه از نوع پیش‌فرض مخزن کلید مشخص‌شده در مشخصه .B keystore.type ایجاد می‌کند: .sp .nf \f3KeyStore keyStore = KeyStore\&.getInstance(KeyStore\&.getDefaultType());\fP .fi .nf \f3\fR .fi .sp نوع پیش‌فرض مخزن کلید .B jks است (نوع انحصاری پیاده‌سازی مخزن کلید ارائه‌شده توسط Oracle). این مقدار با خط زیر در فایل مشخصه‌های امنیتی مشخص می‌شود: .sp .nf \f3keystore\&.type=jks\fP .fi .nf \f3\fR .fi .sp بزرگی و کوچکی حروف در نام نوع مخزن کلید اهمیتی ندارد. به عنوان مثال، .B JKS با .B jks یکسان است. .PP برای اینکه ابزارها از پیاده‌سازی مخزن کلیدی غیر از پیش‌فرض استفاده کنند، آن خط را برای مشخص کردن نوع دیگری از مخزن کلید تغییر دهید. برای مثال، اگر بسته‌ای دارید که پیاده‌سازی مخزن کلید از نوع .B pkcs12 را فراهم می‌کند، خط را به صورت زیر تغییر دهید: .sp .nf \f3keystore\&.type=pkcs12\fP .fi .nf \f3\fR .fi .sp \fIنکته:\fR اگر از بسته ارائه‌دهنده PKCS 11 استفاده می‌کنید، بخش‌های "KeyTool" و "JarSigner" را در راهنمای مرجع Java PKCS #11 در نشانی زیر ببینید: .SS "الگوریتم‌های پشتیبانی‌شده (SUPPORTED ALGORITHMS)" به طور پیش‌فرض، دستور .B jarsigner یک فایل JAR را با استفاده از یکی از الگوریتم‌های زیر امضا می‌کند: .TP 0.2i \(bu الگوریتم امضای دیجیتال (DSA) با الگوریتم خلاصه پیام SHA1 .TP 0.2i \(bu الگوریتم RSA با الگوریتم خلاصه پیام SHA256 .TP 0.2i \(bu الگوریتم رمزنگاری منحنی بیضوی (EC) با SHA256 همراه با الگوریتم امضای دیجیتال منحنی بیضوی (ECDSA). .PP اگر کلیدهای عمومی و خصوصی امضاکننده از نوع DSA باشند، .B jarsigner فایل JAR را با الگوریتم .B SHA1withDSA امضا می‌کند. اگر کلیدهای امضاکننده از نوع RSA باشند، .B jarsigner تلاش می‌کند فایل JAR را با الگوریتم .B SHA256withRSA امضا کند. اگر کلیدهای امضاکننده از نوع EC باشند، .B jarsigner فایل JAR را با الگوریتم .B SHA256withECDSA امضا می‌کند. .PP این الگوریتم‌های امضای پیش‌فرض را می‌توان با استفاده از گزینه .B \-sigalg تغییر داد. .SS "فایل JAR امضاشده (THE SIGNED JAR FILE)" هنگامی که از دستور .B jarsigner برای امضای یک فایل JAR استفاده می‌شود، فایل JAR خروجی دقیقاً همانند فایل JAR ورودی است، با این تفاوت که دو فایل اضافی در دایرکتوری META-INF آن قرار می‌گیرد: .TP 0.2i \(bu یک فایل امضا با پسوند .B .SF .TP 0.2i \(bu یک فایل بلوک امضا با پسوند .BR .DSA ، .B .RSA یا .B .EC .PP نام پایه این دو فایل از مقدار گزینه .B \-sigfile گرفته می‌شود. به عنوان مثال، هنگامی که گزینه .B \-sigfile MKSIGN باشد، نام فایل‌ها .B MKSIGN.SF و .B MKSIGN.DSA خواهد بود. .PP اگر هیچ گزینه .B \-sigfile در خط فرمان مشخص نشود، نام پایه فایل‌های .B .SF و .B .DSA برابر با ۸ کاراکتر اول نام مستعار مشخص‌شده در خط فرمان (تبدیل‌شده به حروف بزرگ) خواهد بود. اگر نام مستعار کمتر از ۸ کاراکتر داشته باشد، کل نام مستعار استفاده می‌شود. اگر نام مستعار شامل کاراکترهایی باشد که در نام فایل امضا مجاز نیستند، هر یک از این کاراکترها به یک خط زیر (_) تبدیل می‌شوند. کاراکترهای مجاز شامل حروف، ارقام، خط زیر و خط تیره هستند. .PP فایل امضا (Signature File) یک فایل امضا (فایل .BR .SF ) مشابه فایل مانیفست است که همیشه هنگام استفاده از دستور .B jarsigner برای امضای فایل، در فایل JAR گنجانده می‌شود. برای هر فایل مبدا موجود در فایل JAR، فایل .B .SF سه خط دارد که موارد زیر را فهرست می‌کند: .TP 0.2i \(bu نام فایل .TP 0.2i \(bu نام الگوریتم خلاصه پیام (SHA) .TP 0.2i \(bu مقدار خلاصه پیام SHA .PP در فایل مانیفست، مقدار خلاصه پیام SHA برای هر فایل مبدا، هش داده‌های باینری در فایل مبدا است. در فایل .BR .SF ، مقدار خلاصه برای یک فایل مبدا مشخص، هش سه خط مربوط به آن فایل مبدا در فایل مانیفست است. .PP فایل امضا به طور پیش‌فرض شامل هدر با هشی از کل فایل مانیفست است. این هدر همچنین شامل هش هدر مانیفست است. وجود این هدر امکان بهینه‌سازی اعتبارسنجی را فراهم می‌کند. بخش اعتبارسنجی فایل JAR را ببینید. .PP فایل بلوک امضا (Signature Block File) فایل .B .SF امضا شده و امضا در فایل بلوک امضا قرار می‌گیرد. این فایل همچنین شامل گواهی یا زنجیره گواهی کدگذاری‌شده از مخزن کلید است که کلید عمومی متناظر با کلید خصوصی استفاده‌شده برای امضا را تایید می‌کند. این فایل بسته به الگوریتم خلاصه پیام استفاده‌شده دارای پسوند .BR .DSA ، .B .RSA یا .B .EC است. .SS "برچسب زمانی امضا (SIGNATURE TIME STAMP)" دستور .B jarsigner می‌تواند هنگام امضای فایل JAR، یک برچسب زمانی امضا (signature time stamp) تولید و ذخیره کند. علاوه بر این، .B jarsigner از مکانیزم‌های امضای جایگزین پشتیبانی می‌کند. این رفتار اختیاری بوده و توسط کاربر در زمان امضا از طریق گزینه‌ها کنترل می‌شود. بخش گزینه‌ها را ببینید. .sp .nf \f3\-tsa \fIurl\fR\fP .fi .nf \f3\-tsacert \fIalias\fR\fP .fi .nf \f3\-altsigner \fIclass\fR\fP .fi .nf \f3\-altsignerpath \fIclasspathlist\fR\fP .fi .nf \f3\-tsapolicyid \fIpolicyid\fR\fP .fi .nf \f3\fR .fi .sp .SS "اعتبارسنجی فایل JAR (JAR FILE VERIFICATION)" اعتبارسنجی موفقیت‌آمیز فایل JAR زمانی رخ می‌دهد که امضاها معتبر باشند و هیچ‌یک از فایل‌هایی که هنگام تولید امضا در فایل JAR وجود داشتند از آن زمان تغییر نکرده باشند. اعتبارسنجی فایل JAR شامل مراحل زیر است: .TP 0.4i 1\&. امضای فایل .B .SF را بررسی کنید. این اعتبارسنجی اطمینان حاصل می‌کند که امضای ذخیره‌شده در هر فایل بلوک امضا .RB ( .DSA ) با استفاده از کلید خصوصی متناظر با کلید عمومی که گواهی (یا زنجیره گواهی) آن نیز در فایل .B .DSA آمده است تولید شده است. همچنین اطمینان می‌دهد که امضا، امضای معتبری از فایل امضای متناظر .RB ( .SF ) است و بنابراین فایل .B .SF دستکاری نشده است. .TP 0.4i 2\&. خلاصه پیام فهرست‌شده در هر مدخل در فایل .B .SF را با هر بخش متناظر در مانیفست تطبیق دهید. فایل .B .SF به طور پیش‌فرض شامل هدر حاوی هش کل فایل مانیفست است. وقتی هدر وجود دارد، اعتبارسنجی می‌تواند بررسی کند که آیا هش موجود در هدر با هش فایل مانیفست مطابقت دارد یا خیر. در صورت وجود تطابق، اعتبارسنجی به مرحله بعد می‌رود. اگر تطابقی وجود نداشته باشد، اعتبارسنجی با بهینه‌سازی کمتری لازم است تا اطمینان حاصل شود که هش در بخش اطلاعات هر فایل مبدا در فایل .B .SF برابر با هش بخش متناظر آن در فایل مانیفست است. بخش فایل امضا را ببینید. یکی از دلایلی که ممکن است هش فایل مانیفست ذخیره‌شده در هدر فایل .B .SF با هش فایل مانیفست فعلی برابر نباشد این است که پس از تولید امضا و فایل .BR .SF ، یک یا چند فایل با ابزار .B jar به فایل JAR اضافه شده باشند. هنگامی که از ابزار .B jar برای افزودن فایل‌ها استفاده می‌شود، فایل مانیفست با افزودن بخش‌هایی برای فایل‌های جدید تغییر می‌کند، اما فایل .B .SF تغییر نمی‌کند. اعتبارسنجی همچنان موفق در نظر گرفته می‌شود اگر هیچ‌یک از فایل‌هایی که هنگام تولید امضا در فایل JAR وجود داشتند تغییر نکرده باشند. این حالت زمانی رخ می‌دهد که هش‌های موجود در بخش‌های غیر هدر فایل .B .SF با هش‌های بخش‌های متناظر در فایل مانیفست برابر باشند. .TP 0.4i 3\&. هر فایلی در فایل JAR را که مدخلی در فایل .B .SF دارد بخوانید. هنگام خواندن، خلاصه پیام فایل را محاسبه کرده و نتیجه را با خلاصه مربوط به این فایل در بخش مانیفست مقایسه کنید. خلاصه‌ها باید یکسان باشند، در غیر این صورت اعتبارسنجی با شکست مواجه می‌شود. اگر در طول فرآیند اعتبارسنجی خرابی جدی رخ دهد، فرآیند متوقف شده و یک استثنای امنیتی (security exception) صادر می‌شود. دستور .B jarsigner این استثنا را دریافت کرده و نمایش می‌دهد. .PP \fIنکته:\fR شما باید هشدارهای اضافی (یا خطاهایی در صورت مشخص کردن گزینه .BR \-strict ) و همچنین محتوای گواهی را (با مشخص کردن گزینه‌های .B \-verbose و .BR \-certs ) بررسی کنید تا مشخص شود آیا امضا قابل اعتماد است یا خیر. .SS "امضاهای چندگانه برای یک فایل JAR (MULTIPLE SIGNATURES FOR A JAR FILE)" یک فایل JAR می‌تواند توسط چندین نفر با اجرای چندباره دستور .B jarsigner روی فایل و مشخص کردن نام مستعار برای افراد مختلف در هر بار امضا شود: .sp .nf \f3jarsigner myBundle\&.jar susan\fP .fi .nf \f3jarsigner myBundle\&.jar kevin\fP .fi .nf \f3\fR .fi .sp هنگامی که یک فایل JAR چندین بار امضا می‌شود، چندین فایل .B .SF و .B .DSA در فایل JAR حاصل وجود خواهد داشت، یک جفت برای هر امضا. در مثال قبل، فایل JAR خروجی شامل فایل‌هایی با نام‌های زیر خواهد بود: .sp .nf \f3SUSAN\&.SF\fP .fi .nf \f3SUSAN\&.DSA\fP .fi .nf \f3KEVIN\&.SF\fP .fi .nf \f3KEVIN\&.DSA\fP .fi .sp .SH "گزینه‌ها (OPTIONS)" بخش‌های زیر گزینه‌های مختلف .B jarsigner را شرح می‌دهند. استانداردهای زیر را مد نظر داشته باشید: .TP 0.2i \(bu تمام نام‌های گزینه‌ها با یک خط تیره (-) شروع می‌شوند. .TP 0.2i \(bu گزینه‌ها را می‌توان به هر ترتیبی ارائه داد. .TP 0.2i \(bu مواردی که با حروف کج یا زیرخط‌دار هستند (مقادیر گزینه‌ها) نشان‌دهنده مقادیر واقعی هستند که باید وارد شوند. .TP 0.2i \(bu گزینه‌های .BR \-storepass ، .BR \-keypass ، .BR \-sigfile ، .BR \-sigalg ، .BR \-digestalg ، .B \-signedjar و گزینه‌های مربوط به TSA تنها هنگام امضای یک فایل JAR کاربرد دارند؛ آنها هنگام اعتبارسنجی فایل JAR امضاشده کاربردی ندارند. گزینه .B \-keystore هم برای امضا و هم برای اعتبارسنجی فایل JAR کاربرد دارد. علاوه بر این، نام‌های مستعار هنگام امضا و اعتبارسنجی فایل JAR مشخص می‌شوند. .TP -keystore \fIurl\fR .br نشانی URL نشان‌دهنده محل مخزن کلید را مشخص می‌کند. مقدار پیش‌فرض آن فایل .B .keystore در دایرکتوری خانگی کاربر بر اساس مشخصه سیستمی .B user.home است. هنگام امضا داشتن یک مخزن کلید الزامی است. در صورتی که مخزن کلید پیش‌فرض وجود نداشته باشد یا بخواهید از مخزنی غیر از پیش‌فرض استفاده کنید، باید صراحتاً یک مخزن کلید مشخص کنید. هنگام اعتبارسنجی مخزن کلید الزامی نیست، اما اگر مشخص شده باشد یا مخزن کلید پیش‌فرض موجود باشد و گزینه .B \-verbose نیز مشخص شده باشد، اطلاعات بیشتری در مورد اینکه آیا هر یک از گواهی‌های استفاده‌شده برای اعتبارسنجی فایل JAR در آن مخزن کلید وجود دارند یا خیر نمایش داده می‌شود. آرگومان .B \-keystore می‌تواند به جای URL نام فایل و مسیر باشد که در این صورت مانند یک URL از نوع :file با آن رفتار می‌شود؛ به عنوان مثال موارد زیر معادل هستند: .sp .nf \f3\-keystore \fIfilePathAndName\fR\fP .fi .nf \f3\-keystore file:\fIfilePathAndName\fR\fP .fi .nf \f3\fR .fi .sp اگر ارائه‌دهنده Sun PKCS #11 در فایل مشخصه‌های امنیتی .B java.security (واقع در دایرکتوری .B $JAVA_HOME/lib/security مربوط به JRE) پیکربندی شده باشد، ابزارهای .B keytool و .B jarsigner می‌توانند با مشخص کردن این گزینه‌ها روی توکن PKCS #11 کار کنند: .sp .nf \f3\-keystore NONE\fP .fi .nf \f3\-storetype PKCS11\fP .fi .nf \f3\fR .fi .sp برای مثال، دستور زیر محتویات توکن PKCS#11 پیکربندی‌شده را فهرست می‌کند: .sp .nf \f3keytool \-keystore NONE \-storetype PKCS11 \-list\fP .fi .nf \f3\fR .fi .sp .TP -storetype \fIstoretype\fR .br نوع مخزن کلید برای نمونه‌سازی را مشخص می‌کند. نوع پیش‌فرض مخزن کلید مقداری است که به عنوان مشخصه .B keystore.type در فایل مشخصه‌های امنیتی تعیین شده و توسط متد استاتیک .B getDefaultType در .B java.security.KeyStore برگردانده می‌شود. کد PIN برای یک توکن PKCS #11 نیز می‌تواند با گزینه .B \-storepass مشخص شود. در صورت عدم تعیین، دستورات .B keytool و .B jarsigner کد PIN توکن را درخواست می‌کنند. اگر توکن دارای مسیر احراز هویت محافظت‌شده باشد (مانند صفحه کلید PIN اختصاصی یا اثرانگشت‌خوان)، باید گزینه .B \-protected مشخص شود و هیچ گزینه رمز عبوری نباید داده شود. .TP -storepass[:env | :file] \fIargument\fR .br رمز عبور مورد نیاز برای دسترسی به مخزن کلید را مشخص می‌کند. این گزینه فقط هنگام امضا کردن (نه اعتبارسنجی) فایل JAR نیاز است. در این حالت، اگر گزینه .B \-storepass در خط فرمان ارائه نشود، رمز عبور از کاربر پرسیده می‌شود. اگر اصلاح‌کننده .B env یا .B file مشخص نشود، رمز عبور دارای مقدار .I argument خواهد بود. در غیر این صورت، رمز عبور به شرح زیر بازیابی می‌شود: .RS .TP 0.2i \(bu \f3env\fR: رمز عبور را از متغیر محیطی به نام \f3argument\fR بازیابی می‌کند. .TP 0.2i \(bu \f3file\fR: رمز عبور را از فایل به نام \f3argument\fR بازیابی می‌کند. .RE \fIنکته:\fR رمز عبور نباید در خط فرمان یا در یک اسکریپت مشخص شود مگر اینکه برای اهداف آزمایشی باشد یا در یک سیستم امن قرار داشته باشید. .TP -keypass [:env | :file] \fIargument\fR .br رمز عبور مورد استفاده برای محافظت از کلید خصوصی مدخل مخزن کلید مشخص‌شده با نام مستعار در خط فرمان را تعیین می‌کند. هنگام استفاده از .B jarsigner برای امضای فایل JAR این رمز عبور الزامی است. اگر هیچ رمز عبوری در خط فرمان ارائه نشود و رمز عبور لازم با رمز عبور مخزن متفاوت باشد، از کاربر درخواست می‌شود. اگر اصلاح‌کننده .B env یا .B file مشخص نشود، رمز عبور دارای مقدار .I argument خواهد بود. در غیر این صورت، رمز عبور به شرح زیر بازیابی می‌شود: .RS .TP 0.2i \(bu \f3env\fR: رمز عبور را از متغیر محیطی به نام \f3argument\fR بازیابی می‌کند. .TP 0.2i \(bu \f3file\fR: رمز عبور را از فایل به نام \f3argument\fR بازیابی می‌کند. .RE \fIنکته:\fR رمز عبور نباید در خط فرمان یا در یک اسکریپت مشخص شود مگر اینکه برای اهداف آزمایشی باشد یا در یک سیستم امن قرار داشته باشید. .TP -sigfile \fIfile\fR .br نام پایه فایل مورد استفاده برای فایل‌های تولیدشده .B .SF و .B .DSA را مشخص می‌کند. به عنوان مثال، اگر فایل .B DUKESIGN باشد، فایل‌های تولیدشده .B .SF و .B .DSA به نام‌های .B DUKESIGN.SF و .B DUKESIGN.DSA نام‌گذاری شده و در دایرکتوری .B META-INF فایل JAR امضاشده قرار می‌گیرند. کاراکترهای موجود در فایل باید از مجموعه .B a-zA-Z0-9_- باشند. فقط حروف، اعداد، خط زیر و خط تیره مجاز هستند. تمام حروف کوچک برای نام فایل‌های .B .SF و .B .DSA به حروف بزرگ تبدیل می‌شوند. اگر هیچ گزینه .B \-sigfile در خط فرمان مشخص نشود، نام پایه فایل‌های .B .SF و .B .DSA برابر با ۸ کاراکتر اول نام مستعار مشخص‌شده در خط فرمان (تبدیل‌شده به حروف بزرگ) خواهد بود. اگر نام مستعار کمتر از ۸ کاراکتر باشد، از کل نام مستعار استفاده می‌شود. اگر نام مستعار شامل کاراکترهایی باشد که در نام فایل امضا معتبر نیستند، هر یک به یک خط زیر (_) تبدیل می‌شوند. .TP -sigalg \fIalgorithm\fR .br نام الگوریتم امضا برای استفاده در امضای فایل JAR را مشخص می‌کند. برای فهرستی از نام‌های استاندارد الگوریتم‌های امضا، بخش "Appendix A: Standard Names" را در راهنمای مرجع Java Cryptography Architecture (JCA) در نشانی زیر ببینید: این الگوریتم باید با کلید خصوصی استفاده‌شده برای امضای فایل JAR سازگار باشد. اگر این گزینه مشخص نشود، بسته به نوع کلید خصوصی از .BR SHA1withDSA ، .B SHA256withRSA یا .B SHA256withECDSA استفاده می‌شود. باید ارائه‌دهنده‌ای که به صورت ایستا نصب شده پیاده‌سازی الگوریتم را فراهم کند یا کاربر باید یکی را با گزینه .B \-providerClass مشخص کند؛ در غیر این صورت دستور با شکست مواجه می‌شود. .TP -digestalg \fIalgorithm\fR .br نام الگوریتم خلاصه پیام را برای استفاده هنگام خلاصه‌سازی مدخل‌های فایل JAR مشخص می‌کند. برای فهرستی از نام‌های استاندارد الگوریتم خلاصه پیام، بخش "Appendix A: Standard Names" را در راهنمای مرجع Java Cryptography Architecture (JCA) در نشانی زیر ببینید: اگر این گزینه مشخص نشود، از .B SHA256 استفاده می‌شود. باید ارائه‌دهنده‌ای که به صورت ایستا نصب شده پیاده‌سازی الگوریتم را فراهم کند یا کاربر باید یکی را با گزینه .B \-providerClass مشخص کند؛ در غیر این صورت دستور با موفقیت اجرا نمی‌شود. .TP -certs .br اگر گزینه .B \-certs همراه با گزینه‌های .B \-verify و .B \-verbose در خط فرمان مشخص شود، خروجی شامل اطلاعات گواهی برای هر امضاکننده فایل JAR خواهد بود. این اطلاعات شامل نام نوع گواهی (ذخیره‌شده در فایل .BR .DSA ) که کلید عمومی امضاکننده را تصدیق می‌کند و در صورتی که گواهی از نوع X.509 (نمونه‌ای از .BR java.security.cert.X509Certificate ) باشد، نام متمایز (distinguished name) امضاکننده است. مخزن کلید نیز بررسی می‌شود. اگر هیچ مقدار مخزن کلیدی در خط فرمان مشخص نشده باشد، فایل مخزن کلید پیش‌فرض (در صورت وجود) بررسی می‌شود. اگر گواهی کلید عمومی برای یک امضاکننده با مدخلی در مخزن کلید مطابقت داشته باشد، نام مستعار مدخل مخزن کلید برای آن امضاکننده در پرانتز نمایش داده می‌شود. .TP -certchain \fIfile\fR .br زنجیره گواهی مورد استفاده را زمانی مشخص می‌کند که زنجیره گواهی مرتبط با کلید خصوصی مدخل مخزن کلید کامل نباشد. این موضوع زمانی رخ می‌دهد که مخزن کلید روی یک توکن سخت‌افزاری با ظرفیت ناکافی برای نگهداری زنجیره کامل گواهی قرار داشته باشد. این فایل می‌تواند دنباله‌ای از گواهی‌های X.509 الحاق‌شده به هم یا یک بلوک داده با فرمت PKCS#7 به صورت باینری یا کدگذاری قابل چاپ (Base64) مطابق استاندارد اینترنتی RFC 1421 باشد. استاندارد کدگذاری گواهی RFC 1421 اینترنت و نشانی زیر را ببینید: .TP -verbose .br هنگامی که گزینه .B \-verbose در خط فرمان قرار گیرد، نشان‌دهنده حالت پرگویی است که باعث می‌شود .B jarsigner اطلاعات بیشتری در مورد روند پیشرفت امضا یا اعتبارسنجی JAR چاپ کند. .TP -internalsf .br در گذشته، فایل .B .DSA (بلوک امضا) تولیدشده هنگام امضای فایل JAR شامل یک کپی کامل کدگذاری‌شده از فایل .B .SF (فایل امضا) بود. این رفتار تغییر کرده است. برای کاهش اندازه کلی فایل JAR خروجی، فایل .B .DSA به طور پیش‌فرض دیگر حاوی کپی فایل .B .SF نیست. اگر .B \-internalsf در خط فرمان مشخص شود، رفتار قدیمی استفاده می‌شود. این گزینه برای آزمایش مفید است. در عمل، از گزینه .B \-internalsf استفاده نکنید زیرا بار اضافی بیشتری تحمیل می‌کند. .TP -sectionsonly .br اگر گزینه .B \-sectionsonly در خط فرمان مشخص شود، فایل .B .SF (فایل امضا) تولیدشده هنگام امضای فایل JAR شامل هدر حاوی هش کل فایل مانیفست نخواهد بود. این فایل فقط شامل اطلاعات و هش‌های مربوط به تک‌تک فایل‌های مبدا موجود در فایل JAR است. بخش فایل امضا را ببینید. به طور پیش‌فرض، این هدر به عنوان یک بهینه‌سازی اضافه می‌شود. هنگامی که هدر وجود دارد، در هر بار اعتبارسنجی فایل JAR، فرآیند می‌تواند ابتدا بررسی کند که آیا هش موجود در هدر با هش کل فایل مانیفست مطابقت دارد یا خیر. در صورت تطابق، اعتبارسنجی به مرحله بعد می‌رود. در صورت عدم تطابق، لازم است اعتبارسنجی کم‌بهینه‌تری انجام شود مبنی بر اینکه هش در بخش اطلاعات هر فایل مبدا در فایل .B .SF برابر با هش بخش متناظر آن در فایل مانیفست باشد. بخش اعتبارسنجی فایل JAR را ببینید. گزینه .B \-sectionsonly عمدتاً برای آزمایش استفاده می‌شود. نباید جز برای آزمایش استفاده شود زیرا استفاده از آن سربار بیشتری تحمیل می‌کند. .TP -protected .br مقادیر می‌توانند .B true یا .B false باشند. وقتی رمز عبور باید از طریق یک مسیر احراز هویت محافظت‌شده مانند یک دستگاه PINخوان اختصاصی وارد شود، مقدار .B true را مشخص کنید. .TP -providerClass \fIprovider-class-name\fR .br برای مشخص کردن نام فایل کلاس اصلی ارائه‌دهنده خدمات رمزنگاری زمانی که ارائه‌دهنده خدمات در فایل مشخصه‌های امنیتی .B java.security فهرست نشده است استفاده می‌شود. در صورت استفاده همراه با گزینه .BR "\-providerArg ConfigFilePath" ، ابزارهای .B keytool و .B jarsigner ارائه‌دهنده را به صورت پویا نصب کرده و از .I ConfigFilePath به عنوان مسیر فایل پیکربندی توکن استفاده می‌کنند. مثال زیر دستوری برای فهرست کردن یک مخزن کلید .B PKCS #11 را در حالتی نشان می‌دهد که ارائه‌دهنده Oracle PKCS #11 در فایل مشخصه‌های امنیتی پیکربندی نشده است: .sp .nf \f3jarsigner \-keystore NONE \-storetype PKCS11 \e\fP .fi .nf \f3 \-providerClass sun\&.security\&.pkcs11\&.SunPKCS11 \e\fP .fi .nf \f3 \-providerArg /mydir1/mydir2/token\&.config \e\fP .fi .nf \f3 \-list\fP .fi .nf \f3\fR .fi .sp .TP -providerName \fIproviderName\fR .br اگر بیش از یک ارائه‌دهنده در فایل مشخصه‌های امنیتی .B java.security پیکربندی شده باشد، می‌توانید از گزینه .B \-providerName برای هدف قرار دادن یک نمونه ارائه‌دهنده خاص استفاده کنید. آرگومان این گزینه نام ارائه‌دهنده است. برای ارائه‌دهنده Oracle PKCS #11، مقدار .I providerName به صورت .B SunPKCS11-TokenName است، که در آن .I TokenName پسوند نامی است که نمونه ارائه‌دهنده با آن پیکربندی شده است. به عنوان مثال، دستور زیر محتویات نمونه ارائه‌دهنده مخزن کلید .B PKCS #11 با پسوند نام .B SmartCard را فهرست می‌کند: .sp .nf \f3jarsigner \-keystore NONE \-storetype PKCS11 \e\fP .fi .nf \f3 \-providerName SunPKCS11\-SmartCard \e\fP .fi .nf \f3 \-list\fP .fi .nf \f3\fR .fi .sp .TP -J\fIjavaoption\fR .br رشته .I javaoption مشخص‌شده را مستقیماً به مفسر جاوا منتقل می‌کند. دستور .B jarsigner پوششی پیرامون مفسر جاوا است. این گزینه نباید شامل هیچ فاصله‌ای باشد. برای تنظیم محیط اجرا یا مصرف حافظه کاربرد دارد. برای مشاهده فهرستی از گزینه‌های مفسر، دستور .B java -h یا .B java -X را در خط فرمان اجرا کنید. .TP -tsa \fIurl\fR .br اگر گزینه .B \-tsa http://example.tsa.url هنگام امضای فایل JAR در خط فرمان مشخص شود، یک برچسب زمانی برای امضا تولید می‌شود. نشانی URL به آدرس .B http://example.tsa.url محل مرجع برچسب‌گذاری زمانی (TSA) را مشخص کرده و هرگونه URL یافت‌شده با گزینه .B \-tsacert را لغو می‌کند. گزینه .B \-tsa نیازی به وجود گواهی کلید عمومی TSA در مخزن کلید ندارد. برای تولید برچسب زمانی، .B jarsigner از طریق پروتکل برچسب زمانی (TSP) تعریف‌شده در RFC 3161 با TSA ارتباط برقرار می‌کند. در صورت موفقیت، توکن برچسب زمانی برگردانده‌شده از TSA همراه با امضا در فایل بلوک امضا ذخیره می‌شود. .TP -tsacert \fIalias\fR .br هنگامی که .B \-tsacert alias هنگام امضای فایل JAR در خط فرمان قرار گیرد، یک برچسب زمانی برای امضا تولید می‌شود. این نام مستعار گواهی کلید عمومی TSA را در مخزن کلید فعال مشخص می‌کند. گواهی این مدخل برای افزونه Subject Information Access که حاوی URL نشان‌دهنده محل TSA است بررسی می‌شود. هنگام استفاده از گزینه .BR \-tsacert ، گواهی کلید عمومی TSA باید در مخزن کلید موجود باشد. .TP -tsapolicyid \fIpolicyid\fR .br شناسه شیء (OID) را مشخص می‌کند که شناسه خط‌مشی ارسالی به سرور TSA را تعیین می‌کند. اگر این گزینه مشخص نشود، هیچ شناسه خط‌مشی ارسال نشده و سرور TSA یک خط‌مشی پیش‌فرض را انتخاب خواهد کرد. شناسه‌های شیء توسط استاندارد X.696 که استاندارد بخش استانداردسازی مخابرات ITU (ITU-T) است تعریف می‌شوند. این شناسه‌ها معمولاً مجموعه‌هایی از ارقام نامنفی جداشده با نقطه هستند، مانند .BR 1.2.3.4 . .TP -altsigner \fIclass\fR .br این گزینه یک مکانیزم امضای جایگزین را مشخص می‌کند. نام کلاس کاملاً واجد شرایط (fully qualified) فایل کلاسی را مشخص می‌کند که کلاس انتزاعی .B com.sun.jarsigner.ContentSigner را گسترش می‌دهد. مسیر این فایل کلاس توسط گزینه .B \-altsignerpath تعریف می‌شود. اگر از گزینه .B \-altsigner استفاده شود، دستور .B jarsigner از مکانیزم امضای ارائه‌شده توسط کلاس مشخص‌شده استفاده می‌کند. در غیر این صورت، دستور .B jarsigner از مکانیزم امضای پیش‌فرض خود استفاده خواهد کرد. برای مثال، برای استفاده از مکانیزم امضای ارائه‌شده توسط کلاسی به نام .BR com.sun.sun.jarsigner.AuthSigner ، از گزینه .B \-altsigner com.sun.jarsigner.AuthSigner استفاده کنید. .TP -altsignerpath \fIclasspathlist\fR .br مسیر فایل کلاس و هر فایل JAR وابسته به آن را مشخص می‌کند. نام فایل کلاس با گزینه .B \-altsigner مشخص می‌شود. اگر فایل کلاس در یک فایل JAR باشد، این گزینه مسیر آن فایل JAR را مشخص می‌کند. می‌توان یک مسیر مطلق یا یک مسیر نسبی به دایرکتوری جاری مشخص کرد. اگر .I classpathlist شامل چندین مسیر یا فایل JAR باشد، در Oracle Solaris باید با دو نقطه (:) و در ویندوز با نقطه ویرگول (;) از هم جدا شوند. هنگامی که کلاس از قبل در مسیر جستجو باشد نیازی به این گزینه نیست. مثال زیر نحوه تعیین مسیر به فایل JAR حاوی فایل کلاس را نشان می‌دهد. نام فایل JAR گنجانده شده است: .sp .nf \f3\-altsignerpath /home/user/lib/authsigner\&.jar\fP .fi .nf \f3\fR .fi .sp مثال زیر نحوه تعیین مسیر به فایل JAR حاوی فایل کلاس بدون ذکر نام فایل JAR را نشان می‌دهد: .sp .nf \f3\-altsignerpath /home/user/classes/com/sun/tools/jarsigner/\fP .fi .nf \f3\fR .fi .sp .TP -strict .br در طول فرآیند امضا یا اعتبارسنجی، دستور ممکن است پیام‌های هشدار صادر کند. اگر این گزینه را مشخص کنید، کد خروج ابزار پیام‌های هشدار شدیدی را که این دستور یافته منعکس می‌کند. بخش خطاها و هشدارها را ببینید. .TP -verbose \fIsuboptions\fR .br برای فرآیند اعتبارسنجی، گزینه .B \-verbose زیرگزینه‌هایی را برای تعیین میزان اطلاعات نمایشی می‌پذیرد. اگر گزینه .B \-certs نیز مشخص شده باشد، حالت پیش‌فرض (یا زیرگزینه .BR all ) هر مدخل را هنگام پردازش و پس از آن اطلاعات گواهی هر امضاکننده فایل JAR را نمایش می‌دهد. اگر گزینه‌های .B \-certs و زیرگزینه .B \-verbose:grouped مشخص شوند، مدخل‌های دارای اطلاعات امضاکننده یکسان گروه‌بندی شده و همراه با اطلاعات گواهی‌شان نمایش داده می‌شوند. اگر گزینه‌های .B \-certs و زیرگزینه .B \-verbose:summary مشخص شوند، مدخل‌های دارای اطلاعات امضاکننده یکسان گروه‌بندی شده و جزئیات هر مدخل خلاصه‌سازی شده و به صورت .I one entry (and more) نمایش داده می‌شوند. بخش مثال‌ها را ببینید. .SH "خطاها و هشدارها (ERRORS AND WARNINGS)" در طول فرآیند امضا یا اعتبارسنجی، دستور .B jarsigner ممکن است خطاها یا هشدارهای مختلفی صادر کند. .PP اگر شکستی رخ دهد، دستور .B jarsigner با کد ۱ خارج می‌شود. اگر شکستی رخ ندهد اما یک یا چند هشدار شدید وجود داشته باشد، دستور .B jarsigner در صورت عدم مشخص شدن گزینه .B \-strict با کد ۰ خارج می‌شود، یا در صورت مشخص شدن گزینه .B \-strict با مقدار OR بیتی کدهای هشدار خارج می‌شود. اگر فقط هشدارهای اطلاع‌رسانی وجود داشته باشد یا هیچ هشداری نباشد، دستور همیشه با کد ۰ خارج می‌شود. .PP برای مثال، اگر گواهی استفاده‌شده برای امضای یک مدخل منقضی شده باشد و دارای افزونه KeyUsage باشد که اجازه امضای فایل را به آن نمی‌دهد، دستور .B jarsigner در صورت مشخص شدن گزینه .B \-strict با کد ۱۲ (=۴+۸) خارج می‌شود. .PP \fIنکته:\fR کدهای خروج مجدداً استفاده می‌شوند زیرا در سیستم‌عامل‌های مبتنی بر یونیکس تنها مقادیر بین ۰ تا ۲۵۵ معتبر هستند. .PP بخش‌های زیر نام‌ها، کدها و توضیحات خطاها و هشدارهایی را که دستور .B jarsigner می‌تواند صادر کند شرح می‌دهند. .SS "شکست (FAILURE)" دلایلی که باعث شکست دستور .B jarsigner می‌شوند شامل (اما نه محدود به) خطای تجزیه خط فرمان، ناتوانی در یافتن جفت‌کلید برای امضای فایل JAR یا عدم موفقیت در اعتبارسنجی یک JAR امضاشده است. .TP failure کد ۱. امضا یا اعتبارسنجی با شکست مواجه شد. .SS "هشدارهای شدید (SEVERE WARNINGS)" \fIنکته:\fR اگر گزینه .B \-strict را مشخص کنید، هشدارهای شدید به عنوان خطا گزارش می‌شوند. .PP دلایلی که باعث صدور هشدار شدید توسط دستور .B jarsigner می‌شوند شامل خطا داشتن گواهی استفاده‌شده برای امضای فایل JAR یا وجود مشکلات دیگر در فایل JAR امضاشده است. .TP hasExpiredCert کد ۴. این JAR شامل مدخل‌هایی است که گواهی امضاکننده آنها منقضی شده است. .TP notYetValidCert کد ۴. این JAR شامل مدخل‌هایی است که گواهی امضاکننده آنها هنوز معتبر نشده است. .TP chainNotValidated کد ۴. این JAR شامل مدخل‌هایی است که زنجیره گواهی آنها را نمی‌توان به درستی اعتبارسنجی کرد. .TP badKeyUsage کد ۸. این JAR شامل مدخل‌هایی است که افزونه KeyUsage گواهی امضاکننده آنها اجازه امضای کد را نمی‌دهد. .TP badExtendedKeyUsage کد ۸. این JAR شامل مدخل‌هایی است که افزونه ExtendedKeyUsage گواهی امضاکننده آنها اجازه امضای کد را نمی‌دهد. .TP badNetscapeCertType کد ۸. این JAR شامل مدخل‌هایی است که افزونه NetscapeCertType گواهی امضاکننده آنها اجازه امضای کد را نمی‌دهد. .TP hasUnsignedEntry کد ۱۶. این JAR شامل مدخل‌های امضانشده‌ای است که یکپارچگی آنها بررسی نشده است. .TP notSignedByAlias کد ۳۲. این JAR شامل مدخل‌های امضاشده‌ای است که با نام(های) مستعار مشخص‌شده امضا نشده‌اند. .TP aliasNotInStore کد ۳۲. این JAR شامل مدخل‌های امضاشده‌ای است که با نام مستعار موجود در این مخزن کلید امضا نشده‌اند. .SS "هشدارهای اطلاع‌رسانی (INFORMATIONAL WARNINGS)" هشدارهای اطلاع‌رسانی شامل مواردی هستند که خطا محسوب نمی‌شوند اما به عنوان اقدام نامناسب (bad practice) تلقی می‌گردند. آنها فاقد کد خروج هستند. .TP hasExpiringCert این JAR شامل مدخل‌هایی است که گواهی امضاکننده آنها ظرف شش ماه آینده منقضی خواهد شد. .TP internalInconsistenciesDetected این JAR حاوی ناهماهنگی‌های داخلی است که در طول اعتبارسنجی شناسایی شده و ممکن است هنگام خواندن از طریق JarFile و JarInputStream به محتویات متفاوتی منجر شود. .TP noTimestamp این JAR شامل امضاهایی است که برچسب زمانی ندارند. بدون برچسب زمانی، کاربران ممکن است نتوانند این فایل JAR را پس از تاریخ انقضای گواهی امضاکننده (\f3YYYY-MM-DD\fR) یا پس از هرگونه تاریخ ابطال در آینده اعتبارسنجی کنند. .SH "مثال‌ها (EXAMPLES)" .SS "امضای یک فایل JAR (SIGN A JAR FILE)" از دستور زیر برای امضای bundle.jar با کلید خصوصی کاربری با نام مستعار .B jane در مخزن کلیدی به نام .B mystore در دایرکتوری .B working و نام‌گذاری فایل JAR امضاشده به عنوان .B sbundle.jar استفاده کنید: .sp .nf \f3jarsigner \-keystore /working/mystore\fP .fi .nf \f3 \-storepass \fP .fi .nf \f3 \-keypass \fP .fi .nf \f3 \-signedjar sbundle\&.jar bundle\&.jar jane\fP .fi .nf \f3\fR .fi .sp در دستور بالا هیچ گزینه .B \-sigfile مشخص نشده است، بنابراین فایل‌های .B .SF و .B .DSA تولیدشده برای قرار گرفتن در فایل JAR امضاشده دارای نام‌های پیش‌فرض بر اساس نام مستعار خواهند بود. آنها .B JANE.SF و .B JANE.DSA نامیده می‌شوند. .PP اگر می‌خواهید رمز عبور مخزن و رمز عبور کلید خصوصی از شما درخواست شود، می‌توانید دستور بالا را به صورت زیر کوتاه کنید: .sp .nf \f3jarsigner \-keystore /working/mystore\fP .fi .nf \f3 \-signedjar sbundle\&.jar bundle\&.jar jane\fP .fi .nf \f3\fR .fi .sp اگر مخزن کلید، مخزن کلید پیش‌فرض (فایل keystore. در دایرکتوری خانگی شما) باشد، نیازی به تعیین مخزن کلید ندارید: .sp .nf \f3jarsigner \-signedjar sbundle\&.jar bundle\&.jar jane\fP .fi .nf \f3\fR .fi .sp اگر می‌خواهید فایل JAR امضاشده روی فایل JAR ورودی (bundle.jar) بازنویسی شود، نیازی به تعیین گزینه .B \-signedjar ندارید: .sp .nf \f3jarsigner bundle\&.jar jane\fP .fi .nf \f3\fR .fi .sp .SS "اعتبارسنجی یک فایل JAR امضاشده (VERIFY A SIGNED JAR FILE)" برای اعتبارسنجی یک فایل JAR امضاشده جهت اطمینان از معتبر بودن امضا و دستکاری نشدن فایل JAR، از دستوری مشابه زیر استفاده کنید: .sp .nf \f3jarsigner \-verify sbundle\&.jar\fP .fi .nf \f3\fR .fi .sp هنگامی که اعتبارسنجی موفقیت‌آمیز باشد، پیام .B "jar verified" نمایش داده می‌شود. در غیر این صورت یک پیام خطا نمایش می‌یابد. با استفاده از گزینه .B \-verbose می‌توانید اطلاعات بیشتری دریافت کنید. یک نمونه استفاده از .B jarsigner همراه با گزینه .B \-verbose به شرح زیر است: .sp .nf \f3jarsigner \-verify \-verbose sbundle\&.jar\fP .fi .nf \f3\fR .fi .nf \f3 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fP .fi .nf \f3 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fP .fi .nf \f3 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fP .fi .nf \f3 smk 2752 Fri Sep 26 16:12:30 PDT 1997 AclEx\&.class\fP .fi .nf \f3 smk 849 Fri Sep 26 16:12:46 PDT 1997 test\&.class\fP .fi .nf \f3\fR .fi .nf \f3 s = signature was verified\fP .fi .nf \f3 m = entry is listed in manifest\fP .fi .nf \f3 k = at least one certificate was found in keystore\fP .fi .nf \f3\fR .fi .nf \f3 jar verified\&.\fP .fi .nf \f3\fR .fi .sp .SS "اعتبارسنجی همراه با اطلاعات گواهی (VERIFICATION WITH CERTIFICATE INFORMATION)" اگر گزینه .B \-certs را همراه با گزینه‌های .B \-verify و .B \-verbose مشخص کنید، خروجی شامل اطلاعات گواهی برای هر امضاکننده فایل JAR خواهد بود. اطلاعات شامل نوع گواهی، نام متمایز امضاکننده (زمانی که گواهی X.509 است) و در پرانتز، نام مستعار مخزن کلید برای امضاکننده در صورت تطابق گواهی کلید عمومی موجود در فایل JAR با یک مدخل مخزن کلید است؛ برای مثال: .sp .nf \f3jarsigner \-keystore /working/mystore \-verify \-verbose \-certs myTest\&.jar\fP .fi .nf \f3\fR .fi .nf \f3 198 Fri Sep 26 16:14:06 PDT 1997 META\-INF/MANIFEST\&.MF\fP .fi .nf \f3 199 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.SF\fP .fi .nf \f3 1013 Fri Sep 26 16:22:10 PDT 1997 META\-INF/JANE\&.DSA\fP .fi .nf \f3 208 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.SF\fP .fi .nf \f3 1087 Fri Sep 26 16:23:30 PDT 1997 META\-INF/JAVATEST\&.DSA\fP .fi .nf \f3 smk 2752 Fri Sep 26 16:12:30 PDT 1997 Tst\&.class\fP .fi .nf \f3\fR .fi .nf \f3 X\&.509, CN=Test Group, OU=Java Software, O=Oracle, L=CUP, S=CA, C=US (javatest)\fP .fi .nf \f3 X\&.509, CN=Jane Smith, OU=Java Software, O=Oracle, L=cup, S=ca, C=us (jane)\fP .fi .nf \f3\fR .fi .nf \f3 s = signature was verified\fP .fi .nf \f3 m = entry is listed in manifest\fP .fi .nf \f3 k = at least one certificate was found in keystore\fP .fi .nf \f3\fR .fi .nf \f3 jar verified\&.\fP .fi .nf \f3\fR .fi .sp اگر گواهی برای یک امضاکننده گواهی X.509 نباشد، هیچ اطلاعات نام متمایزی وجود نخواهد داشت. در این حالت، فقط نوع گواهی و نام مستعار نشان داده می‌شوند. به عنوان مثال، اگر گواهی از نوع PGP و نام مستعار .B bob باشد، مقدار زیر را دریافت خواهید کرد: .BR "PGP, (bob)" . .SH "همچنین ببینید (SEE ALSO)" .TP 0.2i \(bu .BR jar (1) .TP 0.2i \(bu .BR keytool (1) .TP 0.2i \(bu مسیر آموزشی: ویژگی‌های امنیتی در Java SE در نشانی: .RE .br 'pl 8.5i 'bp