CyberFence VPN - Flutter con TunnelKit

Aplicación Flutter para iOS que se conecta a una VPN OpenVPN usando TunnelKit.

📱 Características

• ✅ Conexión a VPN OpenVPN
• ✅ Desconexión de VPN
• ✅ Visualización de estados en tiempo real:
  • Desconectada
  • Conectando
  • Conectada
  • Desconectando
• ✅ Interfaz moderna y amigable
• ✅ Integración nativa con iOS usando TunnelKit

🏗️ Arquitectura

┌─────────────────────────────────────┐
│         Flutter UI (Dart)           │
│  - Botones conectar/desconectar     │
│  - Visualización de estado          │
└─────────────┬───────────────────────┘
              │
              │ MethodChannel
              ▼
┌─────────────────────────────────────┐
│      Swift Native (iOS)             │
│  - VPNManager                       │
│  - VPNConfiguration                 │
│  - AppDelegate                      │
└─────────────┬───────────────────────┘
              │
              │ TunnelKit API
              ▼
┌─────────────────────────────────────┐
│    PacketTunnelProvider             │
│  (Network Extension)                │
│  - Maneja el túnel VPN              │
│  - Usa TunnelKitOpenVPN             │
└─────────────────────────────────────┘

📂 Estructura del Proyecto

tunnelkit_flutter/
├── lib/
│   └── main.dart                    # UI de Flutter con MethodChannel
├── ios/
│   ├── Runner/
│   │   ├── AppDelegate.swift        # Integración del MethodChannel
│   │   ├── VPNManager.swift         # Lógica de conexión VPN
│   │   ├── VPNConfiguration.swift   # Certificados y config VPN
│   │   ├── Runner.entitlements      # Permisos de la app
│   │   └── Info.plist
│   ├── TunnelExtension/
│   │   ├── PacketTunnelProvider.swift    # Network Extension
│   │   ├── TunnelExtension.entitlements  # Permisos de extensión
│   │   └── Info.plist
│   └── Podfile                      # Dependencias TunnelKit
├── INSTRUCCIONES_VPN.md             # 📖 Guía completa paso a paso
└── COMANDOS_RAPIDOS.md              # ⚡ Comandos útiles

🚀 Inicio Rápido

1. Instalar dependencias

# Flutter
flutter pub get

# iOS (CocoaPods)
cd ios
pod install
cd ..

2. Configurar en Xcode

open ios/Runner.xcworkspace

Ver INSTRUCCIONES_VPN.md para la configuración completa.

3. Ejecutar

flutter run

⚠️ IMPORTANTE: Debes usar un dispositivo físico. Las VPN no funcionan en el simulador.

📋 Requisitos

• Flutter SDK ^3.7.2
• iOS 12.0 o superior
• Xcode 14 o superior
• CocoaPods instalado
• Cuenta de Apple Developer (para firmar la app y crear provisioning profiles)
• Dispositivo iOS físico (no funciona en simulador)

🔧 Dependencias iOS (CocoaPods)

• TunnelKitCore ~> 6.0
• TunnelKitManager ~> 6.0
• TunnelKitOpenVPN ~> 6.0
• TunnelKitOpenVPNAppExtension ~> 6.0

🔐 Configuración VPN

Los datos de conexión están en ios/Runner/VPNManager.swift:

private let server = "cyberfencevpn.v4.softether.net"
private let port = "9201"
private let username = "cyberfencevpnpro"
private let password = "md4rshywX2YUDXCoanxghYF4ryvWPN"

Los certificados y TLS keys están en ios/Runner/VPNConfiguration.swift.

📱 Capabilities requeridas

App Principal (Runner):

• Network Extensions (Packet Tunnel)
• App Groups: group.com.perez.CyberFence
• Keychain Sharing

Network Extension (TunnelExtension):

• App Groups: group.com.perez.CyberFence
• Keychain Sharing

🎯 Bundle Identifiers

• App principal: com.example.cyberFence.tunnelkit_flutter
• Network Extension: com.example.cyberFence.tunnelkit-flutter.TunnelExtension

Estos deben estar configurados en Apple Developer Portal con las capabilities necesarias.

📚 Documentación

• INSTRUCCIONES_VPN.md - Guía completa de configuración paso a paso
• COMANDOS_RAPIDOS.md - Comandos útiles para desarrollo

🐛 Problemas Comunes

"Module 'TunnelKit...' not found"

cd ios
pod install

"Code signing error"

• Configura tu Team en Xcode (Signing & Capabilities)
• Verifica los provisioning profiles en Apple Developer

La VPN no se conecta

• Acepta los permisos de VPN cuando iOS los solicite
• Ve a Configuración → General → VPN para verificar

🛠️ Desarrollo

Compilar

flutter build ios

Ver logs

flutter run -v

Limpiar proyecto

flutter clean
cd ios
pod install
cd ..
flutter run

📖 Referencias

• TunnelKit GitHub
• Flutter Platform Channels
• Apple Network Extension

📄 Licencia

Proyecto privado - CyberFence

👨‍💻 Autor

Adaptado de CyberFence-Original para Flutter