Skip to content
/ AIO-SSL-Tool Public

README.md

Latest commit

 

History

History
249 lines (186 loc) · 7.06 KB

README.md

File metadata and controls

249 lines (186 loc) · 7.06 KB
Raw

AIO SSL Tool - macOS Native Version

A modern, native macOS application for SSL certificate management built with Swift and SwiftUI.

Features

  • Certificate Chain Building: Automatically build complete certificate chains from any certificate
  • CSR Generation: Generate Certificate Signing Requests with custom details and SANs
  • Private Key Management: Extract private keys from PFX/P12 files
  • PFX Creation: Create PFX files from certificates and private keys
  • Automatic Updates: Built-in automatic updates powered by Sparkle framework
  • Native macOS Integration: Uses macOS Security framework and system keychain
  • Modern UI: Built with SwiftUI for a native macOS experience

Automatic Updates

The app includes seamless automatic updates using the Sparkle framework:

  • Updates check automatically in the background
  • One-click installation replaces existing app
  • Configurable in Settings > Updates
  • EdDSA-signed for security

For Developers: See AUTO_UPDATE_QUICKSTART.md for setup instructions.

Requirements

  • macOS: 13.0 (Ventura) or later
  • Xcode: 14.0 or later
  • Swift: 5.7 or later

Building from Source

Option 1: Using Xcode

  1. Open the project:

    cd macOS/AIOSSLTool
open AIOSSLTool.xcodeproj

    If the project file doesn't exist, create it:

    cd macOS/AIOSSLTool
swift package init --type executable --name AIOSSLTool

  2. In Xcode:

    • Select your development team in Signing & Capabilities
    • Choose your target device (Any Mac)
    • Press ⌘R to build and run

Option 2: Command Line Build

cd macOS/AIOSSLTool
swift build -c release

The compiled binary will be in .build/release/AIOSSLTool

Creating an App Bundle

To create a proper macOS app bundle:

  1. Open in Xcode
  2. Product → Archive
  3. Distribute App → Copy App
  4. The .app bundle will be exported to your chosen location

Project Structure

macOS/AIOSSLTool/
├── AIOSSLToolApp.swift          # Main app entry point
├── ContentView.swift             # Main interface
├── ViewModels/
│   └── SSLToolViewModel.swift   # Business logic and state management
├── Views/
│   ├── CSRGenerationView.swift  # CSR generation dialog
│   ├── ExtractPFXView.swift     # PFX extraction dialog
│   └── SettingsView.swift       # Settings/About view
├── Utils/
│   └── CertificateUtils.swift   # Certificate operations using Security framework
├── Info.plist                    # App configuration
└── AIOSSLTool.entitlements      # Security entitlements

Creating the Xcode Project

If you need to create the Xcode project from scratch:

cd /Users/cameron/Documents/GitHub/AIO-SSL-Tool
mkdir -p macOS/AIOSSLTool
cd macOS/AIOSSLTool

# Create the Swift package
cat > Package.swift << 'EOF'
// swift-tools-version: 5.7
import PackageDescription

let package = Package(
    name: "AIOSSLTool",
    platforms: [.macOS(.v13)],
    products: [
        .executable(name: "AIOSSLTool", targets: ["AIOSSLTool"])
    ],
    targets: [
        .executableTarget(
            name: "AIOSSLTool",
            path: ".",
            exclude: ["Info.plist"],
            swiftSettings: [
                .unsafeFlags(["-parse-as-library"])
            ]
        )
    ]
)
EOF

Alternatively, create an Xcode project:

# Generate Xcode project
swift package generate-xcodeproj

# Or create a new Xcode project
# File → New → Project → macOS → App
# - Product Name: AIOSSLTool
# - Interface: SwiftUI
# - Language: Swift
# - Include Tests: No

Manual Xcode Project Setup

  1. Create New Project:

    • Open Xcode
    • File → New → Project
    • Choose "App" under macOS
    • Product Name: AIOSSLTool
    • Interface: SwiftUI
    • Language: Swift

  2. Add Source Files:

    • Drag all .swift files from the repository into the project
    • Ensure "Copy items if needed" is checked
    • Organize into groups matching the directory structure

  3. Configure Signing:

    • Select project in navigator
    • Select AIOSSLTool target
    • Signing & Capabilities tab
    • Choose your Team and Bundle Identifier

  4. Add Entitlements (if needed):

    • Signing & Capabilities → + Capability
    • Add "Keychain Sharing" if accessing system keychain
    • Add "File Access" for reading/writing certificates

  5. Build Settings:

    • Set minimum deployment target: macOS 13.0
    • Enable "Hardened Runtime"

Usage

  1. Launch the app
  2. Select Save Location: Choose where to save generated files
  3. Browse Certificate: Load your SSL certificate
  4. Create Full Chain: Build the complete certificate chain
  5. Add Private Key: Load or generate a private key
  6. Create PFX: Generate a PFX file with password protection

Additional Features

  • File → Generate CSR and Private Key: Create new CSR with custom details
  • File → Extract Private Key from PFX/P12: Extract keys from existing PFX files

Security Notes

  • The app uses macOS Security framework for certificate operations
  • Private keys are handled securely in memory
  • Password-protected keys and PFX files are supported
  • The app requires appropriate file system permissions

Differences from Python Version

This native macOS version offers several advantages:

  1. Better Performance: Native code runs faster than interpreted Python
  2. Native UI: SwiftUI provides native macOS controls and appearance
  3. System Integration: Direct access to macOS keychain and certificate stores
  4. No Dependencies: No need to install Python or external libraries
  5. App Store Ready: Can be distributed through Mac App Store
  6. Sandboxing: Supports macOS security features like sandboxing

Technical Implementation

  • Security Framework: Uses SecCertificate, SecKey, and SecTrust APIs
  • SwiftUI: Modern declarative UI framework
  • Combine: Reactive state management
  • async/await: Modern Swift concurrency for certificate operations

Troubleshooting

"Developer Cannot Be Verified"

If you get this error when opening the app:

xattr -cr /path/to/AIOSSLTool.app

Code Signing Issues

Ensure you have a valid Developer ID or run in Debug mode with your development certificate.

Missing Entitlements

If the app can't access files or keychain:

  1. Check Signing & Capabilities in Xcode
  2. Add required entitlements (File Access, Keychain)

Contributing

To contribute to the macOS version:

  1. Maintain compatibility with macOS 13+
  2. Follow Swift style guidelines
  3. Use SwiftUI for all UI components
  4. Leverage native Security framework APIs
  5. Test on multiple macOS versions

License

Same as the original Python version - check LICENSE file in repository root.

Version History

  • v6.0 (2026): Initial macOS native version
    • Complete rewrite in Swift and SwiftUI
    • Native Security framework integration
    • Modern macOS design language

Credits

Ported from the original Python version by CMDLAB. macOS version utilizes Apple's Security framework for industrial-strength cryptography.