aggrega auth
aggrega auth는 서명 ID, 즉 키리스 서명에 사용되는 OIDC ID 토큰을 다루는 명령을 묶습니다. 이는 레지스트리 사용자 이름/비밀번호 자격 증명을 저장하는 aggrega login과 구별됩니다. auth는 서명할 때 누구인지에 관한 것이고, login은 레지스트리에 어떻게 접근하는지에 관한 것입니다.
aggrega auth token
aggrega auth token은 대화형 OIDC 흐름을 한 번 실행하고 원시 ID 토큰을 stdout에 출력합니다. 따라서 ID를 한 번만 획득하여, 아티팩트마다 브라우저를 거치지 않고 여러 키리스 서명 작업에 재사용할 수 있습니다.
개요
aggrega auth token동작
aggrega auth token은 브라우저를 열어 페더레이션 OIDC 로그인을 완료한 다음(토큰이 제공되지 않았을 때 aggrega sign과 aggrega push가 사용하는 것과 같은 획득 방식입니다), 결과로 얻은 ID 토큰을 stdout에 쓰고 종료합니다. 이 토큰은 키리스 서명이 인증서 발급을 위해 Fulcio에 제시하는 값입니다.
stdout에는 토큰과 그 뒤의 줄바꿈 하나만 쓰입니다. 프롬프트나 진단 메시지는 모두 stderr로 가므로, 명령 치환으로 토큰만 캡처할 수 있습니다.
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)토큰을 export하면 이후의 각 키리스 aggrega sign(또는 aggrega push --sign)이 추가 브라우저 상호작용 없이 이를 재사용합니다.
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이는 대화형 일괄 서명에 대응하는 스크립트 방식입니다. aggrega sign <ref1> <ref2> ...는 일괄 작업을 위해 프로세스 안에서 ID를 한 번 획득하고, aggrega auth token은 별도의 호출에 걸쳐 사용할 수 있도록 ID를 내보냅니다.
보안
ID 토큰은 수명이 짧으며 이 명령은 토큰을 저장하지 않습니다. 토큰을 stdout에 출력하는 것은 사용자의 터미널과 export를 위한 명시적인 선택입니다. 토큰은 사용자가 둔 곳(일반적으로 세션 동안 유지되는 셸 환경 변수)에만 존재합니다. 긴 일괄 작업이 끝나기 전에 토큰이 만료되면 aggrega auth token을 다시 실행하여 새 토큰을 발급받으십시오.
참고 항목
- ./aggrega-sign.md — 하나 이상의 아티팩트에 서명합니다. 일괄 서명은 ID를 한 번만 획득합니다.
- ./aggrega-push.md — 게시하며, 선택적으로 push 시점에 서명합니다.
- environment-variables.md —
AGGREGA_IDENTITY_TOKEN및 기타 서명 입력.
개요
aggrega auth설명
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.하위 명령
| 명령 | 설명 |
|---|---|
aggrega auth token | 대화형으로 OIDC ID 토큰을 획득하여 stdout에 출력합니다 |
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.