git-credential — Online w chmurze

PROGRAM:

IMIĘ

git-credential — pobiera i przechowuje dane uwierzytelniające użytkownika

STRESZCZENIE

poświadczenie git

OPIS

Git posiada wewnętrzny interfejs do przechowywania i pobierania danych uwierzytelniających z poziomu systemu
pomocników, a także monitowanie użytkownika o nazwę użytkownika i hasło. Poświadczenie git
polecenie udostępnia ten interfejs skryptom, które mogą chcieć pobrać, zapisać lub zapytać
poświadczenia w taki sam sposób jak Git. Projekt tego skryptowego interfejsu modeluje
wewnętrzne API C; Widzieć dotychczasowy git poświadczenie API[1], aby uzyskać więcej informacji na temat tych koncepcji.

git-credential przyjmuje opcję „akcji” w wierszu poleceń (jedną z opcji wypełnienia, zatwierdzenia lub
odrzucić) i odczytuje opis poświadczeń na stdin (patrz FORMAT WEJŚCIA/WYJŚCIA).

Jeśli akcja zostanie wypełniona, git-credential spróbuje dodać „nazwę użytkownika” i „hasło”
atrybuty do opisu, czytając pliki konfiguracyjne, kontaktując się z dowolnym skonfigurowanym
pomocników poświadczeń lub poprzez monitowanie użytkownika. Atrybuty nazwy użytkownika i hasła pliku
opis danych uwierzytelniających jest następnie drukowany na standardowe wyjście wraz z już istniejącymi atrybutami
opatrzony.

Jeśli akcja zostanie zatwierdzona, git-credential wyśle ​​opis do dowolnego skonfigurowanego
pomocników poświadczeń, które mogą przechowywać poświadczenia do późniejszego wykorzystania.

Jeśli akcja zostanie odrzucona, git-credential wyśle ​​opis do dowolnego skonfigurowanego
pomocników poświadczeń, które mogą usunąć wszelkie zapisane poświadczenia pasujące do opisu.

Jeśli akcja to zatwierdzenie lub odrzucenie, nie należy emitować żadnych danych wyjściowych.

TYPOWY UŻYWAĆ OF GIT POŚWIADCZENIE

Aplikacja korzystająca z poświadczeń git będzie zazwyczaj używać poświadczeń git po nich
kroki:

1. Wygeneruj opis referencji na podstawie kontekstu.

Na przykład, jeśli chcemy hasła do https://example.com/foo.git, możemy je wygenerować
następujący opis danych uwierzytelniających (nie zapomnij o pustej linii na końcu; mówi ona
git, potwierdzające, że aplikacja zakończyła dostarczanie wszystkich posiadanych informacji):

protokół=https
host=przykład.com
ścieżka=foo.git

2. Poproś git-credential o podanie nazwy użytkownika i hasła dla tego opisu. To jest
można to zrobić, uruchamiając git credential fill i podając opis z kroku (1) do pliku
standardowe wejście. Pełny opis referencji (w tym referencji jako takiej,
tj. login i hasło) zostaną wygenerowane na standardowe wyjście, jak:

protokół=https
host=przykład.com
nazwa użytkownika=bob
hasło=sekret3t

W większości przypadków oznacza to, że atrybuty podane na wejściu zostaną powtórzone w pliku
dane wyjściowe, ale Git może również zmodyfikować opis referencji, na przykład poprzez usunięcie
atrybut path, jeśli protokołem jest HTTP(s), a credential.useHttpPath ma wartość false.

Jeśli poświadczenia Git wiedziały o haśle, ten krok mógł nie obejmować
użytkownik faktycznie wpisuje to hasło (użytkownik mógł wpisać hasło, aby odblokować
zamiast tego pęku kluczy lub nie wykonano żadnej interakcji z użytkownikiem, jeśli pęk kluczy już istniał
odblokowany), zanim zwrócił hasło=secr3t.

3. Użyj danych uwierzytelniających (np. uzyskaj dostęp do adresu URL z nazwą użytkownika i hasłem z kroku
(2)) i sprawdź, czy zostało zaakceptowane.

4. Zgłoś sukces lub niepowodzenie hasła. Jeśli poświadczenie pozwoliło na
operacja zakończy się pomyślnie, wówczas można ją oznaczyć akcją „zatwierdź”.
powiedz git credential, aby ponownie użył go w następnym wywołaniu. Jeśli poświadczenie zostało odrzucone
podczas operacji użyj akcji „odrzuć”, aby poświadczenia git poprosiły o podanie
nowe hasło przy następnym wywołaniu. W obu przypadkach należy podać dane uwierzytelniające git
opis danych uwierzytelniających uzyskany w kroku (2) (który zawiera również te
podane w kroku (1)).

WEJŚCIE / WYJŚCIE FORMAT

git credential odczytuje i/lub zapisuje (w zależności od użytej akcji) informacje uwierzytelniające
w swoim standardowym wejściu/wyjściu. Informacje te mogą odpowiadać albo kluczom, dla których git
Credential uzyska informacje dotyczące loginu/hasła (np. hosta, protokołu, ścieżki) lub do
rzeczywiste dane uwierzytelniające, które należy uzyskać (login/hasło).

Poświadczenie jest podzielone na zestaw nazwanych atrybutów, z jednym atrybutem w wierszu. Każdy
atrybut jest określony przez parę klucz-wartość oddzieloną znakiem = (równości), po którym następuje a
Nowa linia. Klucz może zawierać dowolne bajty z wyjątkiem =, nowej linii i NUL. Wartość może zawierać
dowolne bajty z wyjątkiem nowej linii lub NUL. W obu przypadkach wszystkie bajty są traktowane tak, jak są (tj
nie oznacza cudzysłowu i nie można przesłać wartości zawierającej znak nowej linii lub wartość NUL). Lista
atrybuty kończy się pustą linią lub końcem pliku. Git rozumie, co następuje
atrybuty:

protokół
Protokół, w którym będą używane dane uwierzytelniające (np. https).

gospodarz
Zdalna nazwa hosta dla poświadczeń sieciowych.

ścieżka
Ścieżka, z którą będą używane poświadczenia. Np. w celu uzyskania dostępu do zdalnego protokołu https
repository, będzie to ścieżka do repozytorium na serwerze.

nazwa użytkownika
Nazwa użytkownika poświadczenia, jeśli już ją posiadamy (np. z adresu URL, od użytkownika lub
z wcześniej uruchomionego pomocnika).

password
Hasło do danych uwierzytelniających, jeśli prosimy o jego przechowywanie.

url
Kiedy ten specjalny atrybut jest odczytywany przez dane uwierzytelniające git, wartość jest analizowana jako adres URL
i traktowane tak, jakby jego części składowe zostały odczytane (np. url=https://example.com
zachowywać się tak, jakby podano protokoły=https i host=example.com). To może pomóc
osoby dzwoniące unikają samodzielnego analizowania adresów URL. Należy pamiętać, że wszelkie brakujące elementy
adres URL (np. w powyższym przykładzie nie ma nazwy użytkownika) zostanie ustawiony na pusty; Jeśli ty
chcesz podać adres URL i zastąpić niektóre atrybuty, najpierw podaj atrybut URL,
po którym następują wszelkie nadpisania.

UWAGI

1. API poświadczeń Git
file:///usr/share/doc/git/html/technical/api-credentials.html

Użyj git-credential online, korzystając z usług onworks.net