نام (NAME)

glab-token-rotate - چرخش توکن‌های دسترسی کاربر، گروه یا پروژه

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

glab token rotate [flags]

توضیحات (DESCRIPTION)

چرخش یک توکن، توکن موجود را باطل کرده و یک توکن جدید با مقدار محرمانه و تاریخ انقضای تازه ایجاد می‌کند. توکن قدیمی بلافاصله از کار می‌افتد، بنابراین باید هر کلاینتی را که از آن استفاده می‌کند با مقدار جدیدی که این دستور برمی‌گرداند به‌روزرسانی کنید.

اگر چندین توکن نام یکسانی دارند، شناسهٔ (ID) توکن را برای انتخاب مورد صحیح مشخص کنید.

توکن در ساعت 00:00 UTC تاریخی که از افزودن مدت‌زمان به تاریخ امروز محاسبه می‌شود، منقضی خواهد شد. مدت‌زمان پیش‌فرض ۳۰ روز است. می‌توانید مدت‌زمان متفاوتی را بر حسب روز (d)، هفته (w) یا ساعت (h) مشخص کنید. فلگ‌های --duration و --expires-at مانعةالجمع هستند.

مدیران سیستم می‌توانند توکن‌های دسترسی شخصی متعلق به سایر کاربران را بچرخانند.

گزینه‌ها (OPTIONS)

-D, --duration=30d تنظیم طول عمر توکن بر حسب روز. مقادیر پذیرفته‌شده: روز (30d)، هفته (4w) یا ساعت در مضارب ۲۴ (24h، 168h، 720h). حداکثر: 365d. توکن در ساعت 00:00 UTC تاریخ محاسبه‌شده منقضی می‌شود.

-E, --expires-at=0001-01-01 تنظیم تاریخ و زمان انقضای توکن در قالب YYYY-MM-DD. در صورت عدم تعیین، از --duration استفاده می‌شود.

-g, --group="" چرخش توکن دسترسی گروه. در صورت تنظیم آرگومان کاربر یا مخزن، نادیده گرفته می‌شود.

--jq="" فیلتر کردن خروجی JSON با یک عبارت jq.

-F, --output="text" قالب‌بندی خروجی به‌صورت: text، json. مقدار 'text' مقدار جدید توکن را ارائه می‌دهد؛ 'json' توکن را به همراه فراداده خروجی می‌دهد.

-R, --repo="" انتخاب یک مخزن دیگر. می‌توانید از OWNER/REPO یا GROUP/NAMESPACE/REPO استفاده کنید. نشانی کامل URL یا آدرس Git نیز پذیرفته می‌شود.

-U, --user="" چرخش توکن دسترسی شخصی. برای کاربر فعلی، از @me استفاده کنید.

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-h, --help[=false] نمایش راهنما برای این دستور.

مثال‌ها (EXAMPLES)

# چرخش توکن دسترسی پروژه برای پروژه فعلی (پیش‌فرض ۳۰ روز)
glab token rotate my-project-token
# چرخش توکن دسترسی پروژه با تاریخ انقضای صریح
glab token rotate --repo user/repo my-project-token --expires-at 2025-08-08
# چرخش توکن دسترسی گروه با طول عمر ۷ روز
glab token rotate --group group/sub-group my-group-token --duration 7d
# چرخش توکن دسترسی شخصی با طول عمر ۲ هفته
glab token rotate --user @me my-personal-token --duration 2w
# چرخش توکن دسترسی شخصی کاربری دیگر (فقط مدیر سیستم)
glab token rotate --user johndoe johns-personal-token --duration 90d

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

glab-token(1)