git-credential-cache(1)

SYNOPSIS

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

DESCRIPTION

このコマンドは、それ以降の Git プログラムで使用できるように資格情報をキャッシュします。保存された資格情報は(ファイルに書き込まれる代わりに、)キャッシュ・デーモン・プロセスのメモリに保持され、構成可能なタイムアウトが経過すると忘れ去られます。キャッシュ・デーモンが終了(die)した場合、たとえばシステムが再起動した場合、資格情報はより早く忘れ去られます。キャッシュはUnixドメインソケットを介してアクセスでき、ファイルシステムのアクセス許可により現在のユーザーに制限されます。

あなたはこのコマンドを直接呼び出すことは無いでしょう。これは、Gitの他の部分で認証情報ヘルパーとして使用されることを目的としています。gitcredentials(7) または以下の EXAMPLES を参照してください。

OPTIONS

--timeout <seconds>: 認証情報をキャッシュする秒数(デフォルト: 900)。
--socket <path>: <path> を使用して、実行中のキャッシュデーモンに接続します(または、新しいキャッシュデーモンが開始されていない場合は開始します)。デフォルトは $XDG_CACHE_HOME/git/credential/socket です(~/.git-credential-cache/ が存在しない限り)。 ~/.git-credential-cache/ が存在する場合は、代わりに ~/.git-credential-cache/ が使用されます。あなたのホームディレクトリがネットワークにマウントされたファイルシステム上にある場合は、これをローカルファイルシステムに変更する必要がある場合があります。あなたは絶対パスを指定しなければなりません。

CONTROLLING THE DAEMON

あなたがデーモンを早期に終了させ、タイムアウトする前にキャッシュされたすべての認証情報を忘れ去りたい場合は、「exit」アクションを発行できます:

git credential-cache exit

EXAMPLES

このヘルパーの肝は、ユーザー名またはパスワードを入力する必要がある回数を減らすことです。例えば:

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

[work for 5 more minutes]
$ git push http://example.com/repo.git
[your credentials are used automatically]

credential.helper 構成変数を介してオプションを提供できます(以下の例では、キャッシュ時間を 1 時間に増やします):

$ git config credential.helper 'cache --timeout=3600'

PERSONAL ACCESS TOKENS

一部のリモートは、ランダムに生成される覚えにくいパーソナルアクセストークン(personal access tokens)を受け付けます。これらは通常、数週間から数か月の有効期限を持っています。

git-credential-cache は、パーソナルアクセストークンを永続的に保存する用途には本質的に不向きです。キャッシュのタイムアウト後に資格情報(認証情報)は忘れられてしまいます。たとえ長いタイムアウトを設定しても、デーモンが停止すると資格情報は忘れられます。

パーソナルアクセストークンを頻繁に再生成しなくて済むようにするには、永続ストレージを備えた credential helper (認証情報ヘルパー)を設定してください。あるいは、OAuth の credential helper を設定して、認証情報を自動生成するようにすることもできます。 gitcredentials(7) の「Available helpers」および「OAuth」セクションを参照してください。

GIT

Part of the git(1) suite

git-credential-cache(1) Manual Page