Project Token

The project token connects your Shield builds to the ByteHide Cloud Panel. It is required for license validation, build analytics, and stack trace deobfuscation.

Create Your Project

Sign in to the ByteHide Cloud Panel and create a new project.

Click to expand

Select Shield as the product for your project.

Click to expand

Get Your Token

Once the project is created, your project token is displayed on the project dashboard. Copy it from the panel.

Click to expand

Configure the Token

Add your project token to the shield-ios.json configuration file:

{
  "projectToken": "your-project-token",
  "protections": {
    "symbol_renaming": true,
    "string_encryption": true
  }
}

{
  "projectToken": "your-project-token",
  "protections": {
    "symbol_renaming": true,
    "string_encryption": true
  }
}

You can also pass the token as a command-line argument or environment variable in CI/CD pipelines:

# Via environment variable
export SHIELD_PROJECT_TOKEN="your-project-token"
shield-ios protect MyApp.ipa

# Via environment variable
export SHIELD_PROJECT_TOKEN="your-project-token"
shield-ios protect MyApp.ipa

Token Security

Your project token identifies your project but does not grant access to your source code or binaries. It is safe to include in CI/CD configurations and version control, though using environment variables is recommended as a best practice.

Related

• Quick Start - Protect your first application
• Cloud Integration - How builds connect to the Cloud Panel
• CI/CD Integration - Using tokens in automated pipelines