Merge branch 'main' into mw-ts-toc-cleanup

marciw · web-flow · commit 876e304a2b05 · 2025-02-17T11:52:48.000-05:00
diff --git a/deploy-manage/users-roles/cloud-organization/configure-saml-authentication.md b/deploy-manage/users-roles/cloud-organization/configure-saml-authentication.md
@@ -226,25 +226,5 @@ If SSO enforcement is enabled, then you must disable SSO enforcement before you
 2. In the **User authentication** section, click **Edit**.
 3. Click **Disable SAML SSO**.
 
-
-## Troubleshoot SSO [ec_troubleshoot_sso]
-
-
-### SSO screen is not redirecting to my IdP [ec_sso_screen_is_not_redirecting_to_my_idp]
-
-Double check the `saml_idp.sso_url` provided during IdP registration. This should be the HTTP-POST binding URL to your IdP’s SAML application. {{ecloud}} will redirect to this URL during sign in.
-
-
-### Failure to redirect back to {{ecloud}} after IdP log in, or redirected to `/access-denied` [ec_failure_to_redirect_back_to_ecloud_after_idp_log_in_or_redirected_to_access_denied]
-
-There could be a variety of issues that might result in sign in failure. Try tracing the SAML request and response with a SAML tracer. You should see a `SAMLRequest` field when redirecting to your IdP, and a `SAMLResponse` field when redirecting to the Cloud ACS.
-
-If there was an error in your IdP, there may be a non-success `Status` field which should describe the error that occurred.
-
-If the SAML response was successful, double-check the components of the SAML response:
-
-* The `Destination` and `Recipient` should match the `acs` provided by the {{ecloud}} IdP registration API.
-* An `AttributeStatement` named `email` should be sent with the email matching a domain claimed by your {{ecloud}} organization. If the domain of the email doesn’t match a claimed domain, the authentication flow will not complete.
-* The `AudienceRestriction` `Audience` should match the `sp_entity_id` provided by the {{ecloud}} IdP registration API.
-* The `Issuer` should match the value provided to the {{ecloud}} IdP registration API.
-* The signature of the SAML response should be verifiable by the certificate provided during IdP configuration in Cloud.
+## Resources
+[](/troubleshoot/deployments/elastic-cloud/sso.md)
diff --git a/solutions/search/inference-api/alibabacloud-ai-search-inference-integration.md b/solutions/search/inference-api/alibabacloud-ai-search-inference-integration.md
@@ -9,10 +9,9 @@ applies:
 
 # AlibabaCloud AI Search inference integration [infer-service-alibabacloud-ai-search]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::  
 
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `alibabacloud-ai-search` service.
diff --git a/solutions/search/inference-api/amazon-bedrock-inference-integration.md b/solutions/search/inference-api/amazon-bedrock-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Amazon Bedrock inference integration [infer-service-amazon-bedrock]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `amazonbedrock` service.
 
diff --git a/solutions/search/inference-api/anthropic-inference-integration.md b/solutions/search/inference-api/anthropic-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Anthropic inference integration [infer-service-anthropic]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `anthropic` service.
 
diff --git a/solutions/search/inference-api/azure-ai-studio-inference-integration.md b/solutions/search/inference-api/azure-ai-studio-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Azure AI Studio inference integration [infer-service-azure-ai-studio]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `azureaistudio` service.
 
diff --git a/solutions/search/inference-api/azure-openai-inference-integration.md b/solutions/search/inference-api/azure-openai-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Azure OpenAI inference integration [infer-service-azure-openai]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `azureopenai` service.
 
diff --git a/solutions/search/inference-api/chat-completion-inference-api.md b/solutions/search/inference-api/chat-completion-inference-api.md
@@ -9,10 +9,9 @@ applies:
 
 # Chat completion inference API [chat-completion-inference-api]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Streams a chat completion response.
 
diff --git a/solutions/search/inference-api/cohere-inference-integration.md b/solutions/search/inference-api/cohere-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Cohere inference integration [infer-service-cohere]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `cohere` service.
 
diff --git a/solutions/search/inference-api/elastic-inference-service-eis.md b/solutions/search/inference-api/elastic-inference-service-eis.md
@@ -9,11 +9,9 @@ applies:
 
 # Elastic Inference Service (EIS) [infer-service-elastic]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `elastic` service.
 
diff --git a/solutions/search/inference-api/elasticsearch-inference-integration.md b/solutions/search/inference-api/elasticsearch-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Elasticsearch inference integration [infer-service-elasticsearch]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `elasticsearch` service.
 
diff --git a/solutions/search/inference-api/elser-inference-integration.md b/solutions/search/inference-api/elser-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # ELSER inference integration [infer-service-elser]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `elser` service. You can also deploy ELSER by using the [Elasticsearch {{infer}} integration](elasticsearch-inference-integration.md).
 
diff --git a/solutions/search/inference-api/google-ai-studio-inference-integration.md b/solutions/search/inference-api/google-ai-studio-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Google AI Studio inference integration [infer-service-google-ai-studio]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `googleaistudio` service.
 
diff --git a/solutions/search/inference-api/google-vertex-ai-inference-integration.md b/solutions/search/inference-api/google-vertex-ai-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Google Vertex AI inference integration [infer-service-google-vertex-ai]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `googlevertexai` service.
 
diff --git a/solutions/search/inference-api/huggingface-inference-integration.md b/solutions/search/inference-api/huggingface-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # HuggingFace inference integration [infer-service-hugging-face]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `hugging_face` service.
 
diff --git a/solutions/search/inference-api/jinaai-inference-integration.md b/solutions/search/inference-api/jinaai-inference-integration.md
@@ -9,10 +9,9 @@ applies:
 
 # JinaAI inference integration [infer-service-jinaai]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `jinaai` service.
 
diff --git a/solutions/search/inference-api/mistral-inference-integration.md b/solutions/search/inference-api/mistral-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Mistral inference integration [infer-service-mistral]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `mistral` service.
 
diff --git a/solutions/search/inference-api/openai-inference-integration.md b/solutions/search/inference-api/openai-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # OpenAI inference integration [infer-service-openai]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `openai` service.
 
diff --git a/solutions/search/inference-api/watsonx-inference-integration.md b/solutions/search/inference-api/watsonx-inference-integration.md
@@ -9,11 +9,9 @@ applies:
 
 # Watsonx inference integration [infer-service-watsonx-ai]
 
-::::{admonition} New API reference
-For the most up-to-date API details, refer to [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference).
-
-::::
-
+:::{tip} Inference API reference  
+Refer to the [{{infer-cap}} APIs](https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-inference) for further information.  
+:::
 
 Creates an {{infer}} endpoint to perform an {{infer}} task with the `watsonxai` service.
 
diff --git a/solutions/search/retrievers-examples.md b/solutions/search/retrievers-examples.md
@@ -401,8 +401,7 @@ Which would return the following results:
 
 ## Example: Grouping results by year with `collapse` [retrievers-examples-collapsing-retriever-results]
 
-In our result set, we have many documents with the same `year` value. We can clean this up using the `collapse` parameter with our retriever. This, as with the standard 
-% [collapse](/raw-migrated-files/elasticsearch/elasticsearch-reference/collapse-search-results.md) feature,
+In our result set, we have many documents with the same `year` value. We can clean this up using the `collapse` parameter with our retriever. This, as with the standard [collapse](https://www.elastic.co/guide/en/elasticsearch/reference/current/collapse-search-results.html) feature,
 enables grouping results by any field and returns only the highest-scoring document from each group. In this example we’ll collapse our results based on the `year` field.
 
 ```console
@@ -552,9 +551,7 @@ This returns the following response with collapsed results.
 
 ## Example: Highlighting results based on nested sub-retrievers [retrievers-examples-highlighting-retriever-results]
 
-Highlighting is now also available for nested sub-retrievers matches. For example, consider the same `rrf` retriever as above, with a `knn` and `standard` retriever as its sub-retrievers. We can specify a `highlight` section,
-% TODO URL as defined in the [highlighting](/raw-migrated-files/elasticsearch/elasticsearch-reference/highlighting.md) documentation, 
-and compute highlights for the top results.
+Highlighting is now also available for nested sub-retrievers matches. For example, consider the same `rrf` retriever as above, with a `knn` and `standard` retriever as its sub-retrievers. We can specify a `highlight` section, as defined in the [highlighting](https://www.elastic.co/guide/en/elasticsearch/reference/current/highlighting.html) documentation, and compute highlights for the top results.
 
 ```console
 GET /retrievers_example/_search
@@ -751,9 +748,7 @@ POST /retrievers_example_nested/_doc/3
 POST /retrievers_example_nested/_refresh
 ```
 
-Now we can run an `rrf` retriever query and also compute inner hits
-% TODO URL [inner hits](/raw-migrated-files/elasticsearch/elasticsearch-reference/inner-hits.md)
-for the `nested_field.nested_vector` field, based on the `knn` query specified.
+Now we can run an `rrf` retriever query and also compute [inner hits](https://www.elastic.co/guide/en/elasticsearch/reference/current/inner-hits.html) for the `nested_field.nested_vector` field, based on the `knn` query specified.
 
 ```console
 GET /retrievers_example_nested/_search
@@ -1276,10 +1271,7 @@ The output of which, albeit a bit verbose, will provide all the necessary info t
 
 ## Example: Rerank results of an RRF retriever [retrievers-examples-text-similarity-reranker-on-top-of-rrf]
 
-To demonstrate the full functionality of retrievers, the following examples also require access to a semantic reranking model
-% TODO URL  [semantic reranking model](/raw-migrated-files/elasticsearch/elasticsearch-reference/semantic-reranking.md#semantic-reranking-models)
-set up using the inference APIs.
-% [Elastic inference APIs](/raw-migrated-files/elasticsearch/elasticsearch-reference/inference-apis.md).
+To demonstrate the full functionality of retrievers, the following examples also require access to a [semantic reranking model](https://www.elastic.co/guide/en/elasticsearch/reference/current/semantic-reranking.html) set up using the [Elastic inference APIs](https://www.elastic.co/guide/en/elasticsearch/reference/current/inference-apis.html).
 
 In this example we’ll set up a reranking service and use it with the `text_similarity_reranker` retriever to rerank our top results.
 
diff --git a/troubleshoot/deployments/elastic-cloud/sso.md b/troubleshoot/deployments/elastic-cloud/sso.md
@@ -0,0 +1,27 @@
+---
+navigation_title: "SAML single sign-on (SSO)"
+mapped_pages:
+  - https://www.elastic.co/guide/en/cloud/current/ec-saml-sso.html
+---
+
+# Troubleshoot {{ecloud}} SSO [ec_troubleshoot_sso]
+
+
+## SSO screen is not redirecting to my IdP [ec_sso_screen_is_not_redirecting_to_my_idp]
+
+Double check the `saml_idp.sso_url` provided during IdP registration. This should be the HTTP-POST binding URL to your IdP’s SAML application. {{ecloud}} will redirect to this URL during sign in.
+
+
+## Failure to redirect back to {{ecloud}} after IdP log in, or redirected to `/access-denied` [ec_failure_to_redirect_back_to_ecloud_after_idp_log_in_or_redirected_to_access_denied]
+
+There could be a variety of issues that might result in sign in failure. Try tracing the SAML request and response with a SAML tracer. You should see a `SAMLRequest` field when redirecting to your IdP, and a `SAMLResponse` field when redirecting to the Cloud ACS.
+
+If there was an error in your IdP, there may be a non-success `Status` field which should describe the error that occurred.
+
+If the SAML response was successful, double-check the components of the SAML response:
+
+* The `Destination` and `Recipient` should match the `acs` provided by the {{ecloud}} IdP registration API.
+* An `AttributeStatement` named `email` should be sent with the email matching a domain claimed by your {{ecloud}} organization. If the domain of the email doesn’t match a claimed domain, the authentication flow will not complete.
+* The `AudienceRestriction` `Audience` should match the `sp_entity_id` provided by the {{ecloud}} IdP registration API.
+* The `Issuer` should match the value provided to the {{ecloud}} IdP registration API.
+* The signature of the SAML response should be verifiable by the certificate provided during IdP configuration in Cloud.
diff --git a/troubleshoot/toc.yml b/troubleshoot/toc.yml
@@ -112,6 +112,7 @@ toc:
       - file: deployments/serverless.md
       - file: deployments/elastic-cloud.md
         children:
+          - file: deployments/elastic-cloud/sso.md
           - file: deployments/elastic-cloud/monitoring.md
       - file: deployments/cloud-enterprise/cloud-enterprise.md
         children:
