Repository: kafka Updated Branches: refs/heads/trunk d5b43b19b -> 1faab034b
MINOR: Remove multi-byte charactor in docs There are multi-byte characters In quickstart.html and security.html. This PR will fix it. Author: Sasaki Toru <[email protected]> Reviewers: Grant Henke Closes #897 from sasakitoa/remove_multi_byte_character Project: http://git-wip-us.apache.org/repos/asf/kafka/repo Commit: http://git-wip-us.apache.org/repos/asf/kafka/commit/1faab034 Tree: http://git-wip-us.apache.org/repos/asf/kafka/tree/1faab034 Diff: http://git-wip-us.apache.org/repos/asf/kafka/diff/1faab034 Branch: refs/heads/trunk Commit: 1faab034b10a15beac2b90f8f2fe1c65a6b40765 Parents: d5b43b1 Author: Sasaki Toru <[email protected]> Authored: Wed Feb 10 12:50:57 2016 -0700 Committer: Gwen Shapira <[email protected]> Committed: Wed Feb 10 12:50:57 2016 -0700 ---------------------------------------------------------------------- docs/quickstart.html | 2 +- docs/security.html | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/kafka/blob/1faab034/docs/quickstart.html ---------------------------------------------------------------------- diff --git a/docs/quickstart.html b/docs/quickstart.html index 14f7518..c8933c3 100644 --- a/docs/quickstart.html +++ b/docs/quickstart.html @@ -200,7 +200,7 @@ Kafka Connect is a tool included with Kafka that imports and exports data to Kaf how to run Kafka Connect with simple connectors that import data from a file to a Kafka topic and export data from a Kafka topic to a file. -First, weâll start by creating some seed data to test with: +First, we'll start by creating some seed data to test with: <pre> > <b>echo -e "foo\nbar" > test.txt</b> http://git-wip-us.apache.org/repos/asf/kafka/blob/1faab034/docs/security.html ---------------------------------------------------------------------- diff --git a/docs/security.html b/docs/security.html index 51bde6a..de282a7 100644 --- a/docs/security.html +++ b/docs/security.html @@ -34,7 +34,7 @@ Apache Kafka allows clients to connect over SSL. By default SSL is disabled but <ol> <li><h4><a id="security_ssl_key" href="#security_ssl_key">Generate SSL key and certificate for each Kafka broker</a></h4> - The first step of deploying HTTPS is to generate the key and the certificate for each machine in the cluster. You can use Javaâs keytool utility to accomplish this task. + The first step of deploying HTTPS is to generate the key and the certificate for each machine in the cluster. You can use Java's keytool utility to accomplish this task. We will generate the key into a temporary keystore initially so that we can export and sign it later with CA. <pre> keytool -keystore server.keystore.jks -alias localhost -validity {validity} -genkey</pre> @@ -54,7 +54,7 @@ Apache Kafka allows clients to connect over SSL. By default SSL is disabled but The generated CA is simply a public-private key pair and certificate, and it is intended to sign other certificates.<br> - The next step is to add the generated CA to the **clientsâ truststore** so that the clients can trust this CA: + The next step is to add the generated CA to the **clients' truststore** so that the clients can trust this CA: <pre> keytool -keystore server.truststore.jks -alias CARoot <b>-import</b> -file ca-cert</pre> @@ -62,7 +62,7 @@ Apache Kafka allows clients to connect over SSL. By default SSL is disabled but <pre> keytool -keystore client.truststore.jks -alias CARoot -import -file ca-cert</pre> - In contrast to the keystore in step 1 that stores each machineâs own identity, the truststore of a client stores all the certificates that the client should trust. Importing a certificate into oneâs truststore also means trusting all certificates that are signed by that certificate. As the analogy above, trusting the government (CA) also means trusting all passports (certificates) that it has issued. This attribute is called the chain of trust, and it is particularly useful when deploying SSL on a large Kafka cluster. You can sign all certificates in the cluster with a single CA, and have all machines share the same truststore that trusts the CA. That way all machines can authenticate all other machines.</li> + In contrast to the keystore in step 1 that stores each machine's own identity, the truststore of a client stores all the certificates that the client should trust. Importing a certificate into one's truststore also means trusting all certificates that are signed by that certificate. As the analogy above, trusting the government (CA) also means trusting all passports (certificates) that it has issued. This attribute is called the chain of trust, and it is particularly useful when deploying SSL on a large Kafka cluster. You can sign all certificates in the cluster with a single CA, and have all machines share the same truststore that trusts the CA. That way all machines can authenticate all other machines.</li> <li><h4><a id="security_ssl_signing" href="#security_ssl_signing">Signing the certificate</a></h4> The next step is to sign all certificates generated by step 1 with the CA generated in step 2. First, you need to export the certificate from the keystore:
