bytehide-shield-ios 1.0.5

iOS application protection: obfuscation, encryption, and runtime security for .ipa files

ByteHide Shield for iOS

Enterprise-grade protection for iOS applications. Shield for iOS secures your .ipa binaries against reverse engineering, tampering, debugging, and runtime attacks — all as a post-build step, with no source code changes required.

Installation

pip install bytehide-shield-ios

Quick Start

# 1. Initialize configuration
shield-ios init

# 2. Add your project token to shield-ios.json

# 3. Protect your app
shield-ios protect MyApp.ipa

A valid ByteHide project token is required. See the documentation to get started.

Protections

Protection	Description
Anti-Debug	Prevents debugger attachment via ptrace, sysctl, and process inspection
Anti-Jailbreak	Detects jailbroken environments with configurable sensitivity levels
String Encryption	Encrypts string constants in the binary with runtime decryption
Symbol Renaming	Renames classes, methods, and properties to strip meaningful identifiers
Swift Symbol Stripping	Removes Swift metadata, debug symbols, and reflection info
Control Flow Obfuscation	Restructures code logic to resist static analysis
Class Encryption	Encrypts Objective-C class metadata
Resource Encryption	Encrypts bundled assets, plists, storyboards, and nibs (AES-256)
RASP	Runtime Application Self-Protection — see ByteHide Monitor

Configuration

Create a shield-ios.json in your project directory:

{
  "projectToken": "your-token-here",
  "protections": {
    "anti_debug": true,
    "anti_jailbreak": {
      "enabled": true,
      "sensitivity": 1
    },
    "string_encryption": true,
    "symbol_renaming": true,
    "swift_stripping": true,
    "control_flow": "light",
    "resource_encryption": true
  }
}

CLI Reference

shield-ios protect <input.ipa> [--output <output.ipa>] [--config <config.json>] [-v]
shield-ios init
shield-ios version

Requirements

• Python 3.9 or later
• macOS (recommended for code signing) or Linux
• Active ByteHide subscription

Documentation

Full documentation, guides, and API reference:

docs.bytehide.com/platforms/ios/products/shield

License

This software is proprietary and requires a commercial license. See LICENSE for details.

Copyright 2024-2026 ByteHide Solutions S.L. All rights reserved.