Autorisations

Le contenu web qui appelle navigator.mediaDevices.getUserMedia(), l’API Geolocation ou l’API Notifications nécessite que l’application hôte accepte ou refuse ces demandes. Wails expose une table Permissions multiplateforme dans WebviewWindowOptions, qui permet de contrôler cela de manière déclarative, sans code propre à chaque plateforme.

Démarrage rapide

window := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "My App",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionAllow,
        application.PermissionCamera:     application.PermissionAllow,
    },
})

Les demandes d’accès à la caméra et au microphone provenant du contenu web de cette fenêtre sont acceptées sans invite du navigateur.

Types d’autorisation

PermissionType (uint8) identifie une fonctionnalité que le contenu web peut demander.

Valeurs des autorisations

Permission (uint8) est la stratégie appliquée à un type donné.

PermissionDefault est la valeur zéro ; les entrées absentes de la table adoptent donc le comportement par défaut.

Comportement selon la plateforme

Chaque plateforme traite PermissionDefault différemment, car les vues web sous-jacentes ont des comportements natifs différents.

Linux (WebKitGTK)

WebKitGTK ne dispose d’aucune invite d’autorisation native. Si aucun gestionnaire n’est associé, il refuse silencieusement toutes les demandes. C’est pourquoi getUserMedia renvoyait toujours NotAllowedError avant l’ajout de cette fonctionnalité.

Actuellement, Wails traite sous Linux les demandes d’accès à la caméra et au microphone. La géolocalisation, les notifications et la lecture du presse-papiers ne sont pas encore raccordées et restent refusées quelle que soit la stratégie définie.

Windows (WebView2)

WebView2 dispose d’une invite d’autorisation native et d’une API d’autorisation par type. Les cinq types de fonctionnalités sont entièrement pris en charge.

Important : avant l’existence de cette fonctionnalité, Wails appelait systématiquement SetGlobalPermission(Allow), ce qui accordait silencieusement toutes les autorisations. Désormais, dès qu’une entrée est présente dans Permissions, cette autorisation globale n’est pas définie. Les fonctionnalités non spécifiées déclenchent donc l’invite native de WebView2 au lieu d’être automatiquement autorisées.

Par conséquent, sous Windows, dès que vous configurez Permissions, toute fonctionnalité que vous ne répertoriez pas explicitement affiche une invite au lieu d’être autorisée silencieusement. Définissez explicitement les fonctionnalités dont vous avez besoin.

macOS (WKWebView + TCC)

Deux couches doivent donner leur accord sous macOS. WKWebView interroge l’application avant de lancer une capture ; la table Permissions répond à cette demande. En dessous, l’infrastructure de confidentialité TCC contrôle le périphérique lui-même : l’invite système apparaît au premier accès réel à la caméra ou au microphone, et le choix est mémorisé par application dans Réglages Système → Confidentialité et sécurité.

Wails traite les demandes de caméra et de microphone sous macOS 12 et versions ultérieures. La géolocalisation, les notifications et la lecture du presse-papiers n’ont pas d’équivalent WKUIDelegate : elles ne sont pas raccordées et restent confiées à TCC. Comme sous Linux, la politique définie pour elles est sans effet.

PermissionAllow autorise la demande de la vue web, pas l’accès au périphérique. L’autorisation système reste indépendante et une application refusée dans Réglages Système reste refusée. Seule l’invite propre à WebKit est supprimée.

Avant macOS 12, cette méthode de délégué n’existe pas : la table est ignorée et chaque demande revient à l’invite WebKit.

Vérifiez que votre Info.plist comprend les clés de description d’utilisation appropriées :

<key>NSMicrophoneUsageDescription</key>
<string>Used for voice input</string>
<key>NSCameraUsageDescription</key>
<string>Used for video calls</string>

Scénarios courants

Application de capture multimédia

Autorisez la caméra et le microphone sur toutes les plateformes :

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone: application.PermissionAllow,
    application.PermissionCamera:     application.PermissionAllow,
},

Sous Linux, cela autorise explicitement les deux périphériques ; les autres fonctionnalités restent refusées. Sous Windows, cela autorise les deux ; toute autre fonctionnalité non répertoriée déclenchera une invite native. Sous macOS, les deux périphériques sont autorisés au niveau WebKit, sans invite du navigateur. TCC demande toujours l’accès aux périphériques lors de la première utilisation, et les deux clés de description d’utilisation doivent figurer dans Info.plist.

Refuser la capture multimédia sous Linux

Linux autorise la caméra et le microphone par défaut. Pour les désactiver :

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone: application.PermissionDeny,
    application.PermissionCamera:     application.PermissionDeny,
},

Autoriser toutes les fonctionnalités sous Windows

Pour accorder toutes les autorisations sans afficher d’invite :

Permissions: map[application.PermissionType]application.Permission{
    application.PermissionMicrophone:    application.PermissionAllow,
    application.PermissionCamera:        application.PermissionAllow,
    application.PermissionGeolocation:   application.PermissionAllow,
    application.PermissionNotifications: application.PermissionAllow,
    application.PermissionClipboardRead: application.PermissionAllow,
},

Politiques propres à chaque fenêtre

Chaque fenêtre peut avoir une politique différente :

// Main app window — full media access
mainWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "App",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionAllow,
        application.PermissionCamera:     application.PermissionAllow,
    },
})

// Settings window — no special capabilities
settingsWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "Settings",
    // No Permissions entry — uses platform defaults
})

// Embedded content window — deny media capture
embeddedWindow := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title: "Embedded",
    Permissions: map[application.PermissionType]application.Permission{
        application.PermissionMicrophone: application.PermissionDeny,
        application.PermissionCamera:     application.PermissionDeny,
    },
})

Remplacement propre à Windows

Le champ Windows.Permissions propre à chaque fenêtre (map[CoreWebView2PermissionKind]CoreWebView2PermissionState) fonctionne toujours et peut remplacer les paramètres de fonctionnalités individuelles après l’application de la table multiplateforme. Utilisez-le lorsque vous devez accéder à des types d’autorisations WebView2 sans équivalent multiplateforme (par exemple, CoreWebView2PermissionKindOtherSensors).

Windows: application.WindowsWindow{
    Permissions: map[application.CoreWebView2PermissionKind]application.CoreWebView2PermissionState{
        application.CoreWebView2PermissionKindOtherSensors: application.CoreWebView2PermissionStateAllow,
    },
},

Sous Windows, l’ordre d’évaluation est le suivant :

1. Table Permissions multiplateforme (définit l’état de chaque type via SetPermission)
2. Table Windows.Permissions (remplace les paramètres de types individuels)
3. Pour tout type non couvert par l’une ou l’autre table : invite native de WebView2 (lorsqu’une politique est configurée) ou autorisation automatique (lorsqu’aucune politique n’est configurée — comportement historique)

Matrice de prise en charge des plateformes

Pour ✅ sous macOS, la politique répond à WebKit ; TCC contrôle en plus le périphérique. Pour ❌, la fonctionnalité reste confiée à TCC uniquement.

Dépannage

getUserMedia échoue toujours sous Linux après la mise à niveau

Vérifiez que vous n’avez pas explicitement défini PermissionMicrophone: PermissionDeny ou PermissionCamera: PermissionDeny. La valeur par défaut (non définie) autorise la capture multimédia sous Linux.

Windows demande des autorisations que je n’ai pas configurées

Dès qu’une entrée figure dans Permissions, Wails n’accorde plus l’autorisation globale Allow. Les fonctionnalités non répertoriées déclencheront l’invite native de WebView2. Ajoutez des entrées PermissionAllow explicites pour chaque fonctionnalité utilisée par votre application.

Les autorisations macOS ne fonctionnent pas

Permissions couvre la caméra et le microphone sous macOS 12 et versions ultérieures. La géolocalisation, les notifications et la lecture du presse-papiers ne sont pas encore raccordées et ignorent la politique. TCC contrôle toujours le périphérique : PermissionAllow supprime l’invite WebKit, pas celle du système. Vérifiez les clés NSMicrophoneUsageDescription et NSCameraUsageDescription dans Info.plist et l’autorisation dans Réglages Système → Confidentialité et sécurité.

Mon application macOS quitte lorsque le contenu web demande la caméra ou le microphone

Vérifiez que Info.plist contient NSCameraUsageDescription ou NSMicrophoneUsageDescription pour chaque périphérique demandé. Une description manquante peut entraîner le rejet de la demande ; un accès à AVFoundation sans description obligatoire peut terminer l’application. PermissionDeny contrôle la décision WebKit et ne remplace pas ces clés.

La géolocalisation, les notifications et le presse-papiers n’ont aucun effet sous Linux

Seuls la caméra et le microphone sont actuellement pris en charge sous Linux. La prise en charge des autres types de fonctionnalités n’est pas encore implémentée : elles restent refusées quelle que soit la politique définie.