Update Korean translation

closes expressjs#1034
labaran1 · pull · Sep 30, 2021 · Apr 22, 2019 · Apr 22, 2019 · Apr 22, 2019
commit 91851160f224481a4a9617055ffc3622bbc8e91e
diff --git a/ko/3x/api.md b/ko/3x/api.md
@@ -14,19 +14,10 @@ lang: ko
 
   <h1>3.x API</h1>
 
-  <a id='express' class='h2'></a>
   {% include api/en/3x/express.md %}
-
-  <a id='application' class='h2'></a>
   {% include api/en/3x/app.md %}
-
-  <a id='request' class='h2'></a>
   {% include api/en/3x/req.md %}
-
-  <a id='response' class='h2'></a>
   {% include api/en/3x/res.md %}
-
-  <a id='middleware' class='h2'></a>
   {% include api/en/3x/middleware.md %}
 
 </div>
diff --git a/ko/4x/api.md b/ko/4x/api.md
@@ -8,19 +8,10 @@ lang: ko
 
   <h1>4.x API</h1>
 
-  <a id='express' class='h2'></a>
   {% include api/en/4x/express.md %}
-
-  <a id='app' class='h2'></a>
   {% include api/en/4x/app.md %}
-
-  <a id='req' class='h2'></a>
   {% include api/en/4x/req.md %}
-
-  <a id='res' class='h2'></a>
   {% include api/en/4x/res.md %}
-
-  <a id='router' class='h2'></a>
   {% include api/en/4x/router.md %}
 
 </div>
diff --git a/ko/advanced/best-practice-performance.md b/ko/advanced/best-practice-performance.md
diff --git a/ko/advanced/best-practice-security.md b/ko/advanced/best-practice-security.md
@@ -9,18 +9,34 @@ lang: ko
 
 ## 개요
 
-*"프로덕션(production)"*이라는 용어는 소프트웨어 라이프사이클 중 애플리케이션 또는 API가 최종 사용자 또는 소비자에게 정식으로 제공되는 단계를 말합니다. 이와 반대로 *"개발(development)"* 단계에서는 아직 코드가 활발하게 작성 및 테스트되며 애플리케이션은 외부 액세스에 개방되지 않습니다. 이에 대응하는 시스템 환경은 각각 *프로덕션* 환경 및 *개발* 환경이라고 부릅니다.
+__"프로덕션 (production)"__ 이라는 용어는 소프트웨어 라이프사이클 중 애플리케이션 또는 API가 최종 사용자 또는 소비자에게 정식으로 제공되는 단계를 말합니다. 이와 반대로 *"개발(development)"* 단계에서는 아직 코드가 활발하게 작성 및 테스트되며 애플리케이션은 외부 액세스에 개방되지 않습니다. 이에 대응하는 시스템 환경은 각각 *프로덕션* 환경 및 *개발* 환경이라고 부릅니다.
 
 개발 환경 및 프로덕션 환경은 일반적으로 서로 다르게 설정되며 두 환경의 요구사항은 크게 다릅니다. 개발 환경에서는 좋은 것일지라도 프로덕션 환경에서는 허용되지 않을 수도 있습니다. 예를 들면, 개발 환경에서는 디버깅을 위해 상세한 오류 로깅이 선호될 수 있지만, 이러한 행동은 프로덕션 환경에서 보안 우려사항이 될 수 있습니다. 그리고 개발 환경에서는 확장성, 신뢰성 및 성능에 대해 걱정할 필요가 없지만, 이러한 요인들은 프로덕션 환경에서 매우 중요해집니다.
 
+{% include note.html content="Express의 보안 취약점을 발견하신것 같다면,
+[Security Policies and Procedures](/en/resources/contributing.html#security-policies-and-procedures)를 따라주십시오.
+" %}
+
 이 문서에서는 프로덕션 환경에 배치된 Express 애플리케이션을 위한 몇 가지 보안 우수 사례에 대해 논의합니다.
 
-## 더 이상 사용되지 않거나 취약성이 있는 버전의 Express를 사용하지 마십시오
+- [더 이상 사용되지 않거나 취약성이 있는 버전의 Express 사용 중지](#dont-use-deprecated-or-vulnerable-versions-of-express)
+- [TLS 사용](#use-tls)
+- [Helmet 사용](#use-helmet)
+- [쿠키를 안전하게 사용](#use-cookies-securely)
+- [인증 체계에 대한 브루스 포트 공격 방지](#prevent-brute-force-attacks-against-authorization)
+- [종속 항목이 안전한지 확인](#ensure-your-dependencies-are-secure)
+- [그 외의 알려져 있는 취약점 회피](#avoid-other-known-vulnerabilities)
+- [추가적인 고려사항](#additional-considerations)
+
+<a name="dont-use-deprecated-or-vulnerable-versions-of-express"></a>
+## 더 이상 사용되지 않거나 취약성이 있는 버전의 Express를 사용 중지
 
 Express 2.x 및 3.x에 대한 유지보수는 더 이상 이루어지지 않습니다. 이러한 버전에서의 보안 및 성능 문제는 수정되지 않습니다. 이러한 버전은 사용하지 마십시오!  아직 버전 4로 이전하지 않은 경우에는 [마이그레이션 안내서](/{{ page.lang }}/guide/migrating-4.html)를 따르십시오.
 
 또한 [보안 업데이트 페이지](/{{ page.lang }}/advanced/security-updates.html)의 목록에 포함된 취약성 있는 Express 버전을 사용하고 있지 않은지 확인하십시오. 취약성 있는 Express 버전을 사용하고 있는 경우에는 안정적인 릴리스 중 하나로 업데이트해야 하며, 가능하면 최신 버전으로 업데이트하는 것이 좋습니다.
 
+
+<a name="use-tls"></a>
 ## TLS 사용
 
 앱이 민감한 데이터를 다루거나 전송하는 경우에는 [전송 계층 보안](https://en.wikipedia.org/wiki/Transport_Layer_Security)(TLS)을 사용하여 연결 및 데이터를 보호하십시오. 이 기술은 데이터를 클라이언트로부터 서버로 전송하기 전에 데이터를 암호화하며, 따라서 몇 가지 일반적인(그리고 쉬운) 해킹을 방지합니다. Ajax 및 POST 요청은 브라우저에서 분명하게 보이지 않고 "숨겨진" 것처럼 보일 수도 있지만, 이러한 요청의 트래픽은 [패킷 가로채기](https://en.wikipedia.org/wiki/Packet_analyzer) 및 [중간자 공격](https://en.wikipedia.org/wiki/Man-in-the-middle_attack)에 취약합니다.
@@ -29,6 +45,7 @@ Express 2.x 및 3.x에 대한 유지보수는 더 이상 이루어지지 않습
 
 또한 무료 TLS 인증서를 얻기 위한 편리한 도구 중 하나는 [Internet Security Research Group(ISRG)](https://letsencrypt.org/isrg/)이 제공하는 무료의 자동 개방형 인증 기관(CA)인 [Let's Encrypt](https://letsencrypt.org/about/)입니다.
 
+<a name="use-helmet"></a>
 ## Helmet 사용
 
 [Helmet](https://www.npmjs.com/package/helmet)을 이용하면 HTTP 헤더를 적절히 설정하여 몇 가지 잘 알려진 웹 취약성으로부터 앱을 보호할 수 있습니다.
@@ -47,37 +64,37 @@ Express 2.x 및 3.x에 대한 유지보수는 더 이상 이루어지지 않습
 
 다른 모든 모듈처럼 Helmet은 다음과 같이 설치할 수 있습니다.
 
-<pre>
-<code class="language-sh" translate="no">
+```sh
 $ npm install --save helmet
-</code>
-</pre>
+```
 
 이후 코드에서 Helmet을 사용하는 방법은 다음과 같습니다.
 
-<pre>
-<code class="language-javascript" translate="no">
-...
-var helmet = require('helmet');
-app.use(helmet());
-...
-</code>
-</pre>
+```js
+// ...
+
+var helmet = require('helmet')
+app.use(helmet())
+
+// ...
+```
 
 ### 적어도 X-Powered-By 헤더는 사용하지 않도록 설정
 
 Helmet의 사용을 원치 않는 경우에는 적어도 `X-Powered-By` 헤더를 사용하지 마십시오.  공격자는 이 헤더(기본적으로 사용하도록 설정되어 있음)를 이용해 Express를 실행하는 앱을 발견한 후 특정한 대상에 대한 공격을 실행할 수 있습니다.
 
 따라서 우수 사례는 다음과 같이 `app.disable()` 메소드를 이용해 이 헤더를 끄는 것입니다.
 
-<pre>
-<code class="language-javascript" translate="no">
-app.disable('x-powered-by');
-</code>
-</pre>
+
+```js
+app.disable('x-powered-by')
+```
 
 `helmet.js`를 사용하는 경우에는 사용자를 대신하여 `helmet.js`가 위의 작업을 실행합니다.
 
+{% include note.html content="`X-Powered-By header`를 비활성화하는 행위는 고수준의 공격자가 앱이 Express를 사용하고 있는지 확인하는 걸 막을 수 없습니다. 일반적인 취약점은 막을지 모르지만, 앱이 Express를 사용하고 있는지 알아내는 다른 방법은 많이 있습니다. "%}
+
+<a name="use-cookies-securely"></a>
 ## 쿠키를 안전하게 사용
 
 쿠키로 인해 앱이 악용에 노출되지 않도록 하기 위해 기본 세션 쿠키 이름을 사용하지 말고 쿠키 보안 옵션을 적절히 설정하십시오.
@@ -97,17 +114,14 @@ app.disable('x-powered-by');
 
 이러한 문제점을 피하려면 일반적인 쿠키 이름을 사용하십시오. 예를 들면 [express-session](https://www.npmjs.com/package/express-session) 미들웨어를 이용해 다음과 같이 하십시오.
 
-<pre>
-<code class="language-javascript" translate="no">
-var session = require('express-session');
+```js
+var session = require('express-session')
 app.set('trust proxy', 1) // trust first proxy
-app.use( session({
-   secret : 's3Cur3',
-   name : 'sessionId',
-  })
-);
-</code>
-</pre>
+app.use(session({
+  secret: 's3Cur3',
+  name: 'sessionId'
+}))
+```
 
 ### 쿠키 보안 옵션 설정
 
@@ -121,81 +135,74 @@ app.use( session({
 
 다음에는 [cookie-session](https://www.npmjs.com/package/cookie-session) 미들웨어를 사용한 예가 표시되어 있습니다.
 
-<pre>
-<code class="language-javascript" translate="no">
-var session = require('cookie-session');
-var express = require('express');
-var app = express();
+```js
+var session = require('cookie-session')
+var express = require('express')
+var app = express()
 
-var expiryDate = new Date( Date.now() + 60 * 60 * 1000 ); // 1 hour
+var expiryDate = new Date(Date.now() + 60 * 60 * 1000) // 1 hour
 app.use(session({
   name: 'session',
   keys: ['key1', 'key2'],
-  cookie: { secure: true,
-            httpOnly: true,
-            domain: 'example.com',
-            path: 'foo/bar',
-            expires: expiryDate
-          }
-  })
-);
-</code>
-</pre>
-
-## 종속 항목이 안전한지 확인하십시오
+  cookie: {
+    secure: true,
+    httpOnly: true,
+    domain: 'example.com',
+    path: 'foo/bar',
+    expires: expiryDate
+  }
+}))
+```
+
+<a name="ensure-your-dependencies-are-secure"></a>
+## 종속 항목이 안전한지 확인
 
 npm을 이용해 애플리케이션의 종속 항목을 관리하는 것은 강력하면서도 편리합니다.  그러나 사용 중인 패키지에는 애플리케이션에 영향을 미칠 수 있는 치명적인 보안 취약성이 포함되어 있을 수도 있습니다.  앱의 보안성은 종속 항목 내의 "가장 약한 링크"의 보안성에 따라 결정됩니다.
 
-사용 중인 써드파티 패키지의 보안성을 보장하려면 [nsp](https://www.npmjs.com/package/nsp)와 [requireSafe](https://requiresafe.com/) 중 어느 하나 또는 둘 모두를 사용하십시오.  이 두 도구의 기능은 대체로 동일합니다.
+npm@6부터 npm은 자동으로 모든 설치 요청을 검사합니다. 또한 `npm audit`을 이용해 여러분의 의존성 트리를 검사할 수 있습니다.
 
-[nsp](https://www.npmjs.com/package/nsp)는 [Node Security Project](https://nodesecurity.io/) 취약성 데이터베이스를 확인하여, 알려진 취약성이 있는 패키지가 애플리케이션에 사용되었는지 파악하는 명령행 도구입니다. nsp를 설치하려면 다음과 같이 하십시오.
+```sh
+$ npm audit
+```
 
-<pre>
-<code class="language-sh" translate="no">
-$ npm i nsp -g
-</code>
-</pre>
+더 강한 보안을 원한다면, [Snyk](https://snyk.io/)를 사용하십시오.
 
-유효성 검증을 위한 `npm-shrinkwrap.json` 파일을 [nodesecurity.io](https://nodesecurity.io/)에 제출하려면 다음과 같은 명령을 사용하십시오.
+Snyk offers both a [command-line tool](https://www.npmjs.com/package/snyk) and a [Github 통합](https://snyk.io/docs/github) that checks your application against [Snyk's open source vulnerability database](https://snyk.io/vuln/) for any known vulnerabilities in your dependencies. Install the CLI as follows:
+Sync는 [커맨드라인 도구](https://www.npmjs.com/package/snyk)와 [Snyk's open source vulnerability database](https://snyk.io/vuln/)에 있는 여러분의 의존성들의 알려진 취약성에 대한 검사를 실행하는 [Github integration](https://snyk.io/docs/github)을 제공합니다. 아래 커맨드로 설치합니다.
 
-<pre>
-<code class="language-sh" translate="no">
-$ nsp audit-shrinkwrap
-</code>
-</pre>
+```sh
+$ npm install -g snyk
+$ cd your-app
+```
 
-유효성 검증을 위한 `package.json` 파일을 [nodesecurity.io](https://nodesecurity.io/)에 제출하려면 다음과 같은 명령을 사용하십시오.
+아래 명령으로 애플리케이션의 취약점을 검사합니다.
 
-<pre>
-<code class="language-sh" translate="no">
-$ nsp audit-package
-</code>
-</pre>
+```sh
+$ snyk test
+```
 
-[requireSafe](https://requiresafe.com/)를 이용해 Node 모듈에 대한 감사를 실행하는 방법은 다음과 같습니다.
+Use this command to open a wizard that walks you through the process of applying updates or patches to fix the vulnerabilities that were found:
+아래 명령으로 찾은 취약점을 고치는 패치나 업데이트를 받는 설치 마법사를 실행합니다.
 
-<pre>
-<code class="language-sh" translate="no">
-$ npm install -g requiresafe
-$ cd your-app
-$ requiresafe check
-</code>
-</pre>
+```sh
+$ snyk wizard
+```
 
+<a name="avoid-other-known-vulnerabilities"></a>
+## 그 외의 알려져 있는 취약점 회피
+
+Express에, 또는 앱에 사용되는 다른 모듈에 영향을 미칠 수 있는 [Node Security Project](https://nodesecurity.io/advisories)의 보안 권고문에 항상 주의를 기울이십시오.  일반적으로 Node Security Project는 Node의 보안과 관련된 지식 및 도구에 대한 훌륭한 자원입니다.
+
+마지막으로, 다른 모든 웹 앱과 마찬가지로 Express 앱은 다양한 웹 기반 공격에 취약할 수 있습니다. 알려져 있는 [웹 취약성](https://www.owasp.org/index.php/Top_10_2013-Top_10)을 숙지한 후 이러한 취약성을 피하기 위한 예방 조치를 취하십시오.
+
+<a name="additional-considerations"></a>
 ## 추가적인 고려사항
 
-유용한 [Node.js Security Checklist](https://blog.risingstack.com/node-js-security-checklist/)에서 발췌한 몇 가지 추가적인 권장사항은 다음과 같습니다.  아래의 권장사항에 대한 모든 상세 정보를 확인하려면 해당 블로그 게시물을 참조하십시오.
+유용한 [Node.js Security Checklist](https://blog.risingstack.com/node-js-security-checklist/)에서 발췌한 몇 가지 추가적인 권장사항은 다음과 같습니다. 아래의 권장사항에 대한 모든 상세 정보를 확인하려면 해당 블로그 게시물을 참조하십시오.
 
-* 속도 제한(rate-limiting)을 구현하여 인증에 대한 무차별 대입 공격을 방지하십시오.  이를 실행하는 한 가지 방법은 [StrongLoop API Gateway](https://strongloop.com/node-js/api-gateway/)를 이용하여 속도 제한 정책을 적용하는 것입니다.  대안적으로, [express-limiter](https://www.npmjs.com/package/express-limiter)와 같은 미들웨어를 사용할 수 있지만, 그러한 경우에는 코드를 어느 정도 수정해야 합니다.
 * [csurf](https://www.npmjs.com/package/csurf) 미들웨어를 이용하여 교차 사이트 요청 위조(CSRF)로부터 보호하십시오.
 * 항상 사용자 입력을 필터링하고 사용자 입력에서 민감한 데이터를 제거하여 XSS(Cross-site scripting) 및 명령 인젝션 공격으로부터 보호하십시오.
 * 매개변수화된 조회 또는 준비된 명령문을 이용하여 SQL 인젝션 공격으로부터 방어하십시오.
 * 오픈 소스 방식의 [sqlmap](http://sqlmap.org/) 도구를 이용하여 앱 내의 SQL 인젝션 취약성을 발견하십시오.
 * [nmap](https://nmap.org/) 및 [sslyze](https://github.com/nabla-c0d3/sslyze) 도구를 이용하여 SSL 암호, 키 및 재협상의 구성, 그리고 인증서의 유효성을 테스트하십시오.
 * [safe-regex](https://www.npmjs.com/package/safe-regex)를 이용하여 정규식이 [정규식 서비스 거부](https://www.owasp.org/index.php/Regular_expression_Denial_of_Service_-_ReDoS) 공격을 쉽게 받지 않도록 하십시오.
-
-## 그 외의 알려져 있는 취약성을 피하십시오
-
-Express에, 또는 앱에 사용되는 다른 모듈에 영향을 미칠 수 있는 [Node Security Project](https://nodesecurity.io/advisories)의 보안 권고문에 항상 주의를 기울이십시오.  일반적으로 Node Security Project는 Node의 보안과 관련된 지식 및 도구에 대한 훌륭한 자원입니다.
-
-마지막으로, 다른 모든 웹 앱과 마찬가지로 Express 앱은 다양한 웹 기반 공격에 취약할 수 있습니다. 알려져 있는 [웹 취약성](https://www.owasp.org/index.php/Top_10_2013-Top_10)을 숙지한 후 이러한 취약성을 피하기 위한 예방 조치를 취하십시오.
diff --git a/ko/advanced/developing-template-engines.md b/ko/advanced/developing-template-engines.md
@@ -1,48 +1,42 @@
 ---
 layout: page
-title: Express용 템플리트 엔진 개발
+title: Express용 템플릿 엔진 개발
 menu: advanced
 lang: ko
 ---
 
-# Express용 템플리트 엔진 개발
+# Express용 템플릿 엔진 개발
 
-`app.engine(ext, callback)` 메소드를 사용하면 자신만의 템플리트 엔진을 작성할 수 있습니다. `ext`는 파일 확장자를 나타내며, `callback`은 파일의 위치, 옵션 오브젝트 및 콜백 함수 등의 항목을 매개변수로 수락하는 템플리트 엔진 함수입니다.
+`app.engine(ext, callback)` 메소드를 사용하면 자신만의 템플릿 엔진을 작성할 수 있습니다. `ext`는 파일 확장자를 나타내며, `callback`은 파일의 위치, 옵션 오브젝트 및 콜백 함수 등의 항목을 매개변수로 수락하는 템플릿 엔진 함수입니다.
 
-다음의 코드는 `.ntl` 파일을 렌더링하기 위한 매우 간단한 템플리트 엔진을 구현하는 예입니다.
+다음의 코드는 `.ntl` 파일을 렌더링하기 위한 매우 간단한 템플릿 엔진을 구현하는 예입니다.
 
-<pre>
-<code class="language-javascript" translate="no">
-var fs = require('fs'); // this engine requires the fs module
+```js
+var fs = require('fs') // this engine requires the fs module
 app.engine('ntl', function (filePath, options, callback) { // define the template engine
   fs.readFile(filePath, function (err, content) {
-    if (err) return callback(new Error(err));
+    if (err) return callback(err)
     // this is an extremely simple template engine
-    var rendered = content.toString().replace('#title#', '<title>'+ options.title +'</title>')
-    .replace('#message#', '<h1>'+ options.message +'</h1>');
-    return callback(null, rendered);
-  });
-});
-app.set('views', './views'); // specify the views directory
-app.set('view engine', 'ntl'); // register the template engine
-</code>
-</pre>
+    var rendered = content.toString().replace('#title#', '<title>' + options.title + '</title>')
+    .replace('#message#', '<h1>' + options.message + '</h1>')
+    return callback(null, rendered)
+  })
+})
+app.set('views', './views') // specify the views directory
+app.set('view engine', 'ntl') // register the template engine
+```
 
 앱은 이제 `.ntl` 파일을 렌더링할 수 있습니다. 다음의 내용이 입력된 `index.ntl`이라는 이름의 파일을 `views` 디렉토리에 작성하십시오.
 
-<pre>
-<code class="language-javascript" translate="no">
+```text
 #title#
 #message#
-</code>
-</pre>
+```
 이후 앱에 다음과 같은 라우트를 작성하십시오.
 
-<pre>
-<code class="language-javascript" translate="no">
+```js
 app.get('/', function (req, res) {
-  res.render('index', { title: 'Hey', message: 'Hello there!'});
-});
-</code>
-</pre>
+  res.render('index', { title: 'Hey', message: 'Hello there!' })
+})
+```
 홈 페이지에 대한 요청을 실행할 때 `index.ntl`은 HTML로 렌더링됩니다.