git-credential - Online in de cloud

PROGRAMMA:

NAAM

git-credential - Gebruikersreferenties ophalen en opslaan

KORTE INHOUD

git-referentie

PRODUCTBESCHRIJVING

Git heeft een interne interface voor het opslaan en ophalen van inloggegevens van systeemspecifiek
helpers, en de gebruiker vragen om gebruikersnamen en wachtwoorden. De git-credential
opdracht stelt deze interface bloot aan scripts die mogelijk willen ophalen, opslaan of vragen om
referenties op dezelfde manier als Git. Het ontwerp van deze scriptbare interface modelleert de
interne C API; zien de Git geloofsbrief API[1] voor meer achtergrondinformatie over de concepten.

git-credential neemt een "action" optie op de commandoregel (een van fill, approval, or
reject) en leest een credential description op stdin (zie INPUT/OUTPUT FORMAT).

Als de actie fill is, zal git-credential proberen om "gebruikersnaam" en "wachtwoord" toe te voegen
attributen aan de beschrijving door configuratiebestanden te lezen, door contact op te nemen met een geconfigureerd
credential helpers, of door de gebruiker te vragen. De gebruikersnaam en het wachtwoord kenmerken van de
referentiebeschrijving worden dan afgedrukt naar stdout samen met de attributen al
verstrekt.

Als de actie goedkeurt, stuurt git-credential de beschrijving naar elke geconfigureerde
credential helpers, die de credential kunnen opslaan voor later gebruik.

Als de actie wordt afgewezen, stuurt git-credential de beschrijving naar elke geconfigureerde
credential helpers, die alle opgeslagen referenties die overeenkomen met de beschrijving kunnen wissen.

Als de actie goedkeuren of afwijzen is, mag er geen uitvoer worden verzonden.

TYPISCH GEBRUIK OF GIT IDENTIFICATIE

Een toepassing die git-credential gebruikt, zal doorgaans git-referenties gebruiken die deze volgen
stappen:

1. Genereer een diplomabeschrijving op basis van de context.

Als we bijvoorbeeld een wachtwoord willen voor https://example.com/foo.git, kunnen we genereren
de volgende referentiebeschrijving (vergeet de lege regel aan het einde niet; het vertelt
git referentie dat de applicatie klaar is met het invoeren van alle informatie die het heeft):

protocol=https
host=voorbeeld.com
pad=foo.git

2. Vraag git-credential om ons een gebruikersnaam en wachtwoord voor deze beschrijving te geven. Dit is
gedaan door git credential fill uit te voeren, waarbij de beschrijving van stap (1) wordt ingevoerd in its
standaard invoer. De volledige legitimatiebeschrijving (inclusief de legitimatie op zich,
d.w.z. de login en het wachtwoord) worden geproduceerd op standaarduitvoer, zoals:

protocol=https
host=voorbeeld.com
gebruikersnaam=bob
wachtwoord=secr3t

In de meeste gevallen betekent dit dat de kenmerken die in de invoer zijn opgegeven, worden herhaald in de
output, maar Git kan ook de referentiebeschrijving wijzigen, bijvoorbeeld door het verwijderen
het padkenmerk wanneer het protocol HTTP(s) is en credential.useHttpPath onwaar is.

Als de git-referentie op de hoogte was van het wachtwoord, was deze stap mogelijk niet betrokken bij de
gebruiker dit wachtwoord daadwerkelijk typt (de gebruiker heeft mogelijk een wachtwoord getypt om het
sleutelhanger in plaats daarvan, of er is geen gebruikersinteractie uitgevoerd als de sleutelhanger er al was
ontgrendeld) voordat het wachtwoord = secr3t retourneerde.

3. Gebruik de referentie (ga bijvoorbeeld naar de URL met de gebruikersnaam en het wachtwoord van step
(2)), en kijk of het wordt geaccepteerd.

4. Rapporteer over het succes of falen van het wachtwoord. Als de referentie het toestaat
operatie met succes te voltooien, dan kan het worden gemarkeerd met een actie "goedkeuren".
vertel git referentie om het opnieuw te gebruiken bij de volgende aanroep. Als de referentie is afgewezen
gebruik tijdens de operatie de "reject" actie zodat git credential om een
nieuw wachtwoord bij de volgende aanroep. In beide gevallen moet git-referentie worden ingevoerd
de legitimatiebeschrijving verkregen uit stap (2) (die ook degenen
voorzien in stap (1)).

INGANG / UITGANG FORMAT

git referentie leest en/of schrijft (afhankelijk van de gebruikte actie) referentie-informatie
in zijn standaard invoer/uitvoer. Deze informatie kan overeenkomen met sleutels waarvoor git
credential zal de aanmeldings-/wachtwoordinformatie verkrijgen (bijv. host, protocol, pad), of naar
de daadwerkelijk te verkrijgen legitimatiegegevens (login/wachtwoord).

De referentie is opgesplitst in een set benoemde attributen, met één attribuut per regel. Elk
attribuut wordt gespecificeerd door een sleutel-waardepaar, gescheiden door een = (is gelijk aan) teken, gevolgd door een
nieuwe lijn. De sleutel mag alle bytes bevatten behalve =, newline of NUL. De waarde kan bevatten
alle bytes behalve newline of NUL. In beide gevallen worden alle bytes behandeld zoals ze zijn (d.w.z. there
is geen aanhalingstekens, en men kan geen waarde verzenden met een nieuwe regel of NUL erin). De lijst van
attributen wordt beëindigd door een lege regel of end-of-file. Git begrijpt het volgende
attributen:

protocol
Het protocol waarover de referentie zal worden gebruikt (bijv. https).

gastheer
De externe hostnaam voor een netwerkreferentie.

pad
Het pad waarmee de referentie zal worden gebruikt. Bijvoorbeeld voor toegang tot een externe https
repository, dit is het pad van de repository op de server.

gebruikersnaam
De gebruikersnaam van de referentie, als we er al een hebben (bijvoorbeeld van een URL, van de gebruiker of
van een eerder uitgevoerde helper).

wachtwoord
Het wachtwoord van de referentie, als we vragen om het op te slaan.

url
Wanneer dit speciale attribuut wordt gelezen door git credential, wordt de waarde geparseerd als een URL
en behandeld alsof de samenstellende delen zijn gelezen (bijv. url=https://example.com zou
gedragen alsof protocol=https en host=example.com waren verstrekt). Dit kan helpen
bellers vermijden zelf URL's te parseren. Houd er rekening mee dat alle onderdelen die ontbreken
de URL (bijv. er is geen gebruikersnaam in het bovenstaande voorbeeld) wordt ingesteld op leeg; als jij
een URL wilt opgeven en sommige attributen wilt overschrijven, geef dan eerst het URL-attribuut op,
gevolgd door eventuele overrides.

OPMERKINGEN

1. de Git-referentie-API
bestand:///usr/share/doc/git/html/technical/api-credentials.html

Gebruik git-credential online met behulp van onworks.net-services