ZEROTIER-IDTOOL(1) ZEROTIER-IDTOOL(1)

zerotier-idtool - ابزاری برای ایجاد و دستکاری شناسه‌های ZeroTier

zerotier-idtool <command> [args]

دستور zerotier-idtool یک ابزار خط فرمان برای کار با شناسه‌های ZeroTier است. یک شناسه ZeroTier شامل یک جفت کلید عمومی/خصوصی (یا تنها کلید عمومی در صورتی که فقط identity.public باشد) و یک نشانی ۱۰ رقمی هگزادسیمال ZeroTier است که از کلید عمومی از طریق یک تابع درهم‌ساز مبتنی بر اثبات کار مشتق می‌شود.

هنگامی که آرگومان‌های دستور نیازمند یک شناسه عمومی یا محرمانه (کامل) باشند، شناسه می‌تواند به‌صورت مسیر یک فایل یا مستقیماً در خط فرمان مشخص شود.

  • help: نمایش راهنما. (اجرای بدون دستور نیز این کار را انجام می‌دهد.)
  • generate [secret file] [public file] [vanity]: تولید یک شناسه جدید ZeroTier. اگر یک فایل محرمانه مشخص شود، شناسه کامل شامل کلید خصوصی درون این فایل نوشته خواهد شد. اگر فایل عمومی مشخص شود، بخش عمومی در آنجا نوشته می‌شود. اگر هیچ مسیر فایلی مشخص نشود، شناسه محرمانه کامل به STDOUT ارسال می‌شود. پیشوند سفارشی (vanity) رشته‌ای از ارقام هگزادسیمال است که نشانی شناسه تولیدشده باید با آن آغاز شود. معمولاً از این ویژگی استفاده نمی‌شود، و در صورت مشخص شدن آن، فرآیند تولید به دلیل هزینه ذاتی ایجاد شناسه‌ها با تابع اثبات کار ممکن است زمان بسیار زیادی ببرد. تولید یک شناسه با یک پیشوند مشخص ۱۶ بیتی (۴ رقم) روی یک پردازنده 2.8ghz Core i5 (با استفاده از یک هسته) به طور میانگین دو ساعت طول می‌کشد.
  • validate <identity, only public part required>: اعتبارسنجی محلی کلید شناسه و انطباق تابع اثبات کار آن.
  • getpublic <full identity with secret>: استخراج بخش عمومی از یک identity.secret و چاپ آن در STDOUT.
  • sign <full identity with secret> <file to sign>: امضای محتوای یک فایل با الگوریتم SHA512+ECC-256 (ed25519). امضا در قالب هگزادسیمال به STDOUT ارسال می‌شود.
  • verify <identity, only public part required> <file to check> <signature in hex>: اعتبارسنجی امضای ایجادشده با sign.
  • mkcom <full identity with secret> [id,value,maxdelta] [...]: ایجاد و امضای یک گواهی عضویت شبکه. این قابلیت معمولاً کاربرد عمومی ندارد زیرا کنترل‌کننده‌های شبکه این کار را به صورت خودکار انجام می‌دهند و بیشتر برای اهداف آزمایشی قرار داده شده است.

تولید و نمایش یک شناسه جدید:

$ zerotier-idtool generate

تولید و نوشتن یک شناسه جدید، شامل هر دو بخش محرمانه و عمومی:

$ zerotier-idtool generate identity.secret identity.public

تولید یک نشانی سفارشی که با ارقام هگزادسیمال "beef" آغاز می‌شود (این عملیات مدتی طول خواهد کشید!):

$ zerotier-idtool generate beef.secret beef.public beef

امضای یک فایل با کلید محرمانه یک شناسه:

$ zerotier-idtool sign identity.secret last_will_and_testament.txt

اعتبارسنجی امضای یک فایل با یک کلید عمومی:

$ zerotier-idtool verify identity.public last_will_and_testament.txt

(c)2011-2016 ZeroTier, Inc. -- https://www.zerotier.com -- https://github.com/zerotier

zerotier-one(8), zerotier-cli(1)

December 2016