git-credential - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

git-credential - Truy xuất và lưu trữ thông tin đăng nhập của người dùng

SYNOPSIS

thông tin xác thực git

MÔ TẢ

Git có giao diện nội bộ để lưu trữ và truy xuất thông tin xác thực từ hệ thống cụ thể
người trợ giúp, cũng như nhắc người dùng nhập tên người dùng và mật khẩu. Thông tin xác thực git
lệnh hiển thị giao diện này với các tập lệnh có thể muốn truy xuất, lưu trữ hoặc nhắc nhở
thông tin đăng nhập theo cách tương tự như Git. Thiết kế của giao diện có thể tập lệnh này mô hình hóa
API C nội bộ; Thấy chưa các đi chứng chỉ API[1] để biết thêm thông tin cơ bản về các khái niệm.

git-credential có một tùy chọn "hành động" trên dòng lệnh (một trong số điền, phê duyệt hoặc
từ chối) và đọc mô tả thông tin xác thực trên stdin (xem ĐỊNH DẠNG ĐẦU VÀO / ĐẦU RA).

Nếu hành động được thực hiện, git-credential sẽ cố gắng thêm "tên người dùng" và "mật khẩu"
thuộc tính cho mô tả bằng cách đọc các tệp cấu hình, bằng cách liên hệ với bất kỳ
người trợ giúp thông tin xác thực hoặc bằng cách nhắc người dùng. Thuộc tính tên người dùng và mật khẩu của
mô tả thông tin xác thực sau đó được in ra stdout cùng với các thuộc tính đã có
được cung cấp.

Nếu hành động được chấp thuận, git-credential sẽ gửi mô tả đến bất kỳ
trình trợ giúp thông tin xác thực, có thể lưu trữ thông tin đăng nhập để sử dụng sau này.

Nếu hành động bị từ chối, git-credential sẽ gửi mô tả đến bất kỳ hành động nào được định cấu hình
trình trợ giúp thông tin xác thực, có thể xóa mọi thông tin xác thực được lưu trữ khớp với mô tả.

Nếu hành động được chấp thuận hoặc từ chối, không có đầu ra nào được phát ra.

ĐIỂN HÌNH SỬ DỤNG OF GIT CHỨNG CHỈ

Một ứng dụng sử dụng git-credential thường sẽ sử dụng thông tin đăng nhập git sau đây
các bước:

1. Tạo mô tả thông tin xác thực dựa trên ngữ cảnh.

Ví dụ: nếu chúng tôi muốn mật khẩu cho https://example.com/foo.git, chúng tôi có thể tạo
mô tả thông tin xác thực sau (đừng quên dòng trống ở cuối; nó cho biết
git thông tin xác thực rằng ứng dụng đã hoàn tất việc cung cấp tất cả thông tin mà nó có):

giao thức = https
host = example.com
path = foo.git

2. Yêu cầu git-credential cung cấp cho chúng tôi tên người dùng và mật khẩu cho mô tả này. Đây là
được thực hiện bằng cách chạy điền thông tin xác thực git, cung cấp mô tả từ bước (1) đến
đầu vào chuẩn. Mô tả đầy đủ thông tin xác thực (bao gồm cả thông tin xác thực cho mỗi người,
tức là thông tin đăng nhập và mật khẩu) sẽ được tạo trên đầu ra tiêu chuẩn, như:

giao thức = https
host = example.com
tên người dùng = bob
password = secr3t

Trong hầu hết các trường hợp, điều này có nghĩa là các thuộc tính được cung cấp trong đầu vào sẽ được lặp lại trong
đầu ra, nhưng Git cũng có thể sửa đổi mô tả thông tin xác thực, chẳng hạn như bằng cách xóa
thuộc tính đường dẫn khi giao thức là HTTP (các) và thông tin đăng nhập.useHttpPath là sai.

Nếu thông tin xác thực git biết về mật khẩu, bước này có thể không liên quan đến
người dùng thực sự nhập mật khẩu này (người dùng có thể đã nhập mật khẩu để mở khóa
keychain thay vào đó hoặc không có tương tác người dùng nào được thực hiện nếu keychain đã
đã mở khóa) trước khi nó trả về mật khẩu = secr3t.

3. Sử dụng thông tin đăng nhập (ví dụ: truy cập URL bằng tên người dùng và mật khẩu từ bước
(2)), và xem nó có được chấp nhận hay không.

4. Báo cáo về sự thành công hay thất bại của mật khẩu. Nếu thông tin xác thực cho phép
hoạt động hoàn tất thành công, sau đó nó có thể được đánh dấu bằng hành động "phê duyệt" để
cho biết thông tin xác thực git để sử dụng lại nó trong lần gọi tiếp theo. Nếu thông tin đăng nhập bị từ chối
trong quá trình hoạt động, hãy sử dụng hành động "từ chối" để thông tin xác thực git sẽ yêu cầu
mật khẩu mới trong lần gọi tiếp theo. Trong cả hai trường hợp, thông tin xác thực git phải được cung cấp bằng
mô tả thông tin xác thực có được từ bước (2) (cũng chứa những
được cung cấp trong bước (1)).

ĐẦU RA ĐẦU VÀO FORMAT

thông tin xác thực git đọc và / hoặc ghi (tùy thuộc vào hành động được sử dụng) thông tin xác thực
trong đầu vào / đầu ra tiêu chuẩn của nó. Thông tin này có thể tương ứng với các khóa mà git
thông tin đăng nhập sẽ lấy thông tin đăng nhập / mật khẩu (ví dụ: máy chủ, giao thức, đường dẫn) hoặc
dữ liệu thông tin xác thực thực tế cần lấy (đăng nhập / mật khẩu).

Thông tin đăng nhập được chia thành một tập hợp các thuộc tính được đặt tên, với một thuộc tính trên mỗi dòng. Mỗi
thuộc tính được chỉ định bởi một cặp khóa-giá trị, phân tách bằng dấu = (bằng), theo sau là
dòng mới. Khóa có thể chứa bất kỳ byte nào ngoại trừ =, dòng mới hoặc NUL. Giá trị có thể chứa
bất kỳ byte nào ngoại trừ dòng mới hoặc NUL. Trong cả hai trường hợp, tất cả các byte đều được coi là nguyên trạng (tức là
không phải là trích dẫn và người ta không thể truyền một giá trị với dòng mới hoặc NUL trong đó). Danh sách của
thuộc tính được kết thúc bằng một dòng trống hoặc cuối tệp. Git hiểu những điều sau
thuộc tính:

giao thức
Giao thức mà thông tin xác thực sẽ được sử dụng (ví dụ: https).

chủ nhà
Tên máy chủ từ xa cho thông tin xác thực mạng.

con đường
Đường dẫn mà thông tin đăng nhập sẽ được sử dụng. Ví dụ: để truy cập https từ xa
kho lưu trữ, đây sẽ là đường dẫn của kho lưu trữ trên máy chủ.

tên truy nhập
Tên người dùng của thông tin xác thực, nếu chúng tôi đã có (ví dụ: từ URL, từ người dùng hoặc
từ một người trợ giúp đã chạy trước đó).

mật khẩu
Mật khẩu của thông tin xác thực, nếu chúng tôi yêu cầu nó được lưu trữ.

url
Khi thuộc tính đặc biệt này được đọc bằng thông tin xác thực git, giá trị được phân tích cú pháp thành một URL
và được xử lý như thể các phần cấu thành của nó đã được đọc (ví dụ: url = https: //example.com sẽ
hoạt động như thể giao thức = https và host = example.com đã được cung cấp). Điều này có thể giúp
người gọi tránh tự phân tích cú pháp URL. Lưu ý rằng bất kỳ thành phần nào bị thiếu
URL (ví dụ: không có tên người dùng trong ví dụ trên) sẽ được đặt thành trống; nếu bạn
muốn cung cấp URL và ghi đè một số thuộc tính, hãy cung cấp thuộc tính URL trước,
tiếp theo là bất kỳ ghi đè nào.

GHI CHÚ

1. API thông tin xác thực Git
tệp: ///usr/share/doc/git/html/technical/api-credentials.html

Sử dụng git-credential trực tuyến bằng các dịch vụ onworks.net