YaST REST Service Documentation

Copyright © 2009-10 Novell, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled "GNU Free Documentation License".

Firewall

TODO link to a master API document that contains the common conventions like the authentication below.

Only authenticated users are allowed to access the API. Authentication is done by sending a Basic HTTP Authorisation header.

Overview

Firewall api can be used to turn the whole firewall on and off as well as the individual services. TODO link to a document describing the format of services files. Firewall plugin expects, that only a single network interface is configured.

PolicyKit Access Rights

The following PolicyKit permissions are defined:

org.opensuse.yast.modules.yapi.firewall.read

org.opensuse.yast.modules.yapi.firewall.write

REST-API

GET /firewall

Get settings of the firewall and all defined services.

Result: Example

PUT /firewall

Set the firewall on/off and allows/blocks listed services. It doesn't change status of services which are not listed in XmlBody.

Body: Example

Result: Example