Ubuntu Manpage: ssh-add — adaugă identități cu cheie privată la agentul de autentificare OpenSSH

NUME

       ssh-add — adaugă identități cu cheie privată la agentul de autentificare OpenSSH

SINOPSIS

       ssh-add  [-CcDdKkLlqvXx]  [-E  hash-fingerprint]  [-H  fișier-cheie-gazdă] [-h restricție-destinație] [-S
       furnizor] [-t durata-de-viață] [file ...] ssh-add -s pkcs11 [-Cv]  [certificat  ...]  ssh-add  -e  pkcs11
       ssh-add -T cheie-publică ...

DESCRIERE

ssh-add adaugă identități de chei private la agentul de autentificare, ssh-agent(1). Atunci când este
executat fără argumente, adaugă fișierele ~/.ssh/id_rsa, ~/.ssh/id_ecdsa, ~/.ssh/id_ecdsa_sk,
~/.ssh/id_ed25519 și ~/.ssh/id_ed25519_sk. După încărcarea unei chei private, ssh-add va încerca să
încarce informațiile corespunzătoare despre certificat din numele de fișier obținut prin adăugarea
-cert.pub la numele fișierului de chei private. În linia de comandă se pot indica nume de fișiere
alternative.

În cazul în care un fișier necesită o frază de acces, ssh-add solicită utilizatorului fraza de acces.
Fraza de acces este citită de pe tty-ul utilizatorului. ssh-add încearcă din nou să folosească ultima
frază de acces în cazul în care sunt furnizate mai multe fișiere de identitate.

Agentul de autentificare trebuie să ruleze, iar variabila de mediu SSH_AUTH_SOCK trebuie să conțină
numele soclului acestuia pentru ca ssh-add să funcționeze.

Opțiunile sunt următoarele:

-C La încărcarea cheilor în agent sau la ștergerea cheilor din agent, se procesează numai
certificatele și se omit cheile simple.

-c Indică faptul că identitățile adăugate trebuie să facă obiectul unei confirmări înainte de a fi
utilizate pentru autentificare. Confirmarea este efectuată de ssh-askpass(1). Confirmarea
reușită este semnalată de o stare de ieșire zero de la ssh-askpass(1), mai degrabă decât de
textul introdus în solicitant.

-D Șterge toate identitățile din agent.

-d În loc să adauge identități, elimină identități din agent. Dacă ssh-add a fost executat fără
argumente, cheile pentru identitățile implicite și certificatele corespunzătoare vor fi
eliminate. În caz contrar, lista de argumente va fi interpretată ca o listă de rute către fișiere
de chei publice pentru a specifica cheile și certificatele care urmează să fie eliminate din
agent. În cazul în care nu se găsește nicio cheie publică într-o anumită rută, ssh-add va adăuga
.pub și va încerca din nou. În cazul în care lista de argumente constă în “-”, atunci ssh-add va
citi cheile publice care urmează să fie eliminate de la intrarea standard.

-E hash-fingerprint
Specifică algoritmul sumei de control utilizat la afișarea amprentelor cheilor. Opțiunile valide
sunt: “md5” și “sha256”. Opțiunea implicită este “sha256”.

-e pkcs11
Elimină cheile furnizate de biblioteca partajată PKCS#11 pkcs11.

-H fișier-cheie-gazdă
Specifică un fișier de gazde cunoscut pentru a căuta chei de gazdă atunci când se utilizează chei
cu restricții de destinație prin intermediul indicatorului -h. Această opțiune poate fi
specificată de mai multe ori pentru a permite căutarea în mai multe fișiere. Dacă nu se specifică
niciun fișier, ssh-add va utiliza fișierele gazdă cunoscute ssh_config(5) implicite:
~/.ssh/known_hosts, ~/.ssh/known_hosts2, /etc/ssh/ssh_known_hosts și /etc/ssh/ssh_known_hosts2.

-h restricție-destinație
Când se adaugă chei, le restricționează pentru a putea fi utilizate numai de către anumite gazde
sau pentru anumite destinații.

Restricțiile de destinație de forma ‘[utilizator@]nume-gazdă-destinație’ permit utilizarea cheii
numai de la gazda de origine (cea care rulează ssh-agent(1)) către gazda de destinație listată,
cu numele de utilizator opțional.

Restricțiile de forma ‘nume-gazdă-sursă>[utilizator@]nume-gazdă-destinație’ permit ca o cheie
disponibilă pe un ssh-agent(1) transmis să fie utilizată printr-o anumită gazdă (specificată de
‘nume-gazdă-sursă’) pentru a se autentifica la o altă gazdă, specificată de
‘nume-gazdă-destinație’.

La încărcarea cheilor pot fi adăugate mai multe restricții de destinație. Atunci când se încearcă
autentificarea cu o cheie care are restricții de destinație, întreaga rută de conectare, inclusiv
redirecționarea ssh-agent(1), este testată în funcție de aceste restricții și fiecare salt
trebuie să fie permis pentru ca încercarea să reușească. De exemplu, dacă cheia este
redirecționată către o gazdă la distanță, ‘gazda-b’, și se încearcă autentificarea la o altă
gazdă, ‘gazda-c’, atunci operația va avea succes numai dacă ‘gazda-b’ a fost permisă de la gazda
de origine și dacă saltul următor ‘gazda-b>gazda-c’ este, de asemenea, permis de restricțiile de
destinație.

Gazdele sunt identificate prin cheile lor de gazdă și sunt căutate în fișierele de gazde
cunoscute de către . Se pot utiliza modele de caractere joker pentru numele de gazdă și sunt
acceptate cheile de gazdă cu certificat. În mod implicit, cheile adăugate de ssh-add nu sunt
restricționate în funcție de destinație.

Restricțiile de destinație au fost adăugate în versiunea OpenSSH 8.9. Este necesar să se ofere
suport atât pentru clientul SSH la distanță, cât și pentru serverul SSH atunci când se utilizează
chei cu restricții de destinație pe un canal ssh-agent(1) transmis.

De asemenea, este important de reținut că restricțiile de destinație pot fi aplicate de către
ssh-agent(1) numai atunci când se utilizează o cheie sau când aceasta este transmisă de către un
cooperant ssh(1). Mai exact, nu împiedică un atacator care are acces la un SSH_AUTH_SOCK la
distanță să o redirecționeze din nou și să o folosească pe o altă gazdă (dar numai către o
destinație permisă).

-K Încarcă cheile rezidente de la un autentificator FIDO.

-k La încărcarea cheilor în agent sau la ștergerea cheilor din agent, se procesează numai cheile
private simple și se omit certificatele.

-L Listează parametrii de cheie publică ai tuturor identităților reprezentate în prezent de agent.

-l Listează amprentele digitale (fingerprint) ale tuturor identităților reprezentate în prezent de
agent.

-q Rămâne silențios (fără ieșire) după o operație reușită.

-S furnizor
Specifică o rută către o bibliotecă care va fi utilizată la adăugarea cheilor găzduite de
autentificatorul FIDO, înlocuind opțiunea implicită de utilizare a suportului USB HID intern.

-s pkcs11
Adaugă cheile furnizate de biblioteca partajată PKCS#11 pkcs11. Fișierele de certificate pot fi
opțional enumerate ca argumente în linia de comandă. Dacă acestea sunt prezente, atunci vor fi
încărcate în agent folosind orice chei private corespunzătoare încărcate din tokenul PKCS#11.

-T cheie-publică ...
Testează dacă cheile private care corespund fișierelor pubkey specificate sunt utilizabile,
efectuând operații de semnare și verificare pe fiecare dintre acestea.

-t durata-de-viață
Stabilește o durată maximă de viață atunci când se adaugă identități la un agent. Durata de viață
poate fi specificată în secunde sau într-un format de timp specificat în sshd_config(5).

-v Modul descriptiv. Face ca ssh-add să afișeze mesaje de depanare despre progresul său. Acest lucru
este util pentru depanarea problemelor. Opțiunile multiple -v sporesc gradul de detalii a
descrierii. Valoarea maximă este 3.

-X Deblochează agentul.

-x Blochează agentul cu o parolă.

MEDIU

DISPLAY, SSH_ASKPASS and SSH_ASKPASS_REQUIRE
Dacă ssh-add are nevoie de o frază de acces, aceasta va citi fraza de acces din terminalul
curent, dacă a fost rulat de la un terminal. Dacă ssh-add nu are un terminal asociat, dar sunt
definite DISPLAY și SSH_ASKPASS, acesta va executa programul specificat de SSH_ASKPASS (în mod
implicit “ssh-askpass”) și va deschide o fereastră X11 pentru a citi fraza de acces. Acest lucru
este deosebit de util atunci când se apelează ssh-add de la un script .xsession sau un script
conex.

SSH_ASKPASS_REQUIRE permite un control suplimentar asupra utilizării unui program „askpass”
(solicitare parole). Dacă această variabilă este stabilită la “never”, atunci ssh-add nu va
încerca niciodată să folosească unul. Dacă este stabilită la “prefer”, atunci ssh-add va prefera
să utilizeze programul «askpass» în locul TTY atunci când solicită parole. În cele din urmă, dacă
variabila este stabilită la “force”, atunci programul «askpass» va fi utilizat pentru toate
introducerile de fraze de acces, indiferent dacă DISPLAY este definită sau nu.

SSH_AUTH_SOCK
Identifică ruta unui soclu Unix-domain utilizat pentru a comunica cu agentul.

SSH_SK_PROVIDER
Specifică o rută către o bibliotecă care va fi utilizată la încărcarea oricăror chei găzduite de
autentificatorul FIDO, înlocuind opțiunea implicită de utilizare a suportului USB HID încorporat.

FIȘIERE

       ~/.ssh/id_ecdsa
       ~/.ssh/id_ecdsa_sk
       ~/.ssh/id_ed25519
       ~/.ssh/id_ed25519_sk
       ~/.ssh/id_rsa
               Conține identitatea de autentificare ECDSA, găzduită de autentificatorul ECDSA, Ed25519, găzduită
               de autentificatorul Ed25519 sau identitatea de autentificare RSA a utilizatorului.

       Fișierele  de  identitate  nu ar trebui să poată fi citite decât de către utilizator. Rețineți că ssh-add
       ignoră fișierele de identitate în cazul în care acestea sunt accesibile altor persoane.

STARE DE IEȘIRE

       Starea de ieșire este 0 în caz de succes, 1 dacă comanda specificată eșuează și 2 dacă ssh-add  nu  poate
       contacta agentul de autentificare.

CONSULTAȚI ȘI

       ssh(1), ssh-agent(1), ssh-askpass(1), ssh-keygen(1), sshd(8)

AUTORI

       OpenSSH  este  un derivat al versiunii originale și libere ssh 1.2.12 de Tatu Ylonen. Aaron Campbell, Bob
       Beck, Markus Friedl, Niels Provos, Theo de Raadt și Dug Song au eliminat multe erori, au adăugat din  nou
       caracteristici  noi  și au creat OpenSSH. Markus Friedl a contribuit la suportul pentru versiunile 1.5 și
       2.0 ale protocolului SSH.

TRADUCERE

       Traducerea   în   limba   română   a   acestui   manual   a   fost   făcută   de   Remus-Gabriel    Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența  publică  generală  GNU  Versiunea  3:
       https://www.gnu.org/licenses/gpl-3.0.html sau o  versiune  ulterioară  cu  privire  la  condiții  privind
       drepturile de autor.  NU se asumă NICIO RESPONSABILITATE.

       Dacă   găsiți   erori   în   traducerea   acestui   manual,   vă   rugăm   să   trimiteți  un  e-mail  la
       translation-team-ro@lists.sourceforge.net .

Debian                                      Mdocdate: 17 iunie 2024 $                                 SSH-ADD(1)