Valider le type des fichiers téléchargés sur iOS avec un Mac cloud

Valider le type des fichiers téléchargés sur iOS avec un Mac cloud

Valider le type des fichiers téléchargés sur iOS avec un Mac cloud

L’API de téléchargement iOS indique un succès, mais la page d’aperçu ne parvient pas à ouvrir la pièce jointe : tantôt le fichier reçu est une page d’erreur renvoyée après l’expiration de la session, tantôt le serveur déclare tous les contenus comme des données binaires génériques, tantôt le téléchargement s’est arrêté à mi-parcours. Pour reproduire ces problèmes sur un Mac cloud, inutile de commencer par connecter le service réel. Distinguez d’abord trois questions : quel type est déclaré, à quel format les données ressemblent-elles et peuvent-elles être entièrement analysées ? Établissez ces trois niveaux de validation à partir d’un jeu de fichiers de référence, puis intégrez-les au parcours de téléchargement.

Définir d’abord les formats autorisés

Supposons que le point d’entrée des pièces jointes n’accepte que les formats PNG, JPEG et PDF. La règle doit découler d’une liste blanche définie par les besoins de l’application, et non d’une déduction fondée sur le nom du fichier. Ce nom peut être affiché à l’utilisateur, mais ne doit déterminer ni le parseur à utiliser ni, à plus forte raison, le chemin d’enregistrement sur disque.

L’ordre de validation est le suivant : vérifier que le statut HTTP respecte le contrat de l’API, limiter le nombre d’octets effectivement reçus, confronter le type MIME de la réponse à la signature du fichier, puis effectuer une analyse propre au format. Content-Length n’est qu’un critère possible de rejet anticipé : son absence ou une valeur sous-estimée ne dispense jamais de plafonner le cumul des octets reçus.

Une signature reconnue indique seulement que le fichier « ressemble à ce format ». Elle ne prouve ni son intégrité ni sa sécurité. Un fichier contenant uniquement la signature PNG reste impossible à afficher.

Si l’API renvoie explicitement un type binaire générique, vous pouvez prévoir une exception pour ce point d’entrée ; n’étendez pas cette tolérance à tous les téléchargements. L’implémentation ci-dessous applique un mode strict : elle rejette les fichiers dont le type MIME est absent ou contradictoire.

Isoler l’identification du type dans une fonction pure

Dans le terminal du Mac distant, créez un fichier type-check.swift et enregistrez-y le contenu suivant. La fonction ne reçoit que les premiers octets et le type MIME. Elle n’accède ni au réseau ni au répertoire de l’utilisateur, ce qui facilitera son intégration ultérieure à la cible de tests de l’application. Les échantillons du code servent uniquement à vérifier les règles de classification ; ils ne sont pas présentés comme des images ou des documents valides.

import Foundation

enum FileKind: String {
    case png, jpeg, pdf

    var mime: String {
        switch self {
        case .png: return "image/png"
        case .jpeg: return "image/jpeg"
        case .pdf: return "application/pdf"
        }
    }
}

enum TypeFailure: Error {
    case unknownHeader
    case missingMIME
    case conflictingMIME
}

func classify(
    prefix: Data,
    declaredMIME: String?
) throws -> FileKind {
    let bytes = Array(prefix.prefix(8))
    let kind: FileKind

    if bytes.starts(with: [137, 80, 78, 71, 13, 10, 26, 10]) {
        kind = .png
    } else if bytes.starts(with: [255, 216, 255]) {
        kind = .jpeg
    } else if bytes.starts(with: Array("%PDF-".utf8)) {
        kind = .pdf
    } else {
        throw TypeFailure.unknownHeader
    }

    guard let declaredMIME else {
        throw TypeFailure.missingMIME
    }

    let mime = declaredMIME
        .split(separator: ";", omittingEmptySubsequences: false)[0]
        .trimmingCharacters(in: .whitespacesAndNewlines)
        .lowercased()

    guard mime == kind.mime else {
        throw TypeFailure.conflictingMIME
    }
    return kind
}

struct Fixture {
    let head: [UInt8]
    let mime: String?
    let expected: FileKind?
}

let fixtures: [Fixture] = [
    .init(
        head: [137, 80, 78, 71, 13, 10, 26, 10],
        mime: "IMAGE/PNG; charset=binary",
        expected: .png
    ),
    .init(head: [255, 216, 255], mime: "image/jpeg", expected: .jpeg),
    .init(
        head: Array("%PDF-1.7".utf8),
        mime: "application/pdf",
        expected: .pdf
    ),
    .init(
        head: Array("<html>error".utf8),
        mime: "application/pdf",
        expected: nil
    ),
    .init(head: [137, 80, 78], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: "image/png", expected: nil),
    .init(head: [255, 216, 255], mime: nil, expected: nil)
]

for (index, fixture) in fixtures.enumerated() {
    let actual = try? classify(
        prefix: Data(fixture.head),
        declaredMIME: fixture.mime
    )
    guard actual == fixture.expected else {
        fatalError("Fixture mismatch at index \(index)")
    }
}

Exécutez xcrun swift type-check.swift. Si tous les résultats correspondent aux attentes, le programme se termine sans rien afficher ; si une assertion échoue, il renvoie un code de sortie non nul. Les valeurs d’en-tête sont utilisées directement ici pour couvrir les variations de casse et la présence de paramètres. Si l’application lit un type MIME déjà normalisé, conservez également l’en-tête de réponse d’origine pour faciliter le diagnostic, sans toutefois journaliser les champs d’authentification.

Intégrer la vérification sans charger tout le fichier en mémoire

Avec une tâche de téléchargement, vérifiez d’abord l’erreur éventuelle de la tâche, le statut de la réponse et l’existence du fichier temporaire. Utilisez ensuite FileHandle pour lire au maximum huit octets et les transmettre à la fonction de classification. Fermez le handle avec defer. N’utilisez pas Data(contentsOf:) pour charger tout le fichier simplement afin d’en lire la signature : avec une pièce jointe volumineuse, une vérification élémentaire provoquerait un pic de mémoire.

En réception continue, accumulez les huit premiers octets : rien ne garantit que le premier rappel contienne la signature complète. Le découpage des rappels ne suit pas les limites du format de fichier. Tant que les données reçues ne permettent pas de conclure, attendez d’avoir les huit octets ou d’atteindre la fin du transfert avant de rendre le verdict.

Déplacez rapidement le fichier temporaire fourni par la tâche de téléchargement vers un répertoire de transit contrôlé par l’application. Générez un nom de fichier interne et ne publiez le fichier à son emplacement définitif qu’après validation. À la moindre erreur, supprimez le fichier de transit. Le nom fourni par l’utilisateur ne doit servir que de libellé d’affichage, après traitement approprié.

Ajouter un second jeu de fichiers pour vérifier l’analyse complète

Une fois le type identifié, les images doivent encore passer par ImageIO : créez une source d’image, puis produisez effectivement une image. Le simple fait de pouvoir lire les dimensions ou créer une source ne garantit pas que le décodage réussira ensuite. Limitez d’abord la largeur, la hauteur, le nombre total de pixels et le nombre de trames, puis déclenchez le décodage des trames nécessaires. Vous éviterez ainsi qu’un petit fichier compressé ne se transforme en un objet gigantesque en mémoire.

Pour les PDF, utilisez PDFKit afin de tenter de créer le document, puis vérifiez le nombre de pages, l’état de chiffrement et les pages auxquelles l’application doit accéder. Si le fonctionnement attendu exige un aperçu, effectuez réellement le rendu des pages concernées. La création réussie d’un objet document ne garantit pas que chaque page s’affichera correctement.

Préparez de véritables fichiers valides, ainsi que des copies réduites à leur signature, tronquées en fin de fichier ou modifiées dans leurs octets intermédiaires. Les parseurs sous-jacents ne rejetteront pas nécessairement tous les fichiers tronqués : certains tolèrent des erreurs. Les assertions doivent donc vérifier que l’opération requise par l’application peut être menée à terme, plutôt que supposer que toute modification d’un octet doit provoquer un échec.

Produire des résultats qui permettent de localiser les échecs

Après l’intégration à la cible de tests du projet, distinguez les échecs de transfert, les formats inconnus, les déclarations contradictoires, les dépassements de quota et les échecs d’analyse. Ne ramenez pas toutes ces situations à « fichier endommagé » : vous confondriez une mauvaise configuration MIME côté serveur avec un problème de décodage côté client.

À chaque campagne de non-régression, conservez l’identifiant de l’échantillon, le nombre réel d’octets, le type MIME normalisé, le type candidat et l’étape du traitement. Privilégiez des fichiers générés artificiellement, sans contenu sensible. Si une pièce jointe en échec contient des données métier, elle ne doit pas être téléversée automatiquement avec le rapport de tests.

Vérifiez enfin trois points : aucune page d’erreur n’atteint le visualiseur, aucun fichier tronqué n’est considéré comme ayant passé une vérification d’intégrité, et aucun parcours d’échec ne laisse de pièce jointe à l’emplacement définitif. Le Mac cloud sert à exécuter le jeu de fichiers de référence et le parcours dans le simulateur ; le comportement mémoire des gros fichiers sur un appareil réel doit toujours faire l’objet d’une validation distincte. Consignez séparément ces deux volets pour savoir précisément ce que ce contrôle permet de garantir.

Questions fréquentes

Faut-il corriger automatiquement un désaccord entre MIME et signature ?

Refusez le fichier par défaut et consignez le désaccord. Si un point d’entrée renvoie volontairement des données binaires génériques, limitez l’exception à ce point et exigez toujours une analyse complète.

Une signature correcte garantit-elle un fichier intact ?

Non. Un fichier tronqué peut conserver sa signature. Les images exigent un contrôle de décodage complet ; les PDF doivent être analysés et leurs pages vérifiées selon les besoins.

Laissez votre projet déterminer le Mac à louer

Pour compiler en natif et déboguer avec le simulateur, louez un Mac dédié équipé d’une puce Apple Silicon pour vos tests. Si vous développez à temps plein sur le long terme et travaillez toujours au même endroit, l’achat mérite aussi d’être envisagé. La location à la journée offre plus de flexibilité pour tester ; pour une utilisation prolongée, optez plutôt pour un forfait mensuel ou trimestriel.

Louer un Mac à distance

Étape suivante : choisissez une offre selon l’avancement du projet

Comparez d’abord les modèles, les durées et les options de connexion avant de décider si vous souhaitez louer.