日本語 ▾ トピック ▾ 最新バージョン ▾ git-credential-store は 2.43.0 で最終更新されました

名前

git-credential-store - ディスクに認証情報を保存するヘルパー

書式

git config credential.helper 'store [<options>]'

説明

注記
 このヘルパーを使用すると、パスワードがディスクに暗号化されずに保存され、ファイルシステムパーミッションによってのみ保護されます。これが許容できるセキュリティ上のトレードオフでない場合、git-credential-cache[1] を試すか、オペレーティングシステムが提供するセキュアなストレージと統合するヘルパーを見つけてください。

このコマンドは、将来のGitプログラムで使用するために、認証情報をディスクに無期限に保存します。

このコマンドを直接呼び出すことはおそらく望ましくありません。これはGitの他の部分によって認証ヘルパーとして使用されることを意図しています。gitcredentials[7] または以下の例を参照してください。

オプション

--file=<パス>

<パス>を使用して認証情報を検索および保存します。ファイルは、システム上の他のユーザーが読み取れないようにファイルシステムパーミッションが設定されますが、暗号化されたり、その他の方法で保護されたりすることはありません。指定されていない場合、認証情報は~/.git-credentialsおよび$XDG_CONFIG_HOME/git/credentialsから検索され、~/.git-credentialsが存在する場合はそこに、存在せず$XDG_CONFIG_HOME/git/credentialsが存在する場合はそこに書き込まれます。詳細については、ファイルも参照してください。

ファイル

--fileで明示的に設定されていない場合、git-credential-storeは以下の優先順位で認証情報を検索する2つのファイルがあります。

~/.git-credentials

ユーザー固有の認証情報ファイル。

$XDG_CONFIG_HOME/git/credentials

2番目のユーザー固有の認証情報ファイル。_XDG_CONFIG_HOME_が設定されていないか空の場合、$HOME/.config/git/credentialsが使用されます。~/.git-credentialsにも一致する認証情報がある場合、このファイルに保存された認証情報は使用されません。このファイルをサポートしない古いバージョンのGitを時々使用する場合は、このファイルを作成しないことをお勧めします。

認証情報の検索では、ファイルは上記の順序で読み取られ、最初に見つかった一致する認証情報が、リストの下の方にあるファイルで見つかった認証情報よりも優先されます。

認証情報の保存は、デフォルトでリスト内の最初に存在するファイルに書き込まれます。これらのファイルのいずれも存在しない場合、~/.git-credentialsが作成され、そこに書き込まれます。

認証情報を消去する際、一致する認証情報はすべてのファイルから消去されます。

例

このヘルパーの目的は、ユーザー名やパスワードを入力する回数を減らすことです。例えば

$ git config credential.helper store
$ git push http://example.com/repo.git
Username: <type your username>
Password: <type your password>

[several days later]
$ git push http://example.com/repo.git
[your credentials are used automatically]

保存形式

.git-credentialsファイルはプレーンテキストで保存されます。各認証情報は、以下のようなURLとして独自の行に保存されます。

https://user:pass@example.com

他の種類の行（例：空行やコメント行）はファイル内で許可されていません。一部は黙って無視されることがありますが、エディタでこのファイルを表示したり編集したりしないでください。

Gitが特定のURLコンテキストで認証を必要とする場合、credential-storeはそのコンテキストを認証情報ファイル内の各エントリと照合するパターンとみなします。プロトコル、ホスト名、およびユーザー名（すでに存在する場合）が一致した場合、パスワードがGitに返されます。詳細については、gitcredentials[7]の設定に関する議論を参照してください。

GIT

git[1] スイートの一部

scroll-to-top