git-credential - Online nel cloud

PROGRAMMA:

NOME

git-credential - Recupera e archivia le credenziali dell'utente

SINOSSI

git credenziale

DESCRIZIONE

Git ha un'interfaccia interna per l'archiviazione e il recupero delle credenziali da specifiche del sistema
helper, oltre a richiedere all'utente nomi utente e password. Le credenziali git
Il comando espone questa interfaccia a script che potrebbero voler recuperare, archiviare o richiedere
credenziali allo stesso modo di Git. Il design di questa interfaccia con script modella il
API C interna; vedere , il Idiota credenziali API[1] per ulteriori informazioni sui concetti.

git-credential accetta un'opzione "azione" sulla riga di comando (una di riempimento, approvazione o
rifiuto) e legge una descrizione della credenziale su stdin (vedi FORMATO INPUT/OUTPUT).

Se l'azione è completa, git-credential tenterà di aggiungere "nome utente" e "password"
attributi alla descrizione leggendo i file di configurazione, contattando qualsiasi configurato
assistenti alle credenziali o chiedendo all'utente. Gli attributi nome utente e password del
la descrizione delle credenziali viene quindi stampata su stdout insieme agli attributi già
fornito.

Se l'azione è approvata, git-credential invierà la descrizione a qualsiasi configurato
assistenti alle credenziali, che possono archiviare le credenziali per un uso successivo.

Se l'azione è rifiutata, git-credential invierà la descrizione a qualsiasi configurato
assistenti alle credenziali, che possono cancellare qualsiasi credenziale memorizzata che corrisponda alla descrizione.

Se l'azione è approva o rifiuta, non dovrebbe essere emesso alcun output.

TIPICO USO OF GIT CREDENZIALI

Un'applicazione che utilizza git-credential in genere utilizzerà le credenziali git dopo queste
passaggi:

1. Generare una descrizione delle credenziali in base al contesto.

Ad esempio, se vogliamo una password per https://example.com/foo.git, potremmo generare
la seguente descrizione della credenziale (non dimenticare la riga vuota alla fine; dice
git credenziale che l'applicazione ha terminato di fornire tutte le informazioni in suo possesso):

protocollo=https
host=esempio.com
percorso=foo.git

2. Chiedi a git-credential di fornirci un nome utente e una password per questa descrizione. Questo è
fatto eseguendo git credential fill, alimentando la descrizione dal passaggio (1) al suo
ingresso standard. La descrizione completa della credenziale (inclusa la credenziale in sé,
cioè il login e la password) verranno prodotti su standard output, come:

protocollo=https
host=esempio.com
nome utente=bob
password=secr3t

Nella maggior parte dei casi, ciò significa che gli attributi forniti nell'input verranno ripetuti nel
output, ma Git può anche modificare la descrizione delle credenziali, ad esempio rimuovendo
l'attributo path quando il protocollo è HTTP(s) e credential.useHttpPath è false.

Se la credenziale git conosceva la password, questo passaggio potrebbe non aver coinvolto il
l'utente sta effettivamente digitando questa password (l'utente potrebbe aver digitato una password per sbloccare il
portachiavi invece, o non è stata eseguita alcuna interazione con l'utente se il portachiavi era già
sbloccato) prima di restituire password=secr3t.

3. Usa la credenziale (ad esempio, accedi all'URL con il nome utente e la password dal passaggio
(2)), e vedere se è accettato.

4. Segnalare l'esito positivo o negativo della password. Se la credenziale ha consentito il
operazione da completare con successo, quindi può essere contrassegnata con un'azione "approvare" per
dì a git credential di riutilizzarlo nella sua prossima chiamata. Se la credenziale è stata rifiutata
durante l'operazione, usa l'azione "reject" in modo che git credenziale chieda a
nuova password alla sua successiva chiamata. In entrambi i casi, le credenziali git dovrebbero essere alimentate con
la descrizione della credenziale ottenuta dal passaggio (2) (che contiene anche quelle
fornito al punto (1)).

INGRESSO / USCITA FORMATO

git credenziale legge e/o scrive (a seconda dell'azione utilizzata) le informazioni sulle credenziali
nel suo ingresso/uscita standard. Queste informazioni possono corrispondere sia a chiavi per le quali git
credenziale otterrà le informazioni di accesso/password (ad es. host, protocollo, percorso) o per
i dati effettivi delle credenziali da ottenere (login/password).

La credenziale è suddivisa in un insieme di attributi denominati, con un attributo per riga. Ogni
l'attributo è specificato da una coppia chiave-valore, separata da un segno = (uguale), seguito da a
nuova linea. La chiave può contenere qualsiasi byte eccetto =, newline o NUL. Il valore può contenere
qualsiasi byte eccetto newline o NUL. In entrambi i casi, tutti i byte sono trattati così come sono (cioè, lì
non è una citazione e non è possibile trasmettere un valore con newline o NUL in esso). L'elenco di
attributi è terminato da una riga vuota o dalla fine del file. Git comprende quanto segue
attributi:

protocollo
Il protocollo su cui verranno utilizzate le credenziali (ad es. https).

host
Il nome host remoto per una credenziale di rete.

sentiero
Il percorso con cui verrà utilizzata la credenziale. Ad esempio, per accedere a un https . remoto
repository, questo sarà il percorso del repository sul server.

nome utente
Il nome utente della credenziale, se ne abbiamo già uno (ad esempio, da un URL, dall'utente o
da un helper eseguito in precedenza).

parola d'ordine
La password della credenziale, se ne chiediamo l'archiviazione.

URL
Quando questo attributo speciale viene letto da git credenziale, il valore viene analizzato come un URL
e trattato come se le sue parti costitutive fossero lette (ad esempio, url=https://example.com sarebbe
comportarsi come se fossero stati forniti protocol=https e host=example.com). Questo può aiutare
i chiamanti evitano di analizzare gli URL stessi. Nota che tutti i componenti che mancano da
l'URL (ad esempio, non c'è un nome utente nell'esempio sopra) sarà impostato su vuoto; se tu
desidera fornire un URL e sovrascrivere alcuni attributi, fornire prima l'attributo URL,
seguito da eventuali sostituzioni.

NOTE

1. l'API delle credenziali Git
file:///usr/share/doc/git/html/technical/api-credentials.html

Usa git-credential online utilizzando i servizi onworks.net