Google Secrets +
Google Secret Manager integration for BoxLang system settings via the google. namespace in getSystemSetting().
The bx-google-secrets module registers a google system setting provider so BoxLang can resolve secrets directly from Google Secret Manager using getSystemSetting().
✨ Features
Resolve secrets with
getSystemSetting( "google.SECRET_NAME" )3-tier configuration resolution per setting:
this.googleinApplication.bx, module settings, then Google environment variables/Application Default CredentialsIn-memory TTL caching to reduce Secret Manager API calls
Per-application
SecretManagerServiceClientisolation whenthis.googleis definedAutomatic client cleanup on application shutdown
Graceful fallback behavior: returns
nullon provider errors so normalgetSystemSetting()fallback continues
📦 Requirements
BoxLang 1.14+
bx-plusmoduleGoogle Cloud project with Secret Manager enabled
Google identity with
secretmanager.versions.accesspermission
🚀 Installation
Via CommandBox
Via BoxLang OS Binary
⚡ Quick Start
Install and activate
bx-plusandbx-google-secretsConfigure credentials through
this.google, module settings, or Google Application Default CredentialsResolve secrets with
google.namespaced keys
⚙️ Basic Configuration
Use module settings in boxlang.json when you want global defaults:
For per-app overrides and local development examples, see Configuration & Usage.
🔍 How Secret Resolution Works
For getSystemSetting( "google.MY_SECRET" ), the provider:
Resolves effective Google settings (3-tier lookup)
Checks in-memory cache using
projectId:secretNameCalls Google Secret Manager when cache is stale/missing
Caches and returns the secret value
Returns
nullon lookup failure, allowing standard BoxLang fallback behavior
🔗 Related Documentation
Configuration & UsageModulesPlus CoreLast updated
Was this helpful?
