Skip to content
This repository was archived by the owner on Sep 1, 2022. It is now read-only.

Commit 3fa0bbb

Browse files
author
Alejandra Trejo
committed
add japanese responses
1 parent 82331b0 commit 3fa0bbb

17 files changed

Lines changed: 225 additions & 0 deletions
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
## :tada: 安全なワークフローのコースへようこそ!
2+
3+
このコースでは、GitHub上でリポジトリを安全に保つ方法を学ぶことが出来ます。リポジトリを安全に保つことは多くの理由で重要です。
4+
- 機密データを誤って公開してしまうことを防ぐ
5+
- 安全な開発のベストプラクティスを必須とする
6+
- 意図しないアクセス権を付与してしまうことを防ぐ
7+
8+
このコースでは、下記の内容を学びます:
9+
10+
- プライベートリポジトリでの脆弱性アラートを有効化する
11+
- _注記:これらのセキュリティの設定はフォークではないパブリックリポジトリではデフォルトで有効化されています。_
12+
- 脆弱性アラートによって通知された脆弱な依存関係を検出し、修正する
13+
- `.gitignore`ファイルを使うことで機密データを保護するというベストプラクティスのやり方
14+
15+
### GitHubを使うのは初めてですか?
16+
17+
このコースでは、GitHub Flowに事前に習熟している必要があります。GitHub Flowをご存じない方は、[Introduction to GitHubコース]({{ host}}/courses/introduction-to-github)を御覧ください。
18+
19+
## ステップ1:GitHub Pages上のプロジェクト
20+
21+
このコースではGitHub Pagesにデプロイされた記憶ゲームを題材に使用します。
22+
23+
{% if private %}
24+
25+
### :keyboard: やってみよう:脆弱性アラートとGitHub Pagesの有効化
26+
27+
28+
1. リポジトリの[**Settings**]({{ repoUrl }}/settings)タブをクリック
29+
1. **Data services**のセクションまで画面をスクロール
30+
1. **Data services**セクションにて、全てのデータサービスにチェックを入れて有効化
31+
1. **GitHub Pages**のセクションまで画面をスクロールし、**Source**として`master`を選択し、**Save**をクリック
32+
33+
{% else %}
34+
35+
### :keyboard: やってみよう:GitHub Pagesの有効化
36+
37+
38+
1. リポジトリの[**Settings**]({{ repoUrl }}/settings)タブをクリック
39+
1. **GitHub Pages**のセクションまで画面をスクロールし、**Source**として`master`を選択し、**Save**をクリック
40+
41+
{% endif %}
42+
43+
このコースの手順は[Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf)にもまとまっています。
44+
45+
> GitHub Pagesを有効化すると、リポジトリの内容をデプロイします。デプロイが完了するまで待つ必要があるので、次のコメントまで1分ほどお待ち下さい。
46+
47+
<hr>
48+
<h3 align="center">設定が完了したら、次のコメントをこのイシューに書きます。</h3>
49+
50+
> _時々、追加のコメントが書き込まれないことがあります!正しい操作をしたにも関わらず何のコメントも書き込まれない場合は、数秒待ってからこのペ
51+
ージを再読込してください。_

responses/ja/02_closed-issue.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
よく出来ました。ここまでの手順を完了したでしょうか?設定が正しく行われていれば、[GitHub Pages上に記憶ゲーム]({{ pages }})が公開されているはずです。
2+
3+
<hr>
4+
<h3 align="center"><a href="{{ url }}">次のイシューを作成しました。</a>そちらに次の手順を書いています。</h3>
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
## 脆弱な依存関係を見つける
2+
3+
セキュリティの脆弱性によって、プロジェクトやそのプロジェクトを使っている人に様々な問題を引き起こします。脆弱性によってプロジェクトの機密性、完全性、可用性が損なわれる可能性があります。あなたのプロジェクトのコード自体には脆弱性がなかったとしても、プロジェクトの依存関係の中に脆弱性があるかもしれないのです。そのため、常に最新のバージョンを使用することが、プロジェクトを安全に保つ上で大切です。
4+
5+
このリポジトリの依存関係には、セキュアに保つためにアップデートが必要なものがいくつかあります。
6+
7+
### 依存関係を特定し、それらが脆弱かどうかをどうやって把握するか?
8+
9+
このリポジトリはNPMを使ったNode.jsのプロジェクトです。そのため、`package.json`ファイルにリポジトリの依存関係が定義されています。今回はこのJavaScriptの依存関係を扱います。他のプログラミング言語では他の依存関係を定義したファイルがあります。実際のプロジェクトでは、`Gemfile``Gemfile.lock``*.gemspec``requirements.txt``pipfile.lock`といったファイルを使っているかもしれません。
10+
11+
これらの依存関係が安全であるとどのように確かめるのが良いでしょうか?それは簡単なことではありませんが、GitHubであればこの問題を解決することが出来ます。
12+
13+
### 脆弱な依存関係に対するGitHubのセキュリティアラート
14+
15+
このリポジトリに対してGitHubから警告が来ている事にお気づきかもしれません。メールで通知を受け取っているかもしれませんし、もしくは`package.json`ファイルに黄色のバーが表示されているのを見つけたかもしれません。
16+
17+
![依存関係の脆弱性アラート](https://user-images.githubusercontent.com/9906718/46882979-c275b680-ce50-11e8-9f47-2081daf20b98.png)
18+
19+
GitHubは公になっているRuby gems、NPM、Python、Java、.NETのパッケージの脆弱性情報を追跡しています。
20+
21+
GitHubは新しく公開された脆弱性の通知を受け取り、その依存関係の脆弱性が含まれているバージョンを使っているリポジトリを探します。そして、その影響のあるリポジトリに関連する方々にセキュリティアラートを送信します。リポジトリのオーナーに対してはデフォルトで通知が送られます。しかし、この重要な通知を他のチームやメンバーが受け取るように設定することも可能です。
22+
23+
**GitHubはどのようなリポジトリにおいても、そのリポジトリにおける脆弱性の情報を公開することは致しません。**
24+
25+
## ステップ2:このリポジトリの脆弱な依存関係を見つけよう
26+
27+
GitHubのセキュリティアラートを使って、脆弱なNPMの依存関係を見つけてみましょう。
28+
29+
### :keyboard: やってみよう:バージョンアップの提案を見つけよう
30+
31+
1. リポジトリの**Insights**タブをクリック
32+
2. 画面左のナビゲーションバーから**Dependency graph**をクリック
33+
3. 黄色くハイライトされた`debug`という名前の依存関係までスクロールダウンし、黄色の`debug`の右側をクリック
34+
4. 提示されているバージョンを確認
35+
5. このイシューに提示されているバージョンをコメントで記載
36+
37+
38+
> _**GitHub Enterprise Serverのみ:** GitHub Enterprise ServerではGitHub Connectを使うことで脆弱性アラートを使うことが出来ます。アラートが投げられるまでは1時間ほどかかることがあります。一定時間以上待ってもDependency Graphに黄色のバーが表示されない場合は、管理者に確認してみてください。問題が解決するまでの間、コースを進めるためにヒントを差し上げましょう - 推奨されたアップグレードバージョンは `2.6.9`です。_
39+
40+
このコースの手順は[Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf)にもまとまっています。
41+
42+
<hr>
43+
<h3 align="center">完了したら、次のコメントをこのイシューに書きます。</h3>
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
@{{ user.username }}、どうやら誤ってこのイシューをクローズしてしまったようです。このアクティビティを完了するには、与えられた手順に従って操作を行ってください。再度イシューをオープンします。
2+
3+
もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
@{{ user.username }}、なにかが間違っているようです。期待した結果と異なります。再度手順を確認し、その手順に従っているかどうかを確かめてください。
2+
3+
もしこれがプルリクエストなのであれば、ファイルを更に変更することも出来ます。何度も試してみましょう、必ずうまくいくはずです!
4+
5+
もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。
Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
すばらしい!
2+
3+
<hr>
4+
<h3 align="center">次のステップとして<a href="{{ repoUrl }}/pull/1">プルリクエストを開きました。</a></h3>

responses/ja/03_good-pr.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
## ステップ3:このプルリクエストをマージしよう
2+
3+
よく出来ました、@{{ user.username }}。プルリクエストは良さそうです。脆弱な依存関係を修正してくれてありがとう!
4+
5+
_注記:もしかしたら、このリポジトリには`package.json`はあるのに`package-lock.json`が無いことに気づいたかもしれません。これはすべての操作をGitHub.com上でやっているためです。他のリポジトリでは、いくつか違いがあるかもしれません。どのような依存関係ファイルを使っていようと、このコースのコアのコンセプトは同じです。_
6+
7+
### :keyboard: やってみよう:マージ
8+
1. このプルリクエストをマージ
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
## 依存関係の更新
2+
3+
次は、GitHub Flowを使って変更を加えていきましょう。もしGitHub Flowがなにかわからない場合は、[Introduction to GitHubコース](https://lab.github.com/githubtraining/introduction-to-github)を先に学習してからこのコースに戻ってくることをおすすめします。
4+
5+
> _注記:実際のコードで依存関係の更新をする際は、まずはアップグレード後のバージョンがあなたのプロジェクトで動作するか確かめましょう。ユニットテストやCI(継続的インテグレーション)があれば、より自信を持って更新することが出来ます。_
6+
7+
## ステップ4:依存関係のバージョンの更新
8+
9+
推奨バージョンがわかったので、`package.json`を実際に修正してみましょう。パッケージを脆弱性がないバージョンまでアップグレードします。
10+
11+
### :keyboard: やってみよう:`package.json`ファイルを更新
12+
13+
1. このプルリクエストの**Files changed**タブに移動
14+
1. `package.json`ファイルの右上にある`...`の中の**Edit file**をクリック
15+
1. 依存関係のバージョンを先程確認した推奨バージョンに変更することで脆弱性を修正
16+
1. スクロールダウンし、変更をコミット

responses/ja/04a_good-merge.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
無事にマージが出来ました、@{{ user.username }}。ブランチを削除して次に進みましょう。
2+
3+
<hr>
4+
<h3 align="center"><a href="{{ repoUrl }}/pull/3">次のプルリクエスト</a>で<code>.gitignore</code>について学びましょう。</h3>

responses/ja/04b_add-gitignore.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
## セキュリティのために`.gitignore`ファイルを活用しよう
2+
3+
ときおり、GitHubにチェックインしたくないファイルがあるかと思います。機密情報などといったプッシュするべきではない情報を含んでいるファイルは無視したいと思うかもしれません。Gitにファイルを無視するよう伝えるにはいくつか方法があります。
4+
5+
### ファイルを無視する
6+
7+
Gitはコミットする際に`.gitignore`というファイルを使ってどのファイルやディレクトリを無視するか決定します。設定ファイルや`env`ファイルのような機密情報が含まれたファイルをリポジトリの対象から外すことが
8+
出来ます。これはセキュリティのベストプラクティスを促進する1つのやり方です。
9+
10+
`.gitignore`ファイルはリポジトリにコミットする必要があります。このファイルを共有しコードの一部とすることで、他の人の役にも立ちます。リポジトリにコントリビュートしている他のユーザーが機密情報をコミットしてしまうことも防ぐことができるのです。皆さんのリポジトリで使えるような`.gitignore`のサンプルが沢山あります。そういったサンプルは[gitignore](https://github.com/github/gitignore)リポジトリで見つけることが出来ます。
11+
12+
## ステップ5:ファイルを無視する
13+
14+
このプルリクエストでは、`.gitignore`ファイルを追加しています。`.env`で終わるファイルは一般的には機密情報を含んでいます。こうすることで、機密情報を含むファイルを安全で秘密に保つことが出来ます。これらのファイルを`.gitignore`に追加してみましょう。
15+
16+
### :keyboard: やってみよう:.gitignoreファイルの更新
17+
18+
1. このプルリクエストの**Files changed**に移動
19+
1. 右上にある`...`の中の**Edit file**をクリックし、`.gitignore`を編集
20+
1. ファイルの1行目に`.env`と追記
21+
1. スクロールダウンし、変更をコミット
22+
23+
> _注記:`.gitignore`ファイルを追加したあとであっても、過去にコミットした内容は残っています。もし誤って機密情報をコミットしてしまった場合は、まずはトークンやパスワードを変更しましょう。その後、GitHubサポートに問い合わせコミット履歴を修正しましょう。_
24+
25+
このコースの手順は[Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf)にもまとまっています。
26+
27+
<hr>
28+
<h3 align="center">完了したら、次のコメントをこのプルリクエストに書きます。</h3>
29+
30+
> _時々、追加のコメントが書き込まれないことがあります!正しい操作をしたにも関わらず何のコメントも書き込まれない場合は、数秒待ってからこのページを再読込してください。_

0 commit comments

Comments
 (0)