GCP Secret Supplier

kairo-gcp-secret-supplier is a lightweight wrapper around Google Secret Manager, making access through Kotlin idiomatic and coroutine-friendly. No more blocking calls on event loops!

gcpSecretSupplier["projects/012345678900/secrets/example/versions/1"]

Installation

Install kairo-gcp-secret-supplier. You can also install kairo-gcp-secret-supplier-testing for testing.

build.gradle.kts

dependencies {
  implementation("software.airborne.kairo:kairo-gcp-secret-supplier")
  testImplementation("software.airborne.kairo:kairo-gcp-secret-supplier-testing")
}

Usage

Use DefaultGcpSecretSupplier in production.

val gcpSecretSupplier: GcpSecretSupplier = DefaultGcpSecretSupplier()
val value = gcpSecretSupplier["projects/012345678900/secrets/example/versions/1"]

The result is either the value of the GCP secret, or null if the GCP secret does not exist.

Testing

Use alternative implementations to simplify testing.

• NoopGcpSecretSupplier: Always throws NotImplementedError.
• FakeGcpSecretSupplier: Allows you to set GCP secret values manually.
• Custom implementations: Implement GcpSecretSupplier.

Logging config

We recommend excluding logs below the INFO level for this library.

<Logger name="kairo.gcpSecretSupplier" level="info"/>