From 088383762569afff04ad1c042519a2054ccdb72b Mon Sep 17 00:00:00 2001
From: Motouom Victoire <motouomvictor@gmail.com>
Date: Mon, 2 Dec 2024 13:12:31 +0100
Subject: [PATCH] feat: getting minimal config from exported json

---
 docs/config/minimal-configuration.md | 67 ++++++++++++++++++++++++++++
 mkdocs.yml                           |  1 +
 2 files changed, 68 insertions(+)
 create mode 100644 docs/config/minimal-configuration.md

diff --git a/docs/config/minimal-configuration.md b/docs/config/minimal-configuration.md
new file mode 100644
index 000000000..386e9108a
--- /dev/null
+++ b/docs/config/minimal-configuration.md
@@ -0,0 +1,67 @@
+## Getting Minimal Import After Realm Export
+
+This script is designed to clean up a Keycloak realm configuration file (in JSON format) by removing unnecessary fields, including all `id` fields, from the configuration. It is useful for simplifying the export of Keycloak realm data, especially when certain details like IDs are not needed for sharing or backup purposes.
+
+### Features
+
+- **Removes unnecessary default fields** such as `accessTokenLifespan`, `offlineSessionIdleTimeout`, and others that are typically not needed for a reimport.
+- **Simplifies the realm configuration** while retaining all necessary properties for further processing or importing into another Keycloak instance.
+
+### Requirements
+
+- **jq**: This script requires `jq`, a command-line JSON processor, to manipulate the JSON data.
+
+  You can install `jq` using the following commands:
+
+    - On Ubuntu/Debian:
+      ```bash
+      sudo apt-get install jq
+      ```
+    - On macOS (with Homebrew):
+      ```bash
+      brew install jq
+      ```
+
+### Usage
+
+Ensure you have the Keycloak realm configuration file (in JSON format) that you want to clean. The file should be named `realm-config.json` or you can modify the script to use your desired file path.
+
+### Download or Copy the Script
+
+```bash
+#!/bin/bash
+
+INPUT_FILE="realm-config.json"
+OUTPUT_FILE="keycloak-realm-export-minimal.json"
+
+jq 'del(
+  .id, .containerId, .accessTokenLifespanForImplicitFlow,
+  .accessTokenLifespanForWebApps, .accessTokenLifespan, .offlineSessionIdleTimeout,
+  .accessTokenLifespanInSeconds, .ssoSessionIdleTimeout, .ssoSessionMaxLifespan,
+  .ssoSessionIdleTimeoutRememberMe, .ssoSessionMaxLifespanRememberMe,
+  .accessCodeLifespan, .accessCodeLifespanLogin, .accessCodeLifespanUserAction,
+  .accessCodeLifespanMobile, .notBefore, .registrationAllowed,
+  .registrationEmailAsUsername, .rememberMe, .verifyEmail, .resetPasswordFlow,
+  .editUsernameAllowed, .bruteForceProtected, .permanentLockout, .maxFailureWaitSeconds,
+  .minimumQuickLoginWaitSeconds, .waitIncrementSeconds, .quickLoginCheckMilliSeconds,
+  .maxDeltaTimeSeconds, .failureFactor, .requiredCredentials, .otpPolicyType,
+  .otpPolicyAlgorithm, .otpPolicyInitialCounter, .otpPolicyDigits, .otpPolicyLookAheadWindow,
+  .otpPolicyPeriod, .otpSupportedApplications, .webAuthnPolicyRpEntityName,
+  .webAuthnPolicyAttestationConveyancePreference, .webAuthnPolicyAuthenticatorAttachment,
+  .webAuthnPolicyRequireResidentKey, .webAuthnPolicyUserVerificationRequirement,
+  .webAuthnPolicyCreateTimeout, .webAuthnPolicyAssertionTimeout,
+  .webAuthnPolicyRegistrationRecoveryEnabled, .webAuthnPolicyRegistrationRecoveryCodesQuantity,
+  .webAuthnPolicyRegistrationTokenBindingRequired, .webAuthnPolicyRegistrationAttestationConveyancePreference,
+  .webAuthnPolicyRegistrationAuthenticatorSelectionCriteria, .keys
+) 
+| walk(if type == "object" then del(.id) else . end)' < "$INPUT_FILE" > "$OUTPUT_FILE"
+
+echo "Minimal export saved to $OUTPUT_FILE"
+```
+
+### make the script executable
+```bash
+    chmod +x clean-realm-config.sh
+```
+
+Now execute the script, making sure that you have inputed the correct file paths.
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 0e87f6abd..fdb64764e 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -51,6 +51,7 @@ nav:
   - Use Cases:
       - Remote State Management: config/remote-state-management.md
       - Adding Multiple post.logout.redirect.uris: config/addind-multiple-post-logout-redirect-uris.md
+      - Minimal Configurations From exported JSON: config/minimal-configuration.md
 
 
 markdown_extensions: