git-credential - Интернет в облаке

ПРОГРАММА:

ИМЯ

git-credential - получает и сохраняет учетные данные пользователя

СИНТАКСИС

учетные данные git

ОПИСАНИЕ

Git имеет внутренний интерфейс для хранения и извлечения учетных данных из системно-зависимых
помощники, а также запрашивают у пользователя логины и пароли. Git-учетные данные
команда предоставляет этот интерфейс сценариям, которые могут захотеть получить, сохранить или запросить
учетные данные так же, как в Git. Дизайн этого скриптового интерфейса моделирует
внутренний C API; видеть домен идти мандат API[1] для получения дополнительной информации о концепциях.

git-credential принимает параметр «действие» в командной строке (один из следующих: заполнить, утвердить или
reject) и читает описание учетных данных на стандартном вводе (см. ФОРМАТ ВХОДА / ВЫВОДА).

Если действие заполнено, git-credential попытается добавить «имя пользователя» и «пароль».
атрибуты к описанию, прочитав файлы конфигурации, связавшись с любым настроенным
помощники по учетным данным или по запросу пользователя. Атрибуты имени пользователя и пароля
затем описание учетных данных выводится на стандартный вывод вместе с уже имеющимися атрибутами.
при условии.

Если действие одобрено, git-credential отправит описание на любой настроенный
помощники по учетным данным, которые могут хранить учетные данные для последующего использования.

Если действие отклонено, git-credential отправит описание на любой настроенный
помощники по учетным данным, которые могут стереть любые сохраненные учетные данные, соответствующие описанию.

Если действие одобрено или отклонено, вывод не должен выдаваться.

ТИПИЧНЫЙ ИСПОЛЬЗОВАНИЕ OF GIT ПОЛНОМОЧИЯ

Приложение, использующее git-credential, обычно будет использовать учетные данные git после этих
действия:

1. Создайте описание учетных данных на основе контекста.

Например, если нам нужен пароль для https://example.com/foo.git, мы можем сгенерировать
следующее описание учетных данных (не забудьте пустую строку в конце; это говорит
git учетные данные о том, что приложение завершило загрузку всей имеющейся у него информации):

протокол = https
host = example.com
путь = foo.git

2. Попросите git-credential дать нам имя пользователя и пароль для этого описания. Это
выполняется путем запуска git credential fill, передавая описание с шага (1) его
стандартный ввод. Полное описание учетных данных (включая учетные данные как таковые,
т.е. логин и пароль) будут выводиться на стандартный вывод, например:

протокол = https
host = example.com
имя пользователя = боб
пароль = secr3t

В большинстве случаев это означает, что атрибуты, указанные во входных данных, будут повторяться в
вывод, но Git также может изменить описание учетных данных, например, удалив
атрибут пути, когда протоколом является HTTP (s) и credential.useHttpPath имеет значение false.

Если учетные данные git знали о пароле, этот шаг мог не включать
пользователь фактически вводит этот пароль (пользователь мог ввести пароль, чтобы разблокировать
вместо этого связка для ключей, или никакое взаимодействие с пользователем не было выполнено, если связка для ключей уже была
разблокирован) до того, как он вернул пароль = secr3t.

3. Используйте учетные данные (например, получите доступ к URL-адресу с именем пользователя и паролем из шага
(2)) и посмотрите, принято ли оно.

4. Сообщите об успешном или неудачном вводе пароля. Если учетные данные позволяют
операция для успешного завершения, то ее можно пометить с помощью действия "одобрить", чтобы
укажите учетные данные git, чтобы повторно использовать их при следующем вызове. Если учетные данные были отклонены
во время операции используйте действие «отклонить», чтобы учетные данные git запрашивали
новый пароль при его следующем вызове. В любом случае учетные данные git должны подаваться с
описание учетных данных, полученное на шаге (2) (которое также содержит
предоставлено на шаге (1)).

ВХОД / ВЫХОД ФОРМАТ

git credential читает и / или записывает (в зависимости от используемого действия) учетную информацию
в его стандартном вводе / выводе. Эта информация может соответствовать либо ключам, для которых git
учетные данные будут получать информацию о логине / пароле (например, хост, протокол, путь) или для
фактические учетные данные, которые необходимо получить (логин / пароль).

Учетные данные разделены на набор именованных атрибутов, по одному атрибуту в каждой строке. Каждый
Атрибут указывается парой "ключ-значение", разделенной знаком = (равно), за которым следует
новая линия. Ключ может содержать любые байты, кроме =, новой строки или NUL. Значение может содержать
любые байты, кроме новой строки или NUL. В обоих случаях все байты обрабатываются как есть (т.е.
не является кавычками, и нельзя передать значение с новой строкой или NUL в нем). Список
атрибуты завершаются пустой строкой или концом файла. Git понимает следующее
атрибуты:

протокол
Протокол, по которому будут использоваться учетные данные (например, https).

кашель
Имя удаленного хоста для сетевых учетных данных.

путь
Путь, с которым будут использоваться учетные данные. Например, для доступа к удаленному https
репозиторий, это будет путь к репозиторию на сервере.

username
Имя пользователя для учетных данных, если оно у нас уже есть (например, из URL-адреса, от пользователя или
от ранее запущенного помощника).

password
Пароль учетных данных, если мы просим его сохранить.

URL
Когда этот специальный атрибут считывается учетными данными git, значение анализируется как URL-адрес.
и обрабатывается так, как если бы его составные части были прочитаны (например, url = https: //example.com будет
вести себя так, как если бы были указаны протоколы protocol = https и host = example.com). Это может помочь
вызывающие абоненты сами избегают синтаксического анализа URL-адресов. Обратите внимание, что любые компоненты, отсутствующие в
URL-адрес (например, в приведенном выше примере нет имени пользователя) будет установлен пустым; если ты
хотите предоставить URL-адрес и переопределить некоторые атрибуты, сначала укажите атрибут URL-адреса,
с последующими переопределениями.

ПРИМЕЧАНИЯ

1. API учетных данных Git
файл: ///usr/share/doc/git/html/technical/api-credentials.html

Используйте git-credential в Интернете с помощью сервисов onworks.net