From bec4bf699922558df98c6a89a843ae1efa4c0315 Mon Sep 17 00:00:00 2001
From: Pedro Igor <pigor.craveiro@gmail.com>
Date: Tue, 19 Oct 2021 19:24:28 -0300
Subject: [PATCH] [KEYCLOAK-19303] - Allow managing providers through CLI

---
 design/keycloak.x/configuration.md | 85 ++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/design/keycloak.x/configuration.md b/design/keycloak.x/configuration.md
index d9ceddb..bd24f5d 100644
--- a/design/keycloak.x/configuration.md
+++ b/design/keycloak.x/configuration.md
@@ -563,6 +563,91 @@ Examples of commands are:
 Commands may support additional options to change how they are executed and behavior. For that, commands should provide the
 help and usage messages to document how they can be used as well as the different options they support. 
 
+### The `provider` command
+
+The `provider` command provides utilities to query, (un)install, and enable/disable providers. The usage of this command is the following:
+
+```
+kc.[sh|bat] spi [list-spi|list] [
+```
+
+By running `kc.[sh|bat] provider`, the CLI should list all installed providers:
+
+```
+Listing installed providers (default action, see --help).                                                                                                                                              
+Current Keycloak default providers:
+
+hostname
+        Default: default
+        Provider (name: default, factory: class org.keycloak.url.DefaultHostnameProviderFactory)
+
+localeSelector
+        Default: default
+        Provider (name: default, factory: class org.keycloak.locale.DefaultLocaleSelectorProviderFactory)
+
+localeUpdater
+        Default: default
+        Provider (name: default, factory: class org.keycloak.locale.DefaultLocaleUpdaterProviderFactory)
+
+To get more information, including the complete list of providers for a SPI, append `--full` to your command line.
+
+To get information about providers for a specific SPI, append `--spi <spi>` to your command line.
+```
+
+To get more information about each SPI, it should be possible to run `kc.[sh|bat] list-spi`: 
+
+```
+Listing available SPI (default action, see --help).                                                                                                                                              
+Current Keycloak SPI available:
+
+role
+
+loginFailure
+
+userCache SPI
+
+cekmanagement SPI
+
+To get more information, append `--full` to your command line.
+```
+
+When running `list-spi` with the `--full` option, more details are displayed as follows:
+
+```
+localeUpdater
+ Factory: interface org.keycloak.locale.LocaleUpdaterProviderFactory
+ Interface: interface org.keycloak.locale.LocaleUpdaterProvider
+ Enabled: true
+
+storage
+ Factory: interface org.keycloak.storage.UserStorageProviderFactory
+ Interface: interface org.keycloak.storage.UserStorageProvider
+ Enabled: true
+
+themeSelector
+ Factory: interface org.keycloak.theme.ThemeSelectorProviderFactory
+ Interface: interface org.keycloak.theme.ThemeSelectorProvider
+ Enabled: true
+```
+
+In order to obtain details about providers for a specific SPI, it should be possible to run `kc.[sh|bat] provider --spi cekmanagement --full`:
+
+```
+Current providers installed for "cekmanagement" SPI:
+
+Default: undefined
+Provider (name: RSA-OAEP, factory: class org.keycloak.crypto.RsaesOaepCekManagementProviderFactory)
+Provider (name: RSA-OAEP-256, factory: class org.keycloak.crypto.RsaesOaep256CekManagementProviderFactory)
+Provider (name: RSA1_5, factory: class org.keycloak.crypto.RsaesPkcs1CekManagementProviderFactory)
+```
+
+The `provider` command should provide the following sub-commands:
+
+* `enabled`, to enabled providers
+* `disabled`, to disabled providers
+* 'install', to install a provider
+* 'uninstall', to install a provider
+
 ## Documentation
 
 All options and commands should be documented properly to make it easy for users to discover what can be configured and which actions can be performed. This