[DOCS] Updates information on connecting to Cloud

Author: picandocodigo

docs/connecting.asciidoc

@@ -23,10 +23,11 @@ providers.
 [[auth-ec]]
 ==== Elastic Cloud
 
-If you are using https://www.elastic.co/cloud[Elastic Cloud], the client offers 
-an easy way to connect to it. You must pass the Cloud ID that you can find in 
-the cloud console, then your username and password.
+If you are using https://www.elastic.co/cloud[Elastic Cloud], the client offers an easy way to connect to it. You need the Cloud ID that you can find in the cloud console, then your username and password.
 
+image::docs/images/cloud_id.png["Cloud ID"]
+
+Once you have collected the Cloud ID you can use the client to connect to your Elastic Cloud instance, as follows:
 
 [source,ruby]
 ------------------------------------
@@ -39,7 +40,22 @@ client = Elasticsearch::Client.new(
 )
 ------------------------------------
 
-You can also connect to the Cloud by using API Key authentication:
+You can also connect to the Cloud by using API Key authentication. You can generate an `API key` in the `Management` page under the section `Security`.
+
+image::docs/images/cloud_api_key.png["API key"]
+
+When you click on `Create API key` you can choose a name and set the other options (eg. restrict privileges, expire after time, etc).
+
+image::docs/images/api_key_name.png["Choose an API name"]
+
+After this step you will get the `API key` in the API keys page. 
+
+image::docs/images/cloud_api_key.png["API key"]
+
+**IMPORTANT**: you need to copy and store the `API key`in a secure place, since you will not be able to view it again in Elastic Cloud.
+
+Once you have collected the `Cloud ID` and the `API key` you can use the client
+to connect to your Elastic Cloud instance, as follows:
 
 [source,ruby]
 ------------------------------------