Git
English ▾ トピック ▾ 最新バージョン ▾ git-credential-store は 2.43.0 で最後に更新されました

名前

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

概要

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

説明

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

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

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

オプション

--file=<path>

認証情報の検索と保存に<path>を使用します。ファイルのファイルシステムアクセス権限は、システム上の他のユーザーが読み取れないように設定されますが、暗号化またはその他の保護はされません。指定しない場合、認証情報は~/.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