git-credential - Online na nuvem

PROGRAMA:

NOME

git-credential - recuperar e armazenar credenciais de usuário

SINOPSE

credencial git

DESCRIÇÃO

Git tem uma interface interna para armazenar e recuperar credenciais de sistemas específicos
auxiliares, bem como solicitar ao usuário nomes de usuário e senhas. O git-credential
comando expõe esta interface a scripts que podem querer recuperar, armazenar ou solicitar
credenciais da mesma maneira que o Git. O design desta interface programável modela o
API C interna; Vejo que o Git credencial API[1] para obter mais informações sobre os conceitos.

git-credential executa uma opção de "ação" na linha de comando (preencher, aprovar ou
rejeitar) e ler uma descrição de credencial em stdin (consulte INPUT / OUTPUT FORMAT).

Se a ação for concluída, git-credential tentará adicionar "nome de usuário" e "senha"
atributos para a descrição lendo arquivos de configuração, entrando em contato com qualquer
ajudantes de credencial ou avisando o usuário. Os atributos de nome de usuário e senha do
a descrição da credencial é então impressa no stdout junto com os atributos já
forneceu.

Se a ação for aprovada, o git-credential enviará a descrição para qualquer pessoa configurada
ajudantes de credencial, que podem armazenar a credencial para uso posterior.

Se a ação for rejeitada, o git-credential enviará a descrição para qualquer pessoa configurada
ajudantes de credencial, que podem apagar qualquer credencial armazenada que corresponda à descrição.

Se a ação for aprovar ou rejeitar, nenhuma saída deve ser emitida.

TÍPICA USO OF GIT CREDENCIAL

Um aplicativo que usa git-credential normalmente usará a credencial git seguindo estes
passos:

1. Gere uma descrição de credencial com base no contexto.

Por exemplo, se quisermos uma senha para https://example.com/foo.git, podemos gerar
a seguinte descrição de credencial (não se esqueça da linha em branco no final; ela diz
credencial git de que o aplicativo terminou de alimentar todas as informações que possui):

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

2. Peça a git-credential para nos fornecer um nome de usuário e senha para esta descrição. Isto é
feito executando git credential fill, alimentando a descrição da etapa (1) para seu
entrada padrão. A descrição completa da credencial (incluindo a credencial em si,
ou seja, o login e a senha) serão produzidos na saída padrão, como:

protocolo = https
host = example.com
username = bob
senha = secr3t

Na maioria dos casos, isso significa que os atributos dados na entrada serão repetidos no
saída, mas o Git também pode modificar a descrição da credencial, por exemplo, removendo
o atributo path quando o protocolo é HTTP (s) e credential.useHttpPath é false.

Se a credencial git sabia sobre a senha, esta etapa pode não ter envolvido o
usuário realmente digitando esta senha (o usuário pode ter digitado uma senha para desbloquear o
keychain em vez disso, ou nenhuma interação do usuário foi feita se o keychain já estava
desbloqueado) antes de retornar password = secr3t.

3. Use a credencial (por exemplo, acesse a URL com o nome de usuário e a senha da etapa
(2)) e veja se ele é aceito.

4. Relate o sucesso ou falha da senha. Se a credencial permitisse o
operação seja concluída com sucesso, então ela pode ser marcada com uma ação "aprovar" para
diga ao git credential para reutilizá-lo em sua próxima invocação. Se a credencial foi rejeitada
durante a operação, use a ação "rejeitar" para que a credencial git peça um
nova senha em sua próxima invocação. Em qualquer caso, a credencial git deve ser alimentada com
a descrição da credencial obtida na etapa (2) (que também contém os
fornecido na etapa (1)).

ENTRADA / SAÍDA FORMATO

A credencial git lê e / ou grava (dependendo da ação usada) informações de credencial
em sua entrada / saída padrão. Essas informações podem corresponder a chaves para as quais git
credencial obterá as informações de login / senha (por exemplo, host, protocolo, caminho) ou para
os dados reais da credencial a serem obtidos (login / senha).

A credencial é dividida em um conjunto de atributos nomeados, com um atributo por linha. Cada
atributo é especificado por um par de valores-chave, separado por um sinal = (igual), seguido por um
nova linha. A chave pode conter quaisquer bytes, exceto =, nova linha ou NUL. O valor pode conter
quaisquer bytes, exceto newline ou NUL. Em ambos os casos, todos os bytes são tratados como estão (ou seja,
não é uma cotação e não se pode transmitir um valor com nova linha ou NUL). A lista de
atributos é encerrado por uma linha em branco ou fim de arquivo. Git entende o seguinte
atributos:

protocolo
O protocolo sobre o qual a credencial será usada (por exemplo, https).

hospedeiro
O nome do host remoto para uma credencial de rede.

caminho
O caminho com o qual a credencial será usada. Por exemplo, para acessar um https remoto
repositório, este será o caminho do repositório no servidor.

nome de usuário
O nome de usuário da credencial, se já tivermos um (por exemplo, de uma URL, do usuário ou
de um auxiliar executado anteriormente).

senha
A senha da credencial, se estivermos solicitando que seja armazenada.

url
Quando este atributo especial é lido pela credencial git, o valor é analisado como um URL
e tratado como se suas partes constituintes fossem lidas (por exemplo, url = https: //example.com seria
comporte-se como se protocol = https e host = example.com tivessem sido fornecidos). Isso pode ajudar
chamadores evitam analisar URLs eles próprios. Observe que todos os componentes que estão faltando no
a URL (por exemplo, não há nome de usuário no exemplo acima) será definida como vazia; se vocês
deseja fornecer um URL e substituir alguns atributos, forneça o atributo URL primeiro,
seguido por quaisquer substituições.

NOTAS

1. a API de credencial Git
arquivo: ///usr/share/doc/git/html/technical/api-credentials.html

Use git-credential online usando serviços onworks.net