Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

aggrega auth

aggrega auth grupuje polecenia dotyczące tożsamości podpisującej — tokenu tożsamości OIDC używanego przy podpisywaniu bezkluczowym. Różni się od aggrega login, które przechowuje poświadczenia rejestru (nazwę użytkownika i hasło): auth dotyczy tego, kim się jest przy podpisywaniu, a login — tego, jak uzyskać dostęp do rejestru.

aggrega auth token

aggrega auth token jednorazowo uruchamia interaktywny przepływ OIDC i wypisuje surowy token tożsamości na stdout, dzięki czemu można uzyskać tożsamość jeden raz i używać jej ponownie w serii podpisów bezkluczowych bez przechodzenia przez przeglądarkę dla każdego artefaktu.

Składnia

aggrega auth token

Działanie

aggrega auth token otwiera przeglądarkę w celu dokończenia federacyjnego logowania OIDC (tego samego pozyskiwania, którego używają aggrega sign i aggrega push, gdy nie podano tokenu), a następnie zapisuje uzyskany token tożsamości na stdout i kończy działanie. Token jest wartością, którą podpisywanie bezkluczowe przedstawia usłudze Fulcio w celu wystawienia certyfikatu.

Na stdout zapisywany jest wyłącznie token, po którym następuje pojedynczy znak nowego wiersza. Wszelkie monity i komunikaty diagnostyczne trafiają na stderr, więc podstawienie polecenia przechwytuje sam token:

export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)

Po wyeksportowaniu tokenu każde kolejne bezkluczowe aggrega sign (lub aggrega push --sign) używa go ponownie bez dalszej interakcji z przeglądarką:

export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)
aggrega sign hub.example.com/component/core/api-server:1.0.0
aggrega sign hub.example.com/component/core/worker:1.0.0

Jest to skryptowy odpowiednik interaktywnego podpisywania seryjnego: aggrega sign <ref1> <ref2> ... uzyskuje tożsamość raz, wewnątrz procesu, dla całej serii, natomiast aggrega auth token eksportuje ją do użycia w osobnych wywołaniach.

Bezpieczeństwo

Token tożsamości jest krótkotrwały i to polecenie go nie utrwala — wypisanie go na stdout jest świadomym wyborem użytkownika, na potrzeby jego terminala i eksportu. Token istnieje tylko tam, gdzie zostanie umieszczony (zwykle w zmiennej środowiskowej powłoki na czas sesji). Jeśli token wygaśnie przed zakończeniem długiej serii, należy ponownie uruchomić aggrega auth token, aby wygenerować nowy.

Zobacz także

  • ./aggrega-sign.md — podpisywanie jednego lub wielu artefaktów; podpisywanie seryjne uzyskuje tożsamość raz.
  • ./aggrega-push.md — publikowanie, opcjonalnie z podpisywaniem podczas wypychania.
  • environment-variables.md — AGGREGA_IDENTITY_TOKEN i pozostałe dane wejściowe podpisywania.

Składnia

aggrega auth

Opis

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.

Podpolecenia

PolecenieOpis
aggrega auth tokenInteraktywnie uzyskuje token tożsamości OIDC i wypisuje go na stdout

Opis 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.