個人アクセストークンを使用する

個人アクセストークン（PAT）は、GitHub API またはコマンドラインを使用するときに GitHub への認証でパスワードの代わりに使用できます。

PAT を使用して、SAML SSO を使用する Organization が所有するリソースにアクセスする場合は、PAT を認証する必要があります。 詳しい情報については「SAMLシングルサインオンでの認証について」及び「SAMLシングルサインオンで利用する個人アクセストークンの認可」を参照してください。

As a security precaution, GitHub automatically removes personal access tokens that haven't been used in a year. To provide additional security, we highly recommend adding an expiration to your personal access tokens.

A token with no assigned scopes can only access public information. トークンを使用してコマンドラインからリポジトリにアクセスするには、[repo] を選択します。 For more information, see “Available scopes”.

トークンの作成

1. まだ検証していない場合はメールアドレスを検証します。

2. 任意のページの右上で、プロフィール画像をクリックし、続いてSettings（設定）をクリックしてください。

3. 左サイドバーで [Developer settings] をクリックします。

4. 左のサイドバーでPersonal access tokens（個人アクセストークン）をクリックしてください。

5. [Generate new token] をクリックします。

6. トークンにわかりやすい名前を付けます。

7. To give your token an expiration, select the Expiration drop-down menu, then click a default or use the calendar picker.

8. このトークンに付与するスコープ、すなわち権限を選択します。 トークンを使用してコマンドラインからリポジトリにアクセスするには、[repo] を選択します。

   

9. [Generate token] をクリックします。

   

   警告: トークンはパスワードのように扱い、秘密にしてください。 API を操作する場合は、トークンをプログラムにハードコーディングするのではなく、環境変数として使用してください。

10. SAML SSO を使用する Organization への認証にトークンを使用するには、Organization への SAML シングルサインオンに使用できるようトークンを認証します。

コマンドラインでトークンを使用する

トークンを入手したなら、HTTPS経由でGitの操作をする際にパスワードの代わりにそのトークンを入力できます。

たとえば、コマンドラインでは以下のように入力できます。

$ git clone https://github.com/username/repo.git
Username: your_username
Password: your_token

個人アクセストークンは HTTPS Git 操作だけにしか使用できません。 SSH リモート URL を使用するリポジトリの場合、リモートを SSH から HTTPS に切り替える必要があります。

ユーザ名とパスワードの入力を求められない場合、資格情報がコンピュータにキャッシュされている可能性があります。 古いパスワードをトークンに交換するようキーチェーンで資格情報を更新できます。

Instead of manually entering your PAT for every HTTPS Git operation, you can cache your PAT with a Git client. Git will temporarily store your credentials in memory until an expiry interval has passed. You can also store the token in a plain text file that Git can read before every request. 詳細は「Git に GitHub の認証情報をキャッシュする」を参照してください。

参考リンク

• "About authentication to GitHub"
• "Token expiration and revocation"