Firewallfouten

Oorzaken en oplossingen voor de foutcodes van firewallobjecten, regels, quota, modi en profielen.

`error.firewall.validation`

Tekst in de console: De firewallwijziging is niet geldig: {issue} bij {object} ({count} problemen in totaal).
Betekenis voor API-clients: The firewall change adds validation errors (issue is the net.validation.fw_* key of the first, object its path, count how many); the message lists them all.
Code: INVALID_ARGUMENT, HTTP 400

Argument	Inhoud
`object`	het pad van het eerste object dat niet geldig is.
`issue`	de validatiesleutel van de eerste fout.
`count`	het aantal fouten in de wijziging.

Oorzaak. De wijziging zou de firewallconfiguratie met een of meer validatiefouten achterlaten, dus er is niets opgeslagen. issue is de sleutel van de eerste fout, object het pad van het object waarop ze betrekking heeft en count het aantal fouten. Het bericht van het API-antwoord toont ze allemaal.

Oplossing.

Lees de volledige lijst in het antwoord, corrigeer elk object dat erin staat en stuur de wijziging opnieuw.
Controleer het effect van een regel voordat u haar opslaat: kyvernon firewall simulate --vm <vm> --inbound --proto tcp --port 443 --peer 203.0.113.10 toont het oordeel en de regel die beslist.

`error.firewall.builtin`

Tekst in de console: {object} is ingebouwd en wordt door het platform beheerd; het kan niet gewijzigd of verwijderd worden.
Betekenis voor API-clients: The firewall object is built in and maintained by the control plane (read-only).
Code: FAILED_PRECONDITION, HTTP 412

Argument	Inhoud
`object`	het pad van het ingebouwde object.

Oorzaak. Het object is ingebouwd en wordt door het platform onderhouden (de naam begint met sys:). Ingebouwde groepen, services, beleidsregels en profielen zijn alleen-lezen.

Oplossing.

Laat het ingebouwde object ongewijzigd.
Voor ander gedrag maakt u een eigen object en gebruikt u dat naast het ingebouwde. Voor een profiel wijzigt u het profiel dat een netwerkadapter gebruikt: kyvernon firewall vnic-profile <vm> <nic> --profile <id>.

`error.firewall.reserved_name`

Tekst in de console: Namen die met sys: beginnen zijn voorbehouden aan ingebouwde firewallobjecten. Kies een andere naam.
Betekenis voor API-clients: Firewall object names starting with sys: are reserved for built-in objects.
Code: INVALID_ARGUMENT, HTTP 400

Argument	Inhoud
`field`	het aanvraagveld met de geweigerde naam.

Oorzaak. De naam van een nieuw of hernoemd firewallobject begint met sys:. Die prefix is gereserveerd voor ingebouwde objecten.

Oplossing.

Kies een naam die niet met sys: begint.
Herhaal de wijziging.

`error.firewall.quota`

Tekst in de console: Het firewallquotum {resource} van deze tenant is {limit}; de wijziging zou het {used} maken.
Betekenis voor API-clients: The tenant's firewall quota (fwGroups, fwPolicies, fwRules, fwGroupMembers) would be exceeded.
Code: FAILED_PRECONDITION, HTTP 412

Argument	Inhoud
`resource`	het quotum dat wordt overschreden.
`limit`	het quotum.
`used`	het aantal dat de wijziging zou bereiken.

Oorzaak. De wijziging zou de tenant boven een van zijn firewallquota brengen: fwGroups, fwPolicies, fwRules of fwGroupMembers.

Oplossing.

Verwijder firewallobjecten die niet meer worden gebruikt: groepen, beleidsregels of regels, of leden van een groep.
Een beheerder kan het quotum verhogen: kyvernon tenants quota <tenant> --body '{"fwRules": <number>}'. Controleer eerst de andere waarden van het quotum, want de body vervangt het hele quotum (kyvernon tenants get <tenant>). Geef de naam van de resource uit het bericht door.

`error.firewall.category_scope`

Tekst in de console: Emergency- en Infrastructure-beleid is van de provider. Gebruik Environment of Application.
Betekenis voor API-clients: Emergency and Infrastructure policies belong to the provider.
Code: INVALID_ARGUMENT, HTTP 400

Argument	Inhoud
`field`	het aanvraagveld met de categorie.

Oorzaak. Een tenant probeerde een beleid aan te maken of te verplaatsen naar de categorie Emergency of Infrastructure. Die categorieën zijn van de provider.

Oplossing.

Gebruik de categorie Environment of Application voor het beleid.
Hoort de regel echt bij de provider, dan maakt een beheerder met de providerbevoegdheden haar aan. Geef de regel die u nodig hebt door.

`error.firewall.in_use`

Tekst in de console: {object} is nog in gebruik.
Betekenis voor API-clients: The firewall object is still used (a profile set on vNICs).
Code: FAILED_PRECONDITION, HTTP 412

Argument	Inhoud
`object`	het pad van het profiel.

Oorzaak. Een firewallprofiel kan niet worden verwijderd, omdat ten minste één netwerkadapter het gebruikt.

Oplossing.

Geef elke netwerkadapter die het profiel gebruikt een ander profiel: kyvernon firewall vnic-profile <vm> <nic> --profile <id>, of --reset om terug te keren naar de standaard van zijn soort.
Verwijder het profiel: kyvernon firewall profiles delete <id>.

`error.firewall.no_vnic`

Tekst in de console: De virtuele machine heeft geen netwerkadapter op een host-bridge-netwerk.
Betekenis voor API-clients: The VM has no vNIC on a host-bridge network.
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. De virtuele machine heeft geen netwerkadapter op een hostbridge-netwerk, dus er is niets om met de gedistribueerde firewall te beschermen.

Oplossing.

Verbind een netwerkadapter van de virtuele machine met een hostbridge-netwerk en herhaal de bewerking.
Controleer de adapters van de virtuele machine: kyvernon inventory vm <id>.

`error.firewall.profile_not_selectable`

Tekst in de console: Het firewallprofiel {profile} kan hier niet gekozen worden. Open in plaats daarvan poorten met regels.
Betekenis voor API-clients: A tenant user chose a firewall profile the provider did not mark selectable.
Code: PERMISSION_DENIED, HTTP 403

Argument	Inhoud
`profile`	de id van het profiel.

Oorzaak. Een tenantgebruiker koos een firewallprofiel dat de provider niet als selecteerbaar heeft gemarkeerd.

Oplossing.

Behoud het profiel van de netwerkadapter en open de benodigde poorten met regels: kyvernon firewall open-port <vm> --tcp <port>.
Een beheerder kan een profiel als selecteerbaar markeren: kyvernon firewall profiles set <id> --selectable.

`error.firewall.unprotected`

Tekst in de console: Netwerkadapter {nic} kan niet door de firewall beschermd worden: {reason}.
Betekenis voor API-clients: The vNIC cannot be firewalled; its mode stays off. reason is linux_or_quarantine_bridge or port_security_off.
Code: FAILED_PRECONDITION, HTTP 412

Argument	Inhoud
`nic`	de sleutel van de netwerkadapter.
`reason`	waarom de adapter niet met de firewall kan worden beveiligd, `linux_or_quarantine_bridge` of `port_security_off`.

Oorzaak. De netwerkadapter kan niet worden beveiligd met de firewall, dus haar modus blijft off. Het argument reason geeft de reden. Het is linux_or_quarantine_bridge wanneer de adapter op een Linux-bridge of een quarantainebridge zit, en port_security_off wanneer poortbeveiliging uit staat op haar netwerk. De console toont de reden in uw taal.

Oplossing.

Lees de reden in het bericht.
Verbind de adapter bij linux_or_quarantine_bridge met een hostbridge-netwerk dat een Open vSwitch-bridge is.
Zet bij port_security_off poortbeveiliging aan voor het netwerk, als beheerder: kyvernon network update <id> --body-file <file>.
Schakel de modus opnieuw om: kyvernon firewall mode <vm> monitor.

`error.firewall.not_pending`

Tekst in de console: Er wacht geen wijziging van de firewallmodus van deze virtuele machine op bevestiging.
Betekenis voor API-clients: No firewall mode switch of the VM waits for confirmation.
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. Er is een bevestiging verstuurd voor een omschakeling van de firewallmodus, maar er wacht er geen op. De tijd om te bevestigen is verstreken en de vorige modus is terug, of de omschakeling is al bevestigd.

Oplossing.

Controleer de firewallmodus van de virtuele machine in de console met Modus wijzigen.
Is de modus niet de gewenste, schakel dan opnieuw om en bevestig binnen de tijd die u instelde: kyvernon firewall mode <vm> enforce --confirm-within 10m, en daarna kyvernon firewall mode confirm <vm>.