add kafka integration

content/vault/integrations/index.md

@@ -56,7 +56,33 @@ Alternatives to cloud event integrations are self-hosted variants such as a Kafk
 
 ### Kafka
 
-> Tutorial to be written.
+Apache Kafka is an open-source distributed event streaming platform used by thousands of companies for high-performance data pipelines, streaming analytics, data integration, and mission-critical applications.
+
+To integrate a Kafka broker with Kerberos vault you could install your existing Kafka installation, or on board a new Kafka broker inside your Kubernetes cluster. Before installing the Kafka broker, we will need to set up a storage class. As previously mentioned we will use OpenEBS for that, but you could use the storage class you prefer.
+
+    kubectl apply -f https://openebs.github.io/charts/openebs-operator.yaml
+
+Once OpenEBS is installed and configured, go ahead with setting up the Kafka broker.
+
+    kubectl create namespace kafka
+    helm install kafka bitnami/kafka -f https://raw.githubusercontent.com/kerberos-io/vault/master/yaml/kafka/kafka.values.yaml -n kafka
+
+Once done you should see the relevant kafka pods and zookeeper being deployed
+
+    kubectl get po -n kafka
+
+Now you are ready to configure the Kerberos Vault integration, by selecting the Kafka option. You should add the Kafka credentials and authentication mechanism.
+
+{{< figure src="kafka.gif" alt="Configure, add and validate the Kafka integration." caption="Configure, add and validate the Kafka integration." class="stretch">}}
+
+- Integration name: this a preferred name for the integration.
+- Broker: the url of the broker `kafka.kafka:9092`.
+- Group: the group to which messages are produced, this can be any value you want.
+- Topic: the topic to which a message is produced, if the topic doesn't exist, it will be created automatically.
+- Username: the username, `Yourusername`.
+- Password: the password, `Yourpassword`.
+- Mechanism: the kafka mechanism, `PLAIN`.
+- Security: the kafka security, `SASL_PLAINTEXT`.
 
 ## Kerberos integrations