git-credential: en línea en la nube

PROGRAMA:

NOMBRE

git-credential: recupera y almacena las credenciales de usuario

SINOPSIS

credencial git

DESCRIPCIÓN

Git tiene una interfaz interna para almacenar y recuperar credenciales de sistemas específicos
ayudantes, además de solicitar al usuario nombres de usuario y contraseñas. La credencial git
El comando expone esta interfaz a scripts que pueden querer recuperar, almacenar o solicitar
credenciales de la misma manera que Git. El diseño de esta interfaz programable modela el
API C interna; ver las Git credencial API[1] para obtener más antecedentes sobre los conceptos.

git-credential toma una opción de "acción" en la línea de comandos (una de completar, aprobar o
rechazar) y lee una descripción de la credencial en stdin (ver FORMATO DE ENTRADA / SALIDA).

Si la acción es completa, git-credential intentará agregar "nombre de usuario" y "contraseña"
atributos a la descripción leyendo archivos de configuración, poniéndose en contacto con cualquier
ayudantes de credenciales, o solicitando al usuario. Los atributos de nombre de usuario y contraseña del
La descripción de la credencial se imprime en la salida estándar junto con los atributos ya
previsto.

Si se aprueba la acción, git-credential enviará la descripción a cualquier
ayudantes de credenciales, que pueden almacenar la credencial para su uso posterior.

Si la acción es rechazada, git-credential enviará la descripción a cualquier configuración
ayudantes de credenciales, que pueden borrar cualquier credencial almacenada que coincida con la descripción.

Si la acción es aprobada o rechazada, no se debe emitir ninguna salida.

TÍPICO USO OF GIT CREDENCIAL

Una aplicación que usa git-credential generalmente usará git credential después de estas
pasos:

1. Genere una descripción de la credencial basada en el contexto.

Por ejemplo, si queremos una contraseña para https://example.com/foo.git, podríamos generar
la siguiente descripción de la credencial (no olvide la línea en blanco al final; dice
git credencial que la aplicación terminó de alimentar toda la información que tiene):

protocolo = https
host = example.com
ruta = foo.git

2. Solicite a git-credential que nos proporcione un nombre de usuario y una contraseña para esta descripción. Este es
hecho ejecutando git credential fill, alimentando la descripción del paso (1) a su
entrada estándar. La descripción completa de la credencial (incluida la credencial per se,
es decir, el nombre de usuario y la contraseña) se generarán en la salida estándar, como:

protocolo = https
host = example.com
nombre de usuario = bob
contraseña = secr3t

En la mayoría de los casos, esto significa que los atributos dados en la entrada se repetirán en la
salida, pero Git también puede modificar la descripción de la credencial, por ejemplo, eliminando
el atributo de ruta cuando el protocolo es HTTP (s) y credential.useHttpPath es falso.

Si la credencial de git conocía la contraseña, es posible que este paso no haya involucrado al
usuario que realmente escribe esta contraseña (el usuario puede haber escrito una contraseña para desbloquear el
llavero en su lugar, o no se realizó ninguna interacción con el usuario si el llavero ya estaba
desbloqueado) antes de que devolviera la contraseña = secr3t.

3. Utilice la credencial (p. Ej., Acceda a la URL con el nombre de usuario y la contraseña del paso
(2)) y compruebe si se acepta.

4. Informar sobre el éxito o el fracaso de la contraseña. Si la credencial permitía
operación para completar correctamente, entonces se puede marcar con una acción "aprobar" para
dígale a git credential que lo reutilice en su próxima invocación. Si la credencial fue rechazada
durante la operación, use la acción "rechazar" para que la credencial de git solicite una
nueva contraseña en su próxima invocación. En cualquier caso, la credencial de git debe alimentarse con
la descripción de la credencial obtenida en el paso (2) (que también contiene las
proporcionado en el paso (1)).

ENTRADA / SALIDA FORMATO

git credential lee y / o escribe (dependiendo de la acción utilizada) información de credenciales
en su entrada / salida estándar. Esta información puede corresponder a claves para las que git
credencial obtendrá la información de inicio de sesión / contraseña (por ejemplo, host, protocolo, ruta), o para
los datos reales de la credencial que se obtendrán (inicio de sesión / contraseña).

La credencial se divide en un conjunto de atributos con nombre, con un atributo por línea. Cada
El atributo se especifica mediante un par clave-valor, separado por un signo = (igual), seguido de un
nueva línea. La clave puede contener cualquier byte excepto =, newline o NUL. El valor puede contener
cualquier bytes excepto nueva línea o NUL. En ambos casos, todos los bytes se tratan tal cual (es decir, hay
no es una cita y no se puede transmitir un valor con nueva línea o NUL). La lista de
Los atributos terminan con una línea en blanco o un final de archivo. Git entiende lo siguiente
atributos:

protocolo
El protocolo sobre el que se utilizará la credencial (por ejemplo, https).

fortaleza
El nombre de host remoto para una credencial de red.

camino
La ruta con la que se utilizará la credencial. Por ejemplo, para acceder a un https remoto
repositorio, esta será la ruta del repositorio en el servidor.

nombre de usuario
El nombre de usuario de la credencial, si ya tenemos uno (p. Ej., De una URL, del usuario o
de un ayudante ejecutado previamente).

la contraseña
La contraseña de la credencial, si estamos solicitando que se almacene.

url
Cuando la credencial de git lee este atributo especial, el valor se analiza como una URL
y tratada como si se leyeran sus partes constituyentes (p. ej., url = https: //example.com
comportarse como si se hubieran proporcionado protocol = https y host = example.com). Esto puede ayudar
las personas que llaman evitan analizar las URL por sí mismas. Tenga en cuenta que cualquier componente que falte en
la URL (por ejemplo, no hay nombre de usuario en el ejemplo anterior) se configurará como vacía; si tu
desea proporcionar una URL y anular algunos atributos, proporcione primero el atributo de URL,
seguido de cualquier anulación.

NOTAS

1. la API de credenciales de Git
archivo: ///usr/share/doc/git/html/technical/api-credentials.html

Use git-credential en línea usando los servicios de onworks.net