IPSEC(8) strongSwan IPSEC(8) نام (NAME) ipsec - فراخوانی ابزارهای IPsec خلاصه دستور (SYNOPSIS) ipsec command [arguments] [options] توضیحات (DESCRIPTION) ابزار ipsec هر یک از چندین ابزار مورد استفاده در کنترل و پایش سامانه رمزنگاری/احراز هویت IPsec را فراخوانی می‌کند، و command مشخص‌شده را با arguments و options تعیین‌شده به‌گونه‌ای اجرا می‌کند که گویی مستقیماً فراخوانی شده است. این کار تا حد زیادی تداخل نام‌های احتمالی با سایر نرم‌افزارها را از بین برده و همچنین امکان ارائه برخی خدمات متمرکز را فراهم می‌سازد. تمام دستورات شرح‌داده‌شده در این صفحه راهنما داخلی هستند و برای کنترل و پایش اتصالات IPsec و همچنین دیمن IKE به کار می‌روند. برای سایر دستورات، ipsec متغیر محیطی PATH مناسب را برای command فراخوانی‌شده مهیا می‌سازد و همچنین متغیرهای محیطی فهرست‌شده در بخش ENVIRONMENT را فراهم می‌کند. دستورات کنترلی (CONTROL COMMANDS) start [starter options] ابزار starter را فراخوانی می‌کند که به نوبه خود فایل ipsec.conf را پردازش کرده و دیمن IKE یعنی charon را اجرا می‌کند. update یک سیگنال HUP به starter ارسال می‌کند که هرگونه تغییر در ipsec.conf را تشخیص داده و پیکربندی را در دیمن در حال اجرای IKE یعنی charon به‌روزرسانی می‌کند. reload یک سیگنال USR1 به starter ارسال می‌کند که تمام پیکربندی دیمن در حال اجرای IKE یعنی charon را بر اساس فایل واقعی ipsec.conf مجدداً بارگذاری می‌کند. restart معادل stop و به دنبال آن start پس از ۲ ثانیه وقفه محافظتی است. stop تمام اتصالات IPsec را پایان داده و با ارسال سیگنال TERM به starter، دیمن IKE با نام charon را متوقف می‌کند. up name به دیمن IKE دستور می‌دهد تا اتصال name را برقرار و راه‌اندازی کند. down name به دیمن IKE دستور می‌دهد تا اتصال name را قطع کند. down name{n} نمونه n از IKEv1 Quick Mode و IKEv2 CHILD SA مربوط به اتصال name را قطع می‌کند. down name{*} تمام نمونه‌های IKEv1 Quick Mode و IKEv2 CHILD SA مربوط به اتصال name را قطع می‌کند. down name[n] نمونه n از IKE SA مربوط به اتصال name را قطع می‌کند. down name[*] تمام نمونه‌های IKE SA مربوط به اتصال name را قطع می‌کند. down-srcip [] تمام نمونه‌های IKE SA مربوط به کلاینت‌هایی که دارای IP مجازی در محدوده start-end هستند را قطع می‌کند. route name به دیمن IKE دستور می‌دهد تا یک سیاست IPsec در هسته برای اتصال name درج کند. نخستین بسته بار داده (payload) منطبق بر این سیاست IPsec به‌طور خودکار راه‌اندازی اتصال IKE را آغاز می‌کند. unroute name سیاست IPsec را در هسته برای اتصال name حذف می‌کند. status [name] اطلاعات مختصر وضعیت را برای اتصال name یا در صورت ذکر نشدن آرگومان، برای تمام اتصالات برمی‌گرداند. statusall [name] اطلاعات دقیق و مشروح وضعیت را برای اتصال name یا در صورت ذکر نشدن آرگومان، برای تمام اتصالات برمی‌گرداند. دستورات فهرست‌گیری (LIST COMMANDS) leases [ [
]] وضعیت تمام یا استخر انتخاب‌شده نشانی‌های IP (یا حتی یک نشانی IP مجازی واحد) را برمی‌گرداند. listalgs فهرستی از الگوریتم‌های رمزنگاری پشتیبانی‌شده و قابل استفاده برای IKE به همراه پلاگین متناظر آن‌ها را برمی‌گرداند. listpubkeys [--utc] فهرستی از کلیدهای عمومی RSA را که به‌صورت فرمت کلید خام بارگذاری شده یا از گواهی‌های X.509 یا OpenPGP استخراج شده‌اند، برمی‌گرداند. listcerts [--utc] فهرستی از گواهی‌های X.509 یا OpenPGP را که به‌صورت محلی توسط دیمن IKE بارگذاری شده یا از طریق پروتکل IKE دریافت شده‌اند، برمی‌گرداند. listcacerts [--utc] فهرستی از گواهی‌های مرجع صدور گواهی (CA) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه /etc/ipsec.d/cacerts/ بارگذاری شده یا از طریق پروتکل IKE دریافت شده‌اند، برمی‌گرداند. listaacerts [--utc] فهرستی از گواهی‌های مرجع احراز اختیار (AA) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه /etc/ipsec.d/aacerts/ بارگذاری شده‌اند، برمی‌گرداند. listocspcerts [--utc] فهرستی از گواهی‌های امضاکننده OCSP نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه /etc/ipsec.d/ocspcerts/ بارگذاری شده یا توسط یک سرور OCSP ارسال شده‌اند، برمی‌گرداند. listacerts [--utc] فهرستی از گواهی‌های صفت (Attribute) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه /etc/ipsec.d/acerts/ بارگذاری شده‌اند، برمی‌گرداند. listgroups [--utc] فهرستی از گروه‌هایی را که برای تعریف نمایه‌های مجوز کاربر استفاده می‌شوند، برمی‌گرداند. listcainfos [--utc] اطلاعات مرجع صدور گواهی (نقاط توزیع CRL، شناسه‌های OCSP URI، سرورهای LDAP) را که توسط بخش‌های ca در ipsec.conf تعریف شده‌اند، برمی‌گرداند. listcrls [--utc] فهرستی از فهرست‌های ابطال گواهی (CRL) را که توسط دیمن IKE از پوشه /etc/ipsec.d/crls بارگذاری شده یا از یک نقطه توزیع CRL مبتنی بر HTTP یا LDAP واکشی شده‌اند، برمی‌گرداند. listocsp [--utc] اطلاعات ابطال واکشی‌شده از سرورهای OCSP را برمی‌گرداند. listplugins فهرستی از تمام قابلیت‌های پلاگین‌های بارگذاری‌شده را برمی‌گرداند. listcounters [name] فهرستی از مقادیر شمارنده‌های IKE سراسری یا مختص به یک اتصال خاص را که از زمان راه‌اندازی دیمن جمع‌آوری شده‌اند، برمی‌گرداند. listall [--utc] تمام اطلاعات تولیدشده توسط دستورات فهرست‌گیری بالا را برمی‌گرداند. هر یک از دستورات فهرست‌گیری را می‌توان با گزینه --utc فراخوانی کرد که تمام تاریخ‌ها را به جای زمان محلی بر حسب UTC نمایش می‌دهد. دستورات بازخوانی مجدد (REREAD COMMANDS) rereadsecrets تمام اطلاعات و کلیدهای محرمانه تعریف‌شده در ipsec.secrets را پاکسازی کرده و دوباره می‌خواند. rereadcacerts گواهی‌های CA بارگذاری‌شده قبلی را حذف می‌کند، تمام فایل‌های گواهی موجود در پوشه /etc/ipsec.d/cacerts را می‌خواند و آن‌ها را به فهرست گواهی‌های مرجع صدور گواهی (CA) اضافه می‌کند. این دستور بر گواهی‌هایی که صریحاً در بخش ca در ipsec.conf(5) تعریف شده‌اند تاثیری نمی‌گذارد؛ این گواهی‌ها را می‌توان به‌طور جداگانه با دستور update به‌روزرسانی کرد. rereadaacerts گواهی‌های AA بارگذاری‌شده قبلی را حذف می‌کند، تمام فایل‌های گواهی موجود در پوشه /etc/ipsec.d/aacerts را می‌خواند و آن‌ها را به فهرست گواهی‌های مرجع احراز اختیار (AA) اضافه می‌کند. rereadocspcerts تمام فایل‌های گواهی موجود در پوشه /etc/ipsec.d/ocspcerts/ را می‌خواند و آن‌ها را به فهرست گواهی‌های امضاکننده OCSP اضافه می‌کند. rereadacerts تمام فایل‌های گواهی موجود در پوشه /etc/ipsec.d/acerts/ را می‌خواند و آن‌ها را به فهرست گواهی‌های صفت اضافه می‌کند. rereadcrls تمام فهرست‌های ابطال گواهی (CRL) موجود در پوشه /etc/ipsec.d/crls/ را می‌خواند و آن‌ها را به فهرست CRLها اضافه می‌کند. rereadall تمام دستورات بازخوانی فهرست‌شده در بالا را اجرا می‌کند. دستورات بازنشانی (RESET COMMANDS) resetcounters [name] شمارنده‌های سراسری یا مختص به یک اتصال خاص را بازنشانی می‌کند. دستورات پاکسازی (PURGE COMMANDS) purgecerts تمام گواهی‌های کش‌شده را پاکسازی می‌کند. purgecrls تمام CRLهای کش‌شده را پاکسازی می‌کند. purgeike نمونه‌های IKE SA را که فاقد Quick Mode یا CHILD SA هستند پاکسازی می‌کند. purgeocsp تمام رکوردهای اطلاعاتی کش‌شده OCSP را پاکسازی می‌کند. دستورات اطلاعاتی (INFO COMMANDS) --help اطلاعات نحوه استفاده از دستور ipsec را برمی‌گرداند. --version نسخه را در قالب strongSwan U/K برمی‌گرداند. --versioncode شماره نسخه را در قالب U/K برمی‌گرداند. --copyright اطلاعات حق نشر را برمی‌گرداند. --directory مسیر پوشه LIBEXECDIR را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند. --confdir مسیر پوشه SYSCONFDIR را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند. --piddir مسیر پوشه PIDDIR را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند. فایل‌ها (FILES) /usr/libexec/ipsec پوشه ابزارها محیط (ENVIRONMENT) هنگام فراخوانی سایر دستورات، دستور ipsec متغیرهای محیطی زیر را فراهم می‌کند: IPSEC_DIR پوشه حاوی برنامه‌ها و ابزارهای ipsec IPSEC_BINDIR پوشه حاوی دستور pki IPSEC_SBINDIR پوشه حاوی دستور ipsec IPSEC_CONFDIR پوشه حاوی فایل‌های پیکربندی IPSEC_PIDDIR پوشه حاوی فایل‌های PID/سوکت IPSEC_SCRIPT نام اسکریپت ipsec IPSEC_NAME نام توزیع ipsec IPSEC_VERSION شماره نسخه فضای کاربر و هسته ipsec IPSEC_STARTER_PID فایل PID برای شروع‌کننده ipsec IPSEC_CHARON_PID فایل PID برای دیمن کلیدگذاری IKE همچنین ببینید (SEE ALSO) ipsec.conf(5), ipsec.secrets(5) تاریخچه (HISTORY) در ابتدا توسط Henry Spencer برای پروژه FreeS/WAN نوشته شد. توسط Tobias Brunner و Andreas Steffen برای پروژه strongSwan به‌روزرسانی و گسترش یافت. 6.0.4rc1 2013-10-29 IPSEC(8)