diff --git a/website/content/docs/glossary.mdx b/website/content/docs/glossary.mdx index 5e6cb515f..c189393c5 100644 --- a/website/content/docs/glossary.mdx +++ b/website/content/docs/glossary.mdx @@ -15,6 +15,7 @@ documentation for Vault. - [Auth Method](#auth-method) - [Barrier](#barrier) - [Client Token](#client-token) +- [Plugin](#plugin) - [Secret](#secret) - [Secrets Engine](#secrets-engine) - [Server](#server) @@ -49,6 +50,32 @@ returns a client token which is used for future requests. The token is used by Vault to verify the identity of the client and to enforce the applicable ACL policies. This token is passed via HTTP headers. +### Plugin + +Plugins are a feature of Vault that can be enabled, disabled, and customized to +some degree. All Vault [auth methods](/docs/auth) and [secrets engines](/docs/secrets) +are considered plugins. + +#### Built-in Plugin + +Built-in plugins are shipped with Vault, often for commonly used +implementations, and require no additional operator intervention to run. +Built-in plugins are just like any other backend code inside Vault. + +#### External Plugin + +External plugins are not shipped with Vault and require additional operator +intervention to run. Vault's external plugins are completely separate, +standalone applications that Vault executes and communicates with over RPC. +Each time a Vault secret engine or auth method is mounted, a new process is +spawned. + +#### External Multiplexed Plugin + +An external plugin may make use of [plugin multiplexing](/docs/plugins/plugin-architecture#plugin-multiplexing). +A multiplexed plugin allows a single plugin process to be used for multiple +mounts of the same type. + ### Secret A secret is the term for anything returned by Vault which diff --git a/website/content/docs/plugins/plugin-architecture.mdx b/website/content/docs/plugins/plugin-architecture.mdx index a00a54b95..484080203 100644 --- a/website/content/docs/plugins/plugin-architecture.mdx +++ b/website/content/docs/plugins/plugin-architecture.mdx @@ -161,7 +161,7 @@ opt-out capability for plugins that implement multiplexing. To use a non-multiplexed plugin, run an older version of the plugin, i.e., the plugin calls the `dbplugin.Serve` function. More details on implementing plugin multiplexing can be found in -[Upgrading Vault Plugins](/docs/secrets/databases/custom#serving-a-plugin-with-multiplexing). +[Serving a Multiplexed Plugin](/docs/secrets/databases/custom#serving-a-plugin-with-multiplexing). ## Troubleshooting