====== GitHub 環境構築 ======
--- //[[http://www.y2sunlight.com|y2sunlight]] 2020-06-17//
[[github:top|GitHub に戻る]]
本章は、GitHubを利用するにあたって最初に行うべき内容を掲載します。Gitクライアントの導入とGitHubへの登録について述べ、最後にGitアカウントの２要素認証について説明します。
関連記事
* GitHub 環境構築
* [[github:email|GitHub メールの設定]]
* [[github:profile|GitHub プロフィールの設定]]
* [[github:basic|GitHub Eclipseによるリポジトリの基本操作]]
* [[github:branch|GitHub Eclipseによるブランチの操作]]
* [[github:release|GitHub タグとリリースの作成]]
* [[github:collaborator|GitHub コラボレータの招待]]
* [[github:publish|GitHub ソースコードの公開]]
リンク
* https://github.com/ --- GitHubの本家
* [[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication|2要素認証を設定する]] --- GitHubヘルプより
----
===== Gitクライアントの導入 =====
WindowsのGitクライアントは[[git2:client:windows|いろいろ]]ありますが、本編では Eclipse からの使用になるので、主にEclipseの ''EGit'' プラグインを使います。EGitのインストールと基本操作については、本編の「[[git2:client:windows:eclipse|Eclipse EGit プラグイン]]」を参照して下さい。また、Windows用の[[git2:client:windows:git-for-windows|Git Bash]]もインストールしておく事をお薦めします。
GitHubでは、より簡単にGitHubを使用できる試みとして [[https://desktop.github.com/|GitHub Desktop]] というデスクトップ用のアプリケーションを提供しています（Windows版とMac版があります）。GitHub Desktop はIDEから完全に独立したクライアントツールです。これについてはまたの機会に掲載したいと思っています。
\\
===== GitHubの登録 =====
GitHibのサイト( https://github.com/ ) にアクセスします。
[{{:github:basic:github-basic01.png?nolink|}}]
■ Username、Email、Password を入力して[Sign up for GitHub]ボタンを押します。
> GitHubでオープンソース用のパブリックリポジトリを作る場合、Username(ユーザ名)は特に大切です。ユーザ名は、公開リポジトリのURLやプロフィールページに使用されるので、変更の影響が大きく良く考えて設定することをお薦めします。
[{{:github:basic:github-basic02.png?nolink|}}]
■ [検証開始]ボタンを押してクイズに答えて下さい（これはロボット除けです）。\\
■ 筆者がGitHubに登録した時は以下のようなクイズが出題されました。\\
[{{:github:basic:github-basic03.png?nolink&250|}}]
[{{:github:basic:github-basic04.png?nolink&250|}}]
■ クイズに正解したら [Join a free plan]ボタンを押して下さい。\\
■ 尚、[Email perferences] で [Send me occasional product updates, announcements, and offers] をチェックすると、アップデート情報などのいろいろなアナウンスがメールで送られてきます。必要に応じて選択して下さい。
[{{:github:basic:github-basic05.png?nolink|}}]
■ 幾つかのアンケートに答えます。\\
* What kind of work do you do, mainly?（主にどんな仕事をしてますか?）
* How much programming experience do you have?（プログラミング経験はどのくらい?）
* What do you plan to use GitHub for?（GitHubの使用目的は?）
* I am interested in:（興味あることは?）
■ [Complete setup]ボタンを押します。
[{{:github:basic:github-basic06.png?nolink|}}]
■ この画面が出たら、GitHubからのメールを確認します。
登録したメールアドレスにGitHubからメール認証の為の以下のようなメールが届いています。
[{{:github:basic:github-basic07.png?nolink|}}]
■ [Verify email address] を押します。
[{{:github:basic:github-basic08.png?nolink|}}]
■ メール認証が終わると登録は完了です。\\
■ [Skip this for now]を押します。
[{{:github:basic:github-basic09.png?nolink|}}]
■ GitHubのダッシュボードが表示されます。これでGitHubが利用できます。
\\
===== ２要素認証 =====
GitHubに２要素認証の設定を行います。２要素認証は強力にログインを保護してくれますが、アカウントをロックしてログイン出来なくなる可能性もあるので、丁寧に設定する必要があります。ここでは、基本的にアプリ認証を使用し、フォールバックとしてSMS認証の設定も行っておきます。２要素認証に関する詳細は、以下のURLを参照して下さい。
* [[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication|2要素認証を設定する]] --- GitHubヘルプ
アプリ認証では、時間ベースのワンタイムパスワード(TOTP)アプリを、自分の使っているスマホにダウンロードします。GitHubヘルプでは以下のクラウドベースのTOTPアプリが推奨されています。
* [[https://support.1password.com/one-time-passwords/|1Password]]
* [[https://authy.com/guides/github/|Authy]]
* [[https://lastpass.com/auth/|LastPass Authenticator]]
ここでは、Authy (オウシー)を使用します。
\\
==== Authy のインストール ====
以下は iPhoneの例です。
AppStore で Authy をインストールし起動します。
[{{:github:basic:authy01.png?nolink|}}]
■ 国番号(日本は ''+81'')と携帯の電話番号を入力して[OK]ボタンを押します。
[{{:github:basic:authy02.png?nolink|}}]
■ メールアドレスを入力して[OK]ボタンを押します。
[{{:github:basic:authy03.png?nolink|}}]
■ アカウント認証の方法（通話かSMS）を選択します。ここではSMSを選択した例を示します。\\
■ SMSに以下のようなメッセージが届きます。
Authy registration: click __authy://regsiter/81-{電話番号}/{6桁の認証コード}__ or manually enter: {6桁の認証コード}
■ 指示に従ってアカウント認証を終了して下さい。
[{{:github:basic:authy06.png?nolink|}}]
■ アカウント認証が終了し、この画面になると準備完了です。
\\
==== アプリ認証の設定 ====
GitHubサイトにログインして、画面右上の[アイコン]メニューから[Settings]を選択します。[Personal settings]の中から[Security]を選択します。
[{{:github:basic:github-basic10.png?nolink|}}]
■ 画面下の [Enable two-factor authentication]を押して下さい。\\
■ 途中でパスワードの要求されたら、その時は指示に従って下さい。
[{{:github:basic:github-basic11.png?nolink|}}]
■ [Set up using an app] を押して、アプリによる２要素認証を選択します。
[{{:github:basic:github-basic12.png?nolink|}}]
■ リカバリコードが表示されるので、これを保存して置きます。
* [Download] --- リカバリコードをダウンロードします
* [Print] --- リカバリコードを印刷します
* [Copy] --- パスワードマネージャーに保存します
> リカバリコードは、２要素認証の為に、アカウントにアクセスできなくなった場合に使用します。必ず安全な場所に保存しておいて下さい。
■ リカバリコードを保存したら[Next]を押します。
[{{:github:basic:github-basic13.png?nolink|}}]
■ ここに表示されているQRコードをスマホアプリ( Authy )でスキャンし、アプリが表示する6桁の数字を[Enter the six-digit code from the application]のテキストボックスに入力します。その手順を以下の示します。
=== Authy に GitHubのアカウントを追加する ===
スマホで Authy を起動します（以下はiPhoneの例です）。
[{{:github:basic:authy06.png?nolink|}}]
■ 画面中央の[+]ボタンを押します。
[{{:github:basic:authy07.png?nolink|}}]
■ [Scan QR Code]ボタンを押します。\\
■ GitHubのQRコードを読み取ります。
[{{:github:basic:authy08.png?nolink|}}]
■ 登録したアカウントのバックアップ用のパスワードを入力します。\\
■ [Enable Backups]を押します。
[{{:github:basic:authy09.png?nolink|}}]
■ 登録するGitHubアカウントのニックネームが表示されるので、必要に応じて変更して下さい。\\
■ [Save]を押します。
[{{:github:basic:authy10.png?nolink|}}]
■ ワンタイムトークンが表示されます（30秒毎に更新されます）。\\
■ このトークンをGitHubの２要素認証で使用します。
> ２要素認証方法は、モバイルアプリによるアプリ認証 と テキストメッセージによるSMS認証の何れかを１つを選択します。認証方法の構成を変えるとこれまでに設定した内容が変更されるので注意して下さい。セキュリティキーによる認証は認証方法を追加するものです（詳しくは、GitHubヘルプの[[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key|セキュリティキーを使って 2 要素認証を設定する]]を参照して下さい）。
* リカバリーオプション
* [Recovery codes] --- リカバリーコードの表示を行います
* [Fallback SMS number] --- フォールバックSMS認証の設定を行います（[[#フォールバックの設定（SMS認証）|後述]]）
* [Recovery tokens] --- Facebookにリカバリートークンを保存することができます
\\
==== フォールバックの設定（SMS番号）====
GitHubのアカウントがロックされたときの保険を掛けておくことは重要です。最低限の準備としてリカバリーコードは大切に保存しておくとして、２つ目の方法も準備しておきましょう。この方法としては以下のものが考えられます：
* フォールバックとして[[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods#setting-a-fallback-authentication-number|SMS番号]]を設定する。
* [[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication-recovery-methods#adding-a-fallback-authentication-method-with-recover-accounts-elsewhere|リカバリートークン]]をFacebookに保存する。
* [[https://help.github.com/ja/github/authenticating-to-github/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key|セキュリティーキー]]を追加して２要素認証方法として設定する。
ここでは、フォールバックとして SMS番号を設定する方法を説明します。
GitHubサイトにログインして、画面右上の[アイコン]メニューから[Settings]を選択します。[Personal settings]の中から[Security]を選択します。
[{{:github:basic:github-basic16.png?nolink|}}]
■ [Recovery options]の[Fallback SMS number]の横にある[Add]ボタンを押します。
[{{:github:basic:github-basic17.png?nolink|}}]
■ [Fallback SMS number]の[Add fallback SMS number]を押します。
[{{:github:basic:github-basic18.png?nolink|}}]
■ 国コード(+81) と 携帯電話番号を入力します。\\
■ [Set fallback]ボタンを押します。
■ 以下のようなメッセージがSMSが送られてきます。
__{6桁の認証コード}__ is your GitHub SMS fallback setup code.
[{{:github:basic:github-basic19.png?nolink|}}]
■ SMSで届いた 6桁の認証コード を入力して[Verify]ボタンを押します。
[{{:github:basic:github-basic20.png?nolink|}}]
■ 認証が成功するとこの画面がでます。\\
■ [Fallback SMS number]に認証された携帯電話番号が表示されています。
\\
===== サインイン =====
２要素認証の設定ができたので、ここで一度、サインアウトしてから再ログインしてみましょう。
[{{:github:basic:github-basic21.png?nolink|}}]
■ 画面右上の[Sign in]ボタンを押します。
[{{:github:basic:github-basic22.png?nolink|}}]
■ ユーザ名、パスワードを入力して、[Sign in]ボタンを押します。
[{{:github:basic:github-basic23.png?nolink|}}]
■ ２要素認証画面が出るので、スマホアプリ( Authy )を起動します。
[{{:github:basic:authy11.png?nolink|}}]