Berechtigungen

Webinhalte, die navigator.mediaDevices.getUserMedia(), die Geolocation API oder die Notifications API aufrufen, benötigen von der Hostanwendung eine Genehmigung oder Ablehnung dieser Anfragen. Wails stellt dafür plattformübergreifend eine Permissions-Map auf WebviewWindowOptions bereit, mit der sich dies deklarativ steuern lässt – plattformspezifischer Code ist nicht erforderlich.

Schnellstart

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

Anfragen der Webinhalte dieses Fensters auf Kamera und Mikrofon werden ohne Browserabfrage genehmigt.

Berechtigungstypen

PermissionType (uint8) bezeichnet eine Funktion, die Webinhalte anfordern können.

Berechtigungswerte

Permission (uint8) ist die Richtlinie, die auf einen bestimmten Typ angewendet wird.

PermissionDefault ist der Nullwert. Nicht gesetzte Map-Einträge verhalten sich daher gemäß der Standardrichtlinie.

Plattformverhalten

Jede Plattform verarbeitet PermissionDefault anders, da sich das native Verhalten der zugrunde liegenden Webviews unterscheidet.

Linux (WebKitGTK)

WebKitGTK verfügt über keine native Berechtigungsabfrage. Ohne registrierten Handler lehnt es jede Anfrage stillschweigend ab. Deshalb gab getUserMedia vor Einführung dieser Funktion immer NotAllowedError zurück.

Derzeit verarbeitet Wails unter Linux Anfragen auf Kamera und Mikrofon. Standortzugriff, Benachrichtigungen und das Lesen der Zwischenablage sind noch nicht angebunden und bleiben unabhängig von der festgelegten Richtlinie gesperrt.

Windows (WebView2)

WebView2 verfügt über eine native Berechtigungsabfrage und eine Berechtigungs-API für die einzelnen Typen. Alle fünf Funktionstypen werden vollständig unterstützt.

Wichtig: Vor Einführung dieser Funktion rief Wails SetGlobalPermission(Allow) bedingungslos auf und genehmigte damit stillschweigend alle Funktionen. Sobald Permissions einen Eintrag enthält, wird diese pauschale Genehmigung nun nicht festgelegt. Nicht gesetzte Funktionen werden nicht automatisch genehmigt, sondern an die native Berechtigungsabfrage von WebView2 weitergeleitet.

Wenn du Permissions unter Windows überhaupt konfigurierst, wird daher für jede nicht ausdrücklich aufgeführte Funktion eine Abfrage angezeigt, statt sie stillschweigend zuzulassen. Lege die benötigten Funktionen ausdrücklich fest.

macOS (WKWebView + TCC)

Unter macOS müssen zwei Ebenen zustimmen. WKWebView fragt die Anwendung vor dem Start einer Aufnahmesitzung; diese Anfrage beantwortet die Permissions-Map. Darunter schützt das Datenschutz-Framework TCC das Gerät selbst: Beim ersten tatsächlichen Zugriff auf Kamera oder Mikrofon erscheint die Systemabfrage. Die Entscheidung wird pro Anwendung unter Systemeinstellungen → Datenschutz & Sicherheit gespeichert.

Wails verarbeitet Kamera- und Mikrofonanfragen ab macOS 12. Für Standort, Benachrichtigungen und das Lesen der Zwischenablage gibt es kein entsprechendes WKUIDelegate-Verfahren; sie sind nicht angebunden und bleiben TCC überlassen. Wie unter Linux hat die festgelegte Richtlinie für diese Funktionen keine Wirkung.

PermissionAllow erlaubt die Anfrage der Webview, nicht den Gerätezugriff. Die Systemberechtigung gilt unabhängig davon; eine in den Systemeinstellungen abgelehnte Anwendung bleibt abgelehnt. Nur die WebKit-Abfrage entfällt.

Unter macOS-Versionen vor 12 existiert diese Delegate-Methode nicht. Dort wird die Map ignoriert und jede Anfrage fällt auf die WebKit-Abfrage zurück.

Stelle sicher, dass deine Info.plist die entsprechenden Schlüssel für Verwendungsbeschreibungen enthält:

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

Gängige Muster

Anwendung zur Medienaufnahme

Kamera und Mikrofon auf allen Plattformen genehmigen:

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

Unter Linux werden damit beide Geräte ausdrücklich zugelassen; andere Funktionen bleiben verweigert. Unter Windows werden damit beide zugelassen; für jede andere nicht aufgeführte Funktion wird eine native Abfrage angezeigt. Unter macOS werden beide Geräte auf WebKit-Ebene zugelassen, sodass keine Browserabfrage erscheint. TCC fragt beim ersten Zugriff weiterhin nach den Geräten selbst; beide Schlüssel für die Verwendungsbeschreibung müssen in Info.plist vorhanden sein.

Medienaufnahme unter Linux verweigern

Linux lässt Kamera und Mikrofon standardmäßig zu. So deaktivieren Sie dies:

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

Alle Funktionen unter Windows zulassen

So gewähren Sie alle Funktionen ohne Abfrage:

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,
},

Richtlinien pro Fenster

Für verschiedene Fenster können unterschiedliche Richtlinien gelten:

// 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,
    },
})

Windows-spezifische Überschreibung

Das fensterspezifische Feld Windows.Permissions (map[CoreWebView2PermissionKind]CoreWebView2PermissionState) funktioniert weiterhin und kann einzelne Funktionen überschreiben, nachdem die plattformübergreifende Zuordnung angewendet wurde. Verwenden Sie es, wenn Sie Zugriff auf WebView2-Berechtigungstypen benötigen, für die es keine plattformübergreifende Entsprechung gibt (z. B. CoreWebView2PermissionKindOtherSensors).

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

Die Auswertungsreihenfolge unter Windows lautet:

1. Plattformübergreifende Permissions-Zuordnung (legt den Status pro Typ über SetPermission fest)
2. Windows.Permissions-Zuordnung (überschreibt einzelne Typen)
3. Für jeden Typ, den keine der beiden Zuordnungen abdeckt: native Abfrage von WebView2 (wenn eine Richtlinie konfiguriert ist) oder automatische Zulassung (wenn keine Richtlinie konfiguriert ist – das bisherige Verhalten)

Matrix der Plattformunterstützung

Bei ✅ unter macOS beantwortet die Richtlinie die WebKit-Anfrage; TCC schützt zusätzlich das Gerät. Bei ❌ bleibt die Funktion allein TCC überlassen.

Fehlerbehebung

getUserMedia schlägt unter Linux nach dem Upgrade weiterhin fehl

Prüfen Sie, dass Sie weder PermissionMicrophone: PermissionDeny noch PermissionCamera: PermissionDeny ausdrücklich festgelegt haben. Standardmäßig (nicht festgelegt) ist die Medienaufnahme unter Linux zugelassen.

Windows fragt nach nicht konfigurierten Berechtigungen

Sobald Permissions einen Eintrag enthält, erteilt Wails nicht mehr die pauschale Freigabe Allow. Für nicht aufgeführte Funktionen wird die native Abfrage von WebView2 angezeigt. Fügen Sie für jede von Ihrer Anwendung verwendete Funktion einen ausdrücklichen PermissionAllow-Eintrag hinzu.

macOS-Berechtigungen funktionieren nicht

Permissions berücksichtigt Kamera und Mikrofon ab macOS 12. Standort, Benachrichtigungen und das Lesen der Zwischenablage sind noch nicht angebunden und ignorieren die Richtlinie. TCC schützt weiterhin den Gerätezugriff: PermissionAllow entfernt die WebKit-Abfrage, nicht die Systemabfrage. Prüfe die Schlüssel NSMicrophoneUsageDescription und NSCameraUsageDescription in Info.plist und die Freigabe unter Systemeinstellungen → Datenschutz & Sicherheit.

Meine macOS-Anwendung wird beendet, wenn Webinhalte Kamera oder Mikrofon anfordern

Prüfe, ob Info.plist für jedes angeforderte Gerät NSCameraUsageDescription beziehungsweise NSMicrophoneUsageDescription enthält. Fehlende Beschreibungen können zur Ablehnung der Anfrage führen; ein Zugriff auf AVFoundation ohne erforderliche Beschreibung kann die Anwendung beenden. PermissionDeny steuert die WebKit-Entscheidung und ersetzt diese Schlüssel nicht.

Geolokalisierung, Benachrichtigungen und Zwischenablage haben unter Linux keine Wirkung

Unter Linux werden derzeit nur Kamera und Mikrofon berücksichtigt. Die Unterstützung anderer Funktionstypen ist noch nicht implementiert – sie bleiben unabhängig von der festgelegten Richtlinie verweigert.