نام (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 <start> [<end>]: تمام نمونه‌های 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 [<poolname> [<address>]]: وضعیت تمام یا استخر انتخاب‌شده نشانی‌های 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<strongSwan userland version>/K<kernel version> برمی‌گرداند.
--versioncode: شماره نسخه را در قالب U<strongSwan userland version>/K<kernel version> برمی‌گرداند.
--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 http://www.strongswan.org به‌روزرسانی و گسترش یافت.