Distribution iOS

Fenfa fournit un support complet pour la distribution iOS OTA (Over-The-Air), incluant la génération de manifestes itms-services://, la liaison UDID des appareils pour le provisionnement ad-hoc, et une intégration optionnelle avec l'API Apple Developer pour l'enregistrement automatique des appareils.

Comment fonctionne iOS OTA

sequenceDiagram
    participant User as Utilisateur iOS
    participant Safari as Navigateur Safari
    participant Fenfa as Serveur Fenfa
    participant Apple as Service d'installation Apple

    User->>Safari: Ouvrir la page produit
    Safari->>Fenfa: GET /products/:slug
    Fenfa->>Safari: Afficher le bouton d'installation
    User->>Safari: Appuyer sur "Installer"
    Safari->>Apple: itms-services://?action=download-manifest&url=...
    Apple->>Fenfa: GET /ios/:releaseID/manifest.plist
    Fenfa->>Apple: Retourner le XML du manifeste
    Apple->>Fenfa: GET /d/:releaseID (télécharger l'IPA)
    Fenfa->>Apple: Retourner le binaire IPA
    Apple->>User: Installer l'application sur l'appareil

iOS utilise le protocole itms-services:// pour installer des applications directement depuis une page web. Quand un utilisateur appuie sur le bouton d'installation, Safari transfère au système d'installation, qui :

1. Récupère le manifeste plist depuis Fenfa
2. Télécharge le fichier IPA
3. Installe l'application sur l'appareil

HTTPS requis

L'installation iOS OTA nécessite HTTPS avec un certificat TLS valide. Les certificats auto-signés ne fonctionneront pas. Pour les tests locaux, utilisez ngrok pour créer un tunnel HTTPS temporaire.

Génération de manifeste

Fenfa génère automatiquement le fichier manifest.plist pour chaque version iOS. Le manifeste est servi à :

GET /ios/:releaseID/manifest.plist

Le manifeste contient :

• L'identifiant de bundle (depuis le champ identifiant de la variante)
• La version du bundle (depuis la version de la version)
• L'URL de téléchargement (pointant vers /d/:releaseID)
• Le titre de l'application

Le lien d'installation itms-services:// est :

itms-services://?action=download-manifest&url=https://your-domain.com/ios/rel_xxx/manifest.plist

Ce lien est automatiquement inclus dans la réponse de l'API de téléversement et affiché sur la page produit.

Liaison UDID des appareils

Pour la distribution ad-hoc, les appareils iOS doivent être enregistrés dans le profil de provisionnement de l'application. Fenfa fournit un flux de liaison UDID qui collecte les identifiants des appareils auprès des utilisateurs.

Comment fonctionne la liaison UDID

sequenceDiagram
    participant User as Utilisateur iOS
    participant Safari as Safari
    participant Fenfa as Serveur Fenfa
    participant Settings as Réglages iOS

    User->>Safari: Visiter la page produit
    Safari->>Fenfa: GET /udid/profile.mobileconfig?variant=var_xxx
    Fenfa->>Safari: Retourner le profil de configuration mobile
    Safari->>Settings: Rediriger vers les Réglages
    Settings->>User: Invite "Installer le profil"
    User->>Settings: Appuyer sur "Installer"
    Settings->>Fenfa: POST /udid/callback (avec la charge utile UDID)
    Fenfa->>Fenfa: Stocker l'UDID + infos de l'appareil
    Fenfa->>Settings: Rediriger vers la page de statut
    User->>Safari: GET /udid/status?variant=var_xxx
    Safari->>Fenfa: Vérifier le statut de liaison
    Fenfa->>User: Confirmation "Appareil enregistré"

Endpoints UDID

Endpoint	Méthode	Description
/udid/profile.mobileconfig?variant=:variantID	GET	Télécharger le profil de configuration mobile
/udid/callback	POST	Callback d'iOS après l'installation du profil (contient l'UDID)
/udid/status?variant=:variantID	GET	Vérifier si l'appareil actuel est lié

Sécurité

Le flux de liaison UDID utilise des nonces à usage unique pour prévenir les attaques par rejeu :

• Chaque téléchargement de profil génère un nonce unique
• Le nonce est intégré dans l'URL de callback
• Une fois utilisé, le nonce ne peut pas être réutilisé
• Les nonces expirent après un délai configurable

Intégration de l'API Apple Developer

Fenfa peut enregistrer automatiquement des appareils avec votre compte Apple Developer, éliminant l'étape manuelle d'ajout d'UDIDs dans le portail Apple Developer.

Configuration

1. Allez dans Panneau d'administration > Paramètres > API Apple Developer.
2. Entrez vos identifiants API App Store Connect :

Champ	Description
Key ID	ID de clé API (ex. "ABC123DEF4")
Issuer ID	ID émetteur (format UUID)
Private Key	Contenu de la clé privée au format PEM
Team ID	Votre ID d'équipe Apple Developer

Créer des clés API

Dans le Portail Apple Developer, créez une clé API avec la permission "Devices". Téléchargez le fichier .p8 de clé privée -- il ne peut être téléchargé qu'une seule fois.

Enregistrer des appareils

Une fois configuré, vous pouvez enregistrer des appareils avec Apple depuis le panneau d'administration :

Appareil unique :

curl -X POST http://localhost:8000/admin/api/devices/DEVICE_ID/register-apple \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Enregistrement en lot :

curl -X POST http://localhost:8000/admin/api/devices/register-apple \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Vérifier le statut de l'API Apple

curl http://localhost:8000/admin/api/apple/status \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Lister les appareils enregistrés chez Apple

curl http://localhost:8000/admin/api/apple/devices \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Flux de travail de distribution ad-hoc

Le flux complet pour la distribution iOS ad-hoc :

1. L'utilisateur lie son appareil -- Visite la page produit, installe le profil mobileconfig, l'UDID est capturé.
2. L'administrateur enregistre l'appareil -- Dans le panneau d'administration, enregistrez l'appareil avec Apple (ou utilisez l'enregistrement en lot).
3. Le développeur re-signe l'IPA -- Mettez à jour le profil de provisionnement pour inclure le nouvel appareil, re-signez l'IPA.
4. Téléverser le nouveau build -- Téléversez l'IPA re-signé vers Fenfa.
5. L'utilisateur installe -- L'utilisateur peut maintenant installer l'application via la page produit.

Distribution Enterprise

Si vous avez un compte Apple Enterprise Developer, vous pouvez ignorer entièrement la liaison UDID. Les profils Enterprise permettent l'installation sur n'importe quel appareil. Configurez la variante en conséquence et téléversez des IPA signés en entreprise.

Gérer les appareils iOS

Affichez tous les appareils liés dans le panneau d'administration ou via l'API :

curl http://localhost:8000/admin/api/ios_devices \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Exportez les appareils en CSV :

curl -o devices.csv http://localhost:8000/admin/exports/ios_devices.csv \
  -H "X-Auth-Token: YOUR_ADMIN_TOKEN"

Étapes suivantes

• Distribution Android -- Distribution d'APK Android
• API de téléversement -- Automatiser les téléversements iOS depuis CI/CD
• Déploiement en production -- Configurer HTTPS pour iOS OTA