From f29e7214d36e73a33559bc81e572c5ad13b37cc6 Mon Sep 17 00:00:00 2001 From: Tim Vernum Date: Tue, 8 Feb 2022 11:46:56 +1100 Subject: [PATCH] Document removal of custom REST wrappers in 8.0 (#83565) In #71061 we removed support for custom REST Handler Wrappers. This change adds that information to the migration guide under the "Plugin changes" section --- .../migrate_8_0/plugin-changes.asciidoc | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/reference/migration/migrate_8_0/plugin-changes.asciidoc b/docs/reference/migration/migrate_8_0/plugin-changes.asciidoc index f4ac2bcf6a9ab..4955cfc189504 100644 --- a/docs/reference/migration/migrate_8_0/plugin-changes.asciidoc +++ b/docs/reference/migration/migrate_8_0/plugin-changes.asciidoc @@ -45,4 +45,26 @@ If you run {es} using Docker and you are managing plugins using a they already installed. If any of these plugins are specified in your configuration file, {es} will ignore them and emit a warning log message. ==== + +.Third party plugins can no longer intercept REST requests (`RestHandlerWrapper`) +[%collapsible] +==== +*Details* + +In previous versions of {es}, third-party plugins could implement the +`getRestHandlerWrapper` method to intercept all REST requests to the node. A +common use of this feature was to implement custom security plugins to replace +the built-in {security-features}. This extension point is no longer available +to third-party plugins. + + +*Impact* + +Some third-party plugins that were designed to work with earlier versions of +{es} might not be compatible with {es} version 8.0 or later. + +If you depend on any plugins that are not produced and supported by Elastic, +check with the plugin author and ensure that the plugin is available for your +target version of {es} before upgrading. + +==== + //end::notable-breaking-changes[]