From 6b6dcdb7c304fe2b071ecaace8c7c8bf3a41c64e Mon Sep 17 00:00:00 2001
From: Lisa Cawley <lcawley@elastic.co>
Date: Tue, 5 Sep 2023 08:15:22 -0700
Subject: [PATCH] [DOCS] Move preconfigured Opsgenie connector details
 (#165258)

---
 .../connectors/action-types/opsgenie.asciidoc | 28 -------------------
 .../pre-configured-connectors.asciidoc        | 21 ++++++++++++++
 docs/settings/alert-action-settings.asciidoc  | 22 +++++++++++++++
 3 files changed, 43 insertions(+), 28 deletions(-)

diff --git a/docs/management/connectors/action-types/opsgenie.asciidoc b/docs/management/connectors/action-types/opsgenie.asciidoc
index 453aa8c00b811..817acdfb135d4 100644
--- a/docs/management/connectors/action-types/opsgenie.asciidoc
+++ b/docs/management/connectors/action-types/opsgenie.asciidoc
@@ -28,34 +28,6 @@ URL:: The Opsgenie URL. For example, https://api.opsgenie.com or https://api.eu.
 NOTE: If you are using the <<action-settings, `xpack.actions.allowedHosts`>> setting, make sure the hostname is added to the allowed hosts.
 API Key::   The Opsgenie API authentication key for HTTP Basic authentication. For more details about generating Opsgenie API keys, refer to https://support.atlassian.com/opsgenie/docs/create-a-default-api-integration/[Opsgenie documentation].
 
-[float]
-[[preconfigured-opsgenie-configuration]]
-=== Create preconfigured connectors
-
-If you are running {kib} on-prem, you can define connectors by
-adding `xpack.actions.preconfigured` settings to your `kibana.yml` file.
-For example:
-
-[source,text]
---
-xpack.actions.preconfigured:
-  my-opsgenie:
-    name: preconfigured-opsgenie-connector-type
-    actionTypeId: .opsgenie
-    config:
-      apiUrl: https://api.opsgenie.com
-    secrets:
-      apiKey: apikey
---
-
-Config defines information for the connector type.
-
-`apiUrl`:: A string that corresponds to *URL*.
-
-Secrets defines sensitive information for the connector type.
-
-`apiKey`:: A string that corresponds to *API Key*.
-
 [float]
 [[opsgenie-action-configuration]]
 === Test connectors
diff --git a/docs/management/connectors/pre-configured-connectors.asciidoc b/docs/management/connectors/pre-configured-connectors.asciidoc
index 3584207a88364..ceaf771a58f9e 100644
--- a/docs/management/connectors/pre-configured-connectors.asciidoc
+++ b/docs/management/connectors/pre-configured-connectors.asciidoc
@@ -83,9 +83,30 @@ configuration.
 [float]
 === Examples
 
+* <<preconfigured-opsgenie-configuration>>
 * <<preconfigured-server-log-configuration>>
 * <<preconfigured-webhook-configuration>>
 
+[float]
+[[preconfigured-opsgenie-configuration]]
+==== {opsgenie} connectors
+
+The following example creates an <<opsgenie-action-type,{opsgenie} connector>>:
+
+[source,text]
+--
+xpack.actions.preconfigured:
+  my-opsgenie:
+    name: preconfigured-opsgenie-connector-type
+    actionTypeId: .opsgenie
+    config:
+      apiUrl: https://api.opsgenie.com <1>
+    secrets:
+      apiKey: apikey <2>
+--
+<1> The {opsgenie} URL.
+<2> The {opsgenie} API authentication key for HTTP basic authentication.
+
 [float]
 [[preconfigured-server-log-configuration]]
 ==== Server log connectors
diff --git a/docs/settings/alert-action-settings.asciidoc b/docs/settings/alert-action-settings.asciidoc
index c48483224ec52..9ab4058d35e30 100644
--- a/docs/settings/alert-action-settings.asciidoc
+++ b/docs/settings/alert-action-settings.asciidoc
@@ -252,9 +252,31 @@ Specifies configuration details that are specific to the type of preconfigured c
 The type of preconfigured connector.
 For example: `.email`, `.index`, `.opsgenie`, `.server-log`, `.resilient`, `.slack`, and `.webhook`.
 
+`xpack.actions.preconfigured.<connector-id>.config.apiUrl`::
+A configuration URL that varies by connector:
++
+--
+* For an <<opsgenie-action-type,{opsgenie} connector>>, specifies the {opsgenie} URL. For example, `https://api.opsgenie.com` or `https://api.eu.opsgenie.com`.
+
+NOTE: If you are using the `xpack.actions.allowedHosts` setting, make sure the hostname in the URL is added to the allowed hosts.
+--
+
 `xpack.actions.preconfigured.<connector-id>.name`::
 The name of the preconfigured connector.
 
+`xpack.actions.preconfigured.<connector-id>.secrets`::
+Sensitive configuration details, such as username, password, and keys, which are specific to the connector type.
++
+TIP: Sensitive properties, such as passwords, should be stored in the <<creating-keystore,{kib} keystore>>.
+
+`xpack.actions.preconfigured.<connector-id>.secrets.apikey`::
+An API key secret that varies by connector:
++
+--
+* For an <<opsgenie-action-type,{opsgenie} connector>>, specifies the {opsgenie} API authentication key for HTTP basic authentication.
+--
+
+
 [float]
 [[alert-settings]]
 === Alerting settings