Skip to content
dc.
Back to selected work

Open-source project

Secure Keys: iOS Configuration Automation

A Ruby CLI for generating iOS configuration frameworks from local and CI secret sources.

RubySwiftCI/CD

2 min read

At a glance

Organization
Independent open source
My role
Project author
Period
Open-source engineering
a repeatable framework-generation workflow
Local → CI → iOS

Project capabilities are documented in the linked public repositories. Production adoption is not implied.

From configuration to artifact
$ secure-keys env generate staging
SecureKeys.xcframework
Keychain / CISwift APIiOS
Xcode showing SecureKeys.xcframework configured as Embed and Sign
Integration screenshot from the project documentation, showing the generated framework added to an Xcode target. Inspect source
Xcode showing SecureKeys.xcframework configured as Embed and Sign

Integration screenshot from the project documentation, showing the generated framework added to an Xcode target.

The problem

iOS build configuration needs to work on a developer’s machine and in CI. Repeated manual setup can make environment management difficult to reproduce.

Secure Keys packages a configuration-generation workflow into a command-line tool.

How it works

The Ruby CLI reads supplied values from macOS Keychain locally or environment variables in CI. It encrypts the values with AES-256-GCM, generates a Swift API, and builds an XCFramework for the iOS application.

The documented environment workflow supports distinct configuration sets, output paths, and comparison of environment key lists. Distribution options include RubyGems and Homebrew.

Try the generation workflow

On macOS with Ruby 3.3+ and Xcode command-line tools installed, run this example from an iOS project directory. It uses an illustrative API origin, so it does not require creating credentials or writing to Keychain.

gem install secure-keys
SECURE_KEYS_IDENTIFIER=apiOrigin APIORIGIN=https://example.invalid secure-keys --ci

The documented output is .secure-keys/SecureKeys.xcframework. Add the framework to the application target, as shown above, then read the generated value from Swift:

import SecureKeys

let apiOrigin = SecureKey.apiOrigin.decryptedValue

This is a reproducible usage example from the pinned CLI documentation, not a captured build transcript. Building an XCFramework requires the Apple toolchain; the portfolio itself runs no Ruby commands.

Decisions and boundaries

Adapt to the source. Local Keychain and CI environment variables serve different execution contexts; the tool brings them into one generation workflow.

Generate a usable artifact. Producing an XCFramework connects the CLI to the application build rather than leaving integration as an undocumented manual task.

Make environments explicit. Named configuration sets help describe which keys belong to which build context.

Security scope

Encrypted values embedded in a client application remain recoverable by a sufficiently capable attacker. This workflow does not turn an iOS application into a secure vault or replace server-side secret management.

Keys that must remain confidential belong on a trusted backend. The project’s value is build automation and configuration handling, with that client-side boundary understood.

Evidence

The public repository documents installation, CLI usage, framework generation, and environment management. No production adoption or security certification is claimed here.

05 Let’s connect

Good work starts
with a conversation.

Have a challenging engineering problem, a role in mind, or an idea worth exploring? I’d like to hear about it.

derian.cordoba@icloud.com

Based in Nicaragua · Working with international teams

Let’s talk

Send a short introduction

Have a role, a collaboration, or a technical challenge in mind? Share a little context to start the conversation.

Opportunities · Collaboration · Engineering

Prefer to write directly?

derian.cordoba@icloud.com

All fields are required.

Your name, email, and message are processed by Netlify Forms to deliver your inquiry. Please avoid confidential information.