git-credential - クラウドでオンライン

プログラム：

NAME

git-credential - ユーザー資格情報を取得して保存する

SYNOPSIS

git資格情報

DESCRIPTION

Git には、システム固有の認証情報を保存および取得するための内部インターフェイスがあります。
ヘルパー、およびユーザー名とパスワードの入力を求めるプロンプト。 git クレデンシャル
コマンドは、このインターフェイスを、取得、保存、またはプロンプトを表示するスクリプトに公開します。
Git と同じ方法で認証情報を取得します。 このスクリプト可能なインターフェイスの設計は、
内部 C API; 見る 　 Gitの 資格 API[1] コンセプトの詳細については、[XNUMX] を参照してください。

git-credential は、コマンドラインで「アクション」オプションを取ります (fill、approve、または
reject) を実行し、stdin のクレデンシャルの説明を読み取ります (INPUT/OUTPUT FORMAT を参照)。

アクションが fill の場合、git-credential は「ユーザー名」と「パスワード」を追加しようとします。
構成ファイルを読み取り、構成済みのいずれかに連絡することにより、属性を説明に追加します
資格情報ヘルパー、またはユーザーにプロンプ​​トを表示することによって。 のユーザー名とパスワードの属性
クレデンシャルの説明は、すでに属性とともに stdout に出力されます


アクションが承認の場合、git-credential は説明を構成済みのすべてのサーバーに送信します。
資格情報ヘルパー。後で使用するために資格情報を保存できます。

アクションが拒否の場合、git-credential は説明を構成済みのすべてのサーバーに送信します。
クレデンシャル ヘルパー。これは、説明に一致する保存されたクレデンシャルを消去する可能性があります。

アクションが承認または拒否の場合、出力は発行されません。

典型的な USE OF GIT クレデンシャル

git-credential を使用するアプリケーションは通常、これらに続いて git credential を使用します。
手順：

1. コンテキストに基づいてクレデンシャルの説明を生成します。

たとえば、https://example.com/foo.git のパスワードが必要な場合は、
次のクレデンシャルの説明 (最後の空白行を忘れないでください。
アプリケーションが持っているすべての情報のフィードを終了したことを示す git 資格情報):

プロトコル=https
ホスト=example.com
パス=foo.git

2. git-credential に依頼して、この説明のユーザー名とパスワードを提供してもらいます。 これは
git credential fill を実行し、手順 (1) の説明を
標準入力。 完全なクレデンシャルの説明 (クレデンシャル自体、
つまり、ログインとパスワード) は、次のように標準出力に生成されます。

プロトコル=https
ホスト=example.com
ユーザー名=ボブ
パスワード=secr3t

ほとんどの場合、これは、入力で指定された属性が
出力されますが、Git は資格情報の説明を変更することもできます。
プロトコルが HTTP(s) で、credential.useHttpPath が false の場合の path 属性。

git クレデンシャルがパスワードを知っていた場合、この手順では、
ユーザーが実際にこのパスワードを入力します (ユーザーはパスワードを入力してロックを解除した可能性があります)。
代わりにキーチェーンを使用するか、キーチェーンが既に使用されている場合はユーザーの操作は行われませんでした
ロックされていない) password=secr3t を返す前に。

3. 資格情報を使用します (例: ステップのユーザー名とパスワードを使用して URL にアクセスします)。
(2))、それが受け入れられるかどうかを確認します。

4. パスワードの成功または失敗を報告します。 クレデンシャルが
操作が正常に完了すると、「承認」アクションでマークして、
次の呼び出しで再利用するように git credential に指示します。 クレデンシャルが拒否された場合
操作中に「拒否」アクションを使用して、git 資格情報が要求するようにします。
次の呼び出しで新しいパスワード。 いずれの場合も、git 資格情報を提供する必要があります
手順 (2) から取得した資格情報の説明 (これには、
手順 (1) で提供されます)。

入出力 FORMAT

git credential 読み取りおよび/または書き込み (使用するアクションに応じて) 資格情報
その標準入出力で。 この情報は、git のいずれかのキーに対応できます。
クレデンシャルは、ログイン/パスワード情報 (ホスト、プロトコル、パスなど) を取得するか、
取得する実際の資格情報データ (ログイン/パスワード)。

クレデンシャルは、XNUMX 行に XNUMX つの属性を持つ、一連の名前付き属性に分割されます。 各
属性はキーと値のペアで指定され、= (等号) 記号で区切られ、その後に
改行。 キーには、=、改行、または NUL 以外の任意のバイトを含めることができます。 値には以下が含まれる場合があります
改行または NUL を除くすべてのバイト。 どちらの場合も、すべてのバイトがそのまま扱われます (つまり、
は引用符ではなく、改行または NUL を含む値を送信することはできません)。 のリスト
attributes は、空白行またはファイルの終わりで終了します。 Gitは次のことを理解しています
属性：


クレデンシャルが使用されるプロトコル (https など)。

host
ネットワーク資格情報のリモート ホスト名。

path
資格情報が使用されるパス。 たとえば、リモートの https にアクセスする場合
これは、サーバー上のリポジトリのパスになります。

ユーザ名
クレデンシャルのユーザー名 (既にある場合) (たとえば、URL から、ユーザーから、または
以前に実行したヘルパーから)。

password
クレデンシャルのパスワード (保存するように要求している場合)。

URL
この特別な属性が git credential によって読み取られると、値は URL として解析されます
その構成部分が読み取られたかのように扱われます (たとえば、url=https://example.com は
protocol=https および host=example.com が指定されているかのように動作します)。 これは役に立ちます
呼び出し元は、URL 自体を解析することを避けます。 から欠落しているコンポーネントに注意してください。
URL (たとえば、上記の例にはユーザー名がありません) は空に設定されます。 もし、あんたが
URL を提供し、いくつかの属性をオーバーライドしたい場合、最初に URL 属性を提供します。
その後に任意のオーバーライドが続きます。

注意事項

1. Git 認証情報 API
file:///usr/share/doc/git/html/technical/api-credentials.html

onworks.net サービスを使用してオンラインで git-credential を使用する