From 460d245aeb79bd5a0aaf7258b0f22425633c643e Mon Sep 17 00:00:00 2001
From: natasha-moore-elastic <natasha.moore@elastic.co>
Date: Wed, 18 Oct 2023 13:18:11 +0200
Subject: [PATCH] Updates API Authentication section

---
 docs/siem-apis.asciidoc | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/siem-apis.asciidoc b/docs/siem-apis.asciidoc
index c6300b7819..f5a0130079 100644
--- a/docs/siem-apis.asciidoc
+++ b/docs/siem-apis.asciidoc
@@ -49,8 +49,17 @@ NOTE: You can find space URL identifiers on
 [float]
 === Authentication
 
-Token-based authentication, using the same username and password used to log in
-to the Kibana UI, is required to access the APIs.
+The {elastic-sec} APIs support key- and token-based authentication.
+
+[float]
+==== Key-based authentication
+
+To use key-based authentication, create an {kibana-ref}/api-keys.html[API key], then specify the key in the header of your API calls.
+
+[float]
+==== Token-based authentication
+
+For token-based authentication, use the same username and password that you use to log in to the {kib} UI. In a given HTTP tool, and when available, you can select to use its **Basic Authentication** option, which is where the username and password are stored in order to be passed as part of the call.
 
 [float]
 === API calls