add changes to docs

Author: philkra

docs/configuration.asciidoc

@@ -95,7 +95,8 @@ If you want to connect to Elastic Cloud, you can use your Cloud ID and use basic
 [source,php]
 ----
 $client = ClientBuilder::create()
-            ->setElasticCloudId('<elastic-cloud-id>', '<username>', '<secure-password>') <1>, <2>
+            ->setElasticCloudId('<elastic-cloud-id>')  <1>
+            ->setBasicAuthentication('<username>', '<secure-password>') <2>
             ->build();
 ----
 <1> Your Cloud ID provided by the Elastic Cloud platform
@@ -105,7 +106,7 @@ $client = ClientBuilder::create()
 ----
 $client = ClientBuilder::create()
             ->setElasticCloudId('<elastic-cloud-id>') <1>
-            ->setApiKeyPairAuthentication('<id>', '<api_key>') <2>
+            ->setApiKey('<id>', '<api_key>') <2>
             ->build();
 ----
 <1> Your Cloud ID provided by the Elastic Cloud platform
@@ -267,7 +268,7 @@ $client = ClientBuilder::create()
             ->build();
 ----
 
-For more details, please see the dedicated page on 
+For more details, please see the dedicated page on
 <<connection_pool,configuring connection pools>>.
 
 === Setting the Connection Selector

docs/security.asciidoc

@@ -26,25 +26,16 @@ cluster will use the appropriate credentials depending on the node being talked
 
 === ApiKey Authentication
 
-If your Elasticsearch cluster is secured by API keys as described https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html[here], you have two options to provide the values to the client.
-Either use the `id` and `api_key` pair from the create API key API response or use the encoded token as described https://www.elastic.co/guide/en/elasticsearch/reference/7.1/security-api-create-api-key.html#_examples_83[here] in the last code snippet.
+If your Elasticsearch cluster is secured by API keys as described https://www.elastic.co/guide/en/elasticsearch/reference/current/security-api-create-api-key.html[here], you can use these values to connect the client with your cluster, as illustrated in the following code snippet.
 
 [source,php]
 ----
 $client = ClientBuilder::create()
-                    ->setApiKeyPairAuthentication('id', 'api_key') <1>
+                    ->setApiKey('id', 'api_key') <1>
                     ->build();
 ----
 <1> ApiKey pair of `id` and `api_key` from the create API key response.
 
-[source,php]
-----
-$client = ClientBuilder::create()
-                    ->setApiKeyAuthentication('encoded-api-key') <1>
-                    ->build();
-----
-<1> Encoded ApiKey pair
-
 === SSL Encryption
 
 Configuring SSL is a little more complex.  You need to identify if your certificate has been signed by a public