glab(1) glab(1)

glab-auth-login - احراز هویت با یک نمونهٔ GitLab.

glab auth login [flags]

با یک نمونهٔ GitLab احراز هویت می‌کند.

به‌طور پیش‌فرض، زمانی که جاکلیدی (keyring) در دسترس باشد، glab اطلاعات احراز هویت شما را در دسته کلید سیستم‌عامل (macOS Keychain، Windows Credential Manager یا Secret Service در لینوکس) ذخیره می‌کند. اگر هیچ جاکلیدی در دسترس نباشد، یا اگر گزینهٔ --insecure-storage را ارسال کنید، glab آن‌ها را به‌صورت متن خام در فایل پیکربندی سراسری (پیش‌فرض ~/.config/glab-cli/config.yml) ذخیره می‌کند. پس از احراز هویت، تمام دستورات glab از اطلاعات احراز هویت ذخیره‌شده استفاده می‌کنند.

اگر پیش‌تر وارد شده‌اید و اطلاعات احراز هویت شما به‌صورت متن خام در فایل پیکربندی ذخیره شده است، دستور glab auth login را دوباره اجرا کنید تا آن‌ها را به جاکلیدی منتقل کند.

در CI (هنگامی که GITLAB_CI یا CI تنظیم شده باشد)، glab اطلاعات احراز هویت را به جای جاکلیدی در فایل پیکربندی ذخیره می‌کند. اطلاعات احراز هویت در CI معمولاً از طریق متغیرهای محیطی فراهم می‌شوند و جاکلیدی سیستم‌عامل معمولاً در آنجا در دسترس نیست.

اگر GITLAB_TOKEN، GITLAB_ACCESS_TOKEN یا OAUTH_TOKEN تنظیم شده باشند، نسبت به اطلاعات احراز هویت ذخیره‌شده اولویت دارند. هنگامی که ورود خودکار در CI فعال باشد، این متغیرها بر CI_JOB_TOKEN نیز ارجحیت دارند.

برای ارسال توکن از طریق ورودی استاندارد، از --stdin استفاده کنید.

در حالت تعاملی، glab نمونه‌های GitLab را از ریموت‌های Git شما تشخیص می‌دهد و آن‌ها را به‌عنوان گزینه فهرست می‌کند، تا نیازی به وارد کردن دستی نام میزبان نداشته باشید.

-a, --api-host="" نام میزبان برای اندپوینت API، در صورتی که با --hostname متفاوت باشد. یک نام میزبان یا hostname:port را می‌پذیرد. تنها زمانی استفاده کنید که API از میزبانی متفاوت نسبت به ریموت Git ارائه شود.

-p, --api-protocol="" پروتکل API. گزینه‌ها: https، http.

--container-registry-domains="" دامنه‌های مخزن کانتینر (container registry) و پروکسی وابستگی‌های ایمیج، جداشده با کاما.

--device[=false] استفاده از جریان احراز هویت دستگاه در OAuth 2.0. برای محیط‌های فاقد رابط گرافیکی (headless) که در آن‌ها مرورگر محلی در دسترس نیست مفید است. نیازمند GitLab نسخهٔ 17.9 یا بالاتر است.

-g, --git-protocol="" پروتکل Git. گزینه‌ها: ssh، https، http.

--hostname="" نام میزبان نمونهٔ GitLab برای احراز هویت.

--insecure-storage[=false] ذخیرهٔ توکن به‌صورت متن خام در فایل پیکربندی به‌جای جاکلیدی سیستم‌عامل.

-j, --job-token="" توکن وظیفهٔ CI.

--ssh-hostname="" نام میزبان SSH برای نمونه‌هایی با اندپوینت SSH متفاوت. نیازی به تعیین درگاه نیست؛ Git از درگاه مشخص‌شده در نشانی ریموت استفاده می‌کند.

--stdin[=false] خواندن توکن از ورودی استاندارد.

-t, --token="" توکن دسترسی GitLab شما.

--web[=false] صرف‌نظر کردن از اعلان نوع ورود و استفاده از ورود وب/OAuth.

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

# شروع راه‌اندازی تعاملی
# در صورت قرار داشتن در مخزن Git، دستور glab نمونه‌های GitLab را از ریموت‌ها تشخیص داده و پیشنهاد می‌دهد
glab auth login
# احراز هویت در `gitlab.com` با خواندن توکن از یک فایل
glab auth login --stdin < myaccesstoken.txt
# احراز هویت با GitLab Self-Managed یا GitLab Dedicated
glab auth login --hostname salsa.debian.org
# راه‌اندازی غیرتعاملی
glab auth login --hostname gitlab.example.org --token glpat-xxx --api-host gitlab.example.org:3443 --api-protocol https --git-protocol ssh
# راه‌اندازی غیرتعاملی با خواندن توکن از یک فایل
glab auth login --hostname gitlab.example.org --api-host gitlab.example.org:3443 --api-protocol https --git-protocol ssh --stdin < myaccesstoken.txt
# ورود نیمه‌تعاملی OAuth، با صرف‌نظر از تمامی اعلان‌ها به جز احراز هویت در مرورگر
glab auth login --hostname gitlab.com --web --git-protocol ssh --container-registry-domains "gitlab.com,gitlab.com:443,registry.gitlab.com"
# جریان احراز هویت دستگاه OAuth برای محیط‌های فاقد رابط گرافیکی بدون مرورگر محلی.
# دستور glab یک کد یک‌بارمصرف و نشانی تایید اعتبار را نمایش می‌دهد؛ شما در هر
# دستگاه دیگری با یک مرورگر تایید را انجام می‌دهید. نیازمند GitLab 17.9 یا جدیدتر.
glab auth login --hostname gitlab.com --device
# پیکربندی CI/CD: برای بیشتر موارد، ورود خودکار را به ورود دستی ترجیح دهید
GLAB_ENABLE_CI_AUTOLOGIN=true glab release list -R $CI_PROJECT_PATH
# پیکربندی CI/CD با ورود دستی: زمانی استفاده شود که دستور از توکن‌های وظیفه CI پشتیبانی نمی‌کند، یا به توکن دسترسی شخصی نیاز دارید
glab auth login --hostname $CI_SERVER_FQDN --job-token $CI_JOB_TOKEN --api-protocol $CI_SERVER_PROTOCOL

glab-auth(1)

Sep 2026 Auto generated by spf13/cobra