git-credential - En ligne dans le Cloud

PROGRAMME:

Nom

git-credential - Récupérer et stocker les informations d'identification des utilisateurs

SYNOPSIS

informations d'identification git

DESCRIPTION

Git dispose d'une interface interne pour stocker et récupérer les informations d'identification spécifiques au système
assistants, ainsi que demander à l'utilisateur des noms d'utilisateur et des mots de passe. Le git-credential
La commande expose cette interface aux scripts qui peuvent vouloir récupérer, stocker ou demander
les informations d'identification de la même manière que Git. La conception de cette interface scriptable modélise le
API C interne ; voir le Git des titres de compétences API[1] pour plus d'informations sur les concepts.

git-credential prend une option "action" sur la ligne de commande (une parmi remplir, approuver ou
rejeter) et lit une description des informations d'identification sur stdin (voir FORMAT D'ENTRÉE/SORTIE).

Si l'action est remplie, git-credential tentera d'ajouter "nom d'utilisateur" et "mot de passe"
attributs à la description en lisant les fichiers de configuration, en contactant tout
assistants d'informations d'identification, ou en invitant l'utilisateur. Les attributs de nom d'utilisateur et de mot de passe du
la description des informations d'identification est ensuite imprimée sur stdout avec les attributs déjà
à condition de.

Si l'action est approuvée, git-credential enverra la description à tout
les assistants d'identification, qui peuvent stocker les informations d'identification pour une utilisation ultérieure.

Si l'action est rejetée, git-credential enverra la description à tout
les assistants d'identification, qui peuvent effacer toutes les informations d'identification stockées correspondant à la description.

Si l'action est approuver ou rejeter, aucune sortie ne doit être émise.

TYPIQUE UTILISATION OF GIT CRÉDENTIEL

Une application utilisant git-credential utilisera généralement les informations d'identification git après ces
étapes:

1. Générez une description des informations d'identification en fonction du contexte.

Par exemple, si nous voulons un mot de passe pour https://example.com/foo.git, nous pouvons générer
la description des informations d'identification suivante (n'oubliez pas la ligne vide à la fin ; elle indique
git credential que l'application a fini de fournir toutes les informations dont elle dispose) :

protocole=https
hôte=exemple.com
chemin=foo.git

2. Demandez à git-credential de nous donner un nom d'utilisateur et un mot de passe pour cette description. C'est
fait en exécutant git credential fill, en alimentant la description de l'étape (1) à son
entrée standard. La description complète des informations d'identification (y compris les informations d'identification en tant que telles,
c'est-à-dire le login et le mot de passe) sera produit sur une sortie standard, comme :

protocole=https
hôte=exemple.com
nom d'utilisateur = bob
mot de passe=secr3t

Dans la plupart des cas, cela signifie que les attributs donnés dans l'entrée seront répétés dans le
sortie, mais Git peut également modifier la description des informations d'identification, par exemple en supprimant
l'attribut path lorsque le protocole est HTTP(s) et que les informations d'identification.useHttpPath sont false.

Si les informations d'identification git connaissaient le mot de passe, cette étape peut ne pas avoir impliqué le
utilisateur tapant réellement ce mot de passe (l'utilisateur peut avoir tapé un mot de passe pour déverrouiller le
porte-clés à la place, ou aucune interaction de l'utilisateur n'a été effectuée si le porte-clés était déjà
déverrouillé) avant de renvoyer password=secr3t.

3. Utilisez les informations d'identification (par exemple, accédez à l'URL avec le nom d'utilisateur et le mot de passe de l'étape
(2)), et voyez si c'est accepté.

4. Rapport sur le succès ou l'échec du mot de passe. Si les informations d'identification permettaient au
l'opération se termine avec succès, alors elle peut être marquée avec une action « approuver » pour
dites à git credential de le réutiliser lors de son prochain appel. Si le justificatif a été rejeté
pendant l'opération, utilisez l'action "reject" pour que git Credential demande un
nouveau mot de passe lors de sa prochaine invocation. Dans les deux cas, les informations d'identification git doivent être alimentées avec
la description des informations d'identification obtenue à l'étape (2) (qui contiennent également celles
fourni à l'étape (1)).

ENTRÉE / SORTIE Format

git credential lit et/ou écrit (selon l'action utilisée) les informations d'identification
dans son entrée/sortie standard. Ces informations peuvent correspondre soit à des clés pour lesquelles git
Les informations d'identification obtiendront les informations de connexion/mot de passe (par exemple, hôte, protocole, chemin) ou à
les données d'identification réelles à obtenir (login/mot de passe).

Les informations d'identification sont divisées en un ensemble d'attributs nommés, avec un attribut par ligne. Chaque
L'attribut est spécifié par une paire clé-valeur, séparée par un signe = (égal), suivi d'un
nouvelle ligne. La clé peut contenir n'importe quel octet sauf =, saut de ligne ou NUL. La valeur peut contenir
tous les octets sauf saut de ligne ou NUL. Dans les deux cas, tous les octets sont traités tels quels (c'est-à-dire qu'il
n'y a pas de guillemets, et on ne peut pas transmettre une valeur avec une nouvelle ligne ou NUL). La liste de
attributs se termine par une ligne vierge ou une fin de fichier. Git comprend ce qui suit
attributs:

protocole
Le protocole sur lequel les informations d'identification seront utilisées (par exemple, https).

hôte
Le nom d'hôte distant pour un identifiant réseau.

chemin
Le chemin avec lequel les informations d'identification seront utilisées. Par exemple, pour accéder à un https distant
référentiel, ce sera le chemin du référentiel sur le serveur.

Nom d'utilisateur
Le nom d'utilisateur de l'identifiant, si nous en avons déjà un (par exemple, à partir d'une URL, de l'utilisateur ou
à partir d'un assistant précédemment exécuté).

Mot de passe
Le mot de passe de l'identifiant, si nous demandons qu'il soit stocké.

url
Lorsque cet attribut spécial est lu par les informations d'identification git, la valeur est analysée en tant qu'URL
et traité comme si ses éléments constitutifs étaient lus (par exemple, url=https://example.com serait
se comporter comme si protocol=https et host=example.com avaient été fournis). Cela peut aider
les appelants évitent d'analyser eux-mêmes les URL. Notez que tous les composants manquants
l'URL (par exemple, il n'y a pas de nom d'utilisateur dans l'exemple ci-dessus) sera définie sur vide ; Si vous
voulez fournir une URL et remplacer certains attributs, fournissez d'abord l'attribut URL,
suivi de toutes les dérogations.

NOTES

1. l'API d'identification Git
fichier:///usr/share/doc/git/html/technical/api-credentials.html

Utilisez git-credential en ligne en utilisant les services onworks.net