aggrega auth
aggrega auth nhóm các lệnh làm việc với danh tính ký — token danh tính OIDC được dùng trong ký không khóa. Nó khác với aggrega login, lệnh lưu thông tin xác thực tên người dùng/mật khẩu của registry: auth liên quan đến việc bạn là ai khi ký, còn login liên quan đến cách bạn truy cập một registry.
aggrega auth token
aggrega auth token chạy luồng OIDC tương tác một lần và in token danh tính thô ra stdout, nhờ đó bạn có thể lấy danh tính một lần duy nhất và dùng lại nó cho cả một loạt thao tác ký không khóa mà không cần mở trình duyệt cho mỗi artifact.
Cú pháp
aggrega auth tokenChức năng
aggrega auth token mở trình duyệt để hoàn tất đăng nhập OIDC liên kết (cùng cách lấy danh tính mà aggrega sign và aggrega push dùng khi không có token nào được cung cấp), sau đó ghi token danh tính thu được ra stdout rồi thoát. Token này là giá trị mà ký không khóa trình cho Fulcio để cấp chứng chỉ.
Chỉ token — theo sau là một ký tự xuống dòng duy nhất — được ghi ra stdout. Mọi lời nhắc hay thông báo chẩn đoán đều đi ra stderr, nên phép thay thế lệnh chỉ thu được token:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)Khi token đã được export, mỗi lần aggrega sign không khóa tiếp theo (hoặc aggrega push --sign) sẽ dùng lại nó mà không cần tương tác thêm với trình duyệt:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)aggrega sign hub.example.com/component/core/api-server:1.0.0aggrega sign hub.example.com/component/core/worker:1.0.0Đây là phiên bản dùng trong script tương ứng với ký hàng loạt tương tác: aggrega sign <ref1> <ref2> ... lấy danh tính một lần trong cùng tiến trình cho cả loạt, còn aggrega auth token export nó để dùng qua nhiều lần gọi riêng biệt.
Bảo mật
Token danh tính có thời hạn ngắn và không được lưu trữ bởi lệnh này — việc in nó ra stdout là lựa chọn chủ động của bạn, cho terminal của bạn và lần export của bạn. Nó chỉ tồn tại ở nơi bạn đặt nó (thường là một biến môi trường của shell trong suốt phiên làm việc). Nếu token hết hạn trước khi một loạt dài hoàn tất, hãy chạy lại aggrega auth token để tạo token mới.
Xem thêm
- ./aggrega-sign.md — ký một hoặc nhiều artifact; ký hàng loạt chỉ lấy danh tính một lần.
- ./aggrega-push.md — xuất bản, có thể ký ngay khi push.
- environment-variables.md —
AGGREGA_IDENTITY_TOKENvà các đầu vào ký khác.
Cú pháp
aggrega authMô tả
Commands for the keyless signing identity (an OIDC identity token), distinct from `aggrega login`, which stores registry username/password credentials. The identity token is a short-lived secret used by keyless signing; it is never persisted by these commands.Lệnh con
| Lệnh | Mô tả |
|---|---|
aggrega auth token | Lấy token danh tính OIDC theo cách tương tác và in nó ra stdout |
Mô tả aggrega auth token
Run the interactive OIDC flow once and print the raw identity token to stdout, so it can populate the environment for a batch of keyless signs:
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)
Only the token is written to stdout; any prompt or diagnostic goes to stderr, so command substitution captures the token alone. The token is short-lived and is not persisted by this command — the caller decides whether to export it. This is distinct from `aggrega login`, which stores registry credentials.