@@ -48,6 +48,7 @@ Post-v2.7.0
* Multiple chassis may now be specified for L3 gateways. When more than
one chassis is specified, OVN will manage high availability for that
gateway.
+ * Add support for ACL logging.
- Tracing with ofproto/trace now traces through recirculation.
- OVSDB:
* New support for role-based access control (see ovsdb-server(1)).
@@ -48,30 +48,31 @@ struct simap;
* "ovnact". The structure must have a fixed length, that is, it may not
* end with a flexible array member.
*/
-#define OVNACTS \
- OVNACT(OUTPUT, ovnact_null) \
- OVNACT(NEXT, ovnact_next) \
- OVNACT(LOAD, ovnact_load) \
- OVNACT(MOVE, ovnact_move) \
- OVNACT(EXCHANGE, ovnact_move) \
- OVNACT(DEC_TTL, ovnact_null) \
- OVNACT(CT_NEXT, ovnact_ct_next) \
- OVNACT(CT_COMMIT, ovnact_ct_commit) \
- OVNACT(CT_DNAT, ovnact_ct_nat) \
- OVNACT(CT_SNAT, ovnact_ct_nat) \
- OVNACT(CT_LB, ovnact_ct_lb) \
- OVNACT(CT_CLEAR, ovnact_null) \
- OVNACT(CLONE, ovnact_nest) \
- OVNACT(ARP, ovnact_nest) \
- OVNACT(ND_NA, ovnact_nest) \
- OVNACT(GET_ARP, ovnact_get_mac_bind) \
- OVNACT(PUT_ARP, ovnact_put_mac_bind) \
- OVNACT(GET_ND, ovnact_get_mac_bind) \
- OVNACT(PUT_ND, ovnact_put_mac_bind) \
- OVNACT(PUT_DHCPV4_OPTS, ovnact_put_dhcp_opts) \
- OVNACT(PUT_DHCPV6_OPTS, ovnact_put_dhcp_opts) \
- OVNACT(SET_QUEUE, ovnact_set_queue) \
- OVNACT(DNS_LOOKUP, ovnact_dns_lookup)
+#define OVNACTS \
+ OVNACT(OUTPUT, ovnact_null) \
+ OVNACT(NEXT, ovnact_next) \
+ OVNACT(LOAD, ovnact_load) \
+ OVNACT(MOVE, ovnact_move) \
+ OVNACT(EXCHANGE, ovnact_move) \
+ OVNACT(DEC_TTL, ovnact_null) \
+ OVNACT(CT_NEXT, ovnact_ct_next) \
+ OVNACT(CT_COMMIT, ovnact_ct_commit) \
+ OVNACT(CT_DNAT, ovnact_ct_nat) \
+ OVNACT(CT_SNAT, ovnact_ct_nat) \
+ OVNACT(CT_LB, ovnact_ct_lb) \
+ OVNACT(CT_CLEAR, ovnact_null) \
+ OVNACT(CLONE, ovnact_nest) \
+ OVNACT(ARP, ovnact_nest) \
+ OVNACT(ND_NA, ovnact_nest) \
+ OVNACT(GET_ARP, ovnact_get_mac_bind) \
+ OVNACT(PUT_ARP, ovnact_put_mac_bind) \
+ OVNACT(GET_ND, ovnact_get_mac_bind) \
+ OVNACT(PUT_ND, ovnact_put_mac_bind) \
+ OVNACT(PUT_DHCPV4_OPTS, ovnact_put_dhcp_opts) \
+ OVNACT(PUT_DHCPV6_OPTS, ovnact_put_dhcp_opts) \
+ OVNACT(SET_QUEUE, ovnact_set_queue) \
+ OVNACT(DNS_LOOKUP, ovnact_dns_lookup) \
+ OVNACT(LOG, ovnact_log)
/* enum ovnact_type, with a member OVNACT_<ENUM> for each action. */
enum OVS_PACKED_ENUM ovnact_type {
@@ -265,6 +266,14 @@ struct ovnact_dns_lookup {
struct expr_field dst; /* 1-bit destination field. */
};
+/* OVNACT_LOG. */
+struct ovnact_log {
+ struct ovnact ovnact;
+ uint8_t verdict; /* One of LOG_VERDICT_*. */
+ uint8_t severity; /* One of LOG_SEVERITY_*. */
+ char *name;
+};
+
/* Internal use by the helpers below. */
void ovnact_init(struct ovnact *, enum ovnact_type, size_t len);
void *ovnact_put(struct ofpbuf *, enum ovnact_type, size_t len);
@@ -400,6 +409,16 @@ enum action_opcode {
*
*/
ACTION_OPCODE_DNS_LOOKUP,
+
+ /* "log(arguments)".
+ *
+ * Arguments are as follows:
+ * - An 8-bit verdict.
+ * - An 8-bit severity.
+ * - An 16-bit string length for the name.
+ * - A variable length string containing the name.
+ */
+ ACTION_OPCODE_LOG,
};
/* Header. */
@@ -20,6 +20,15 @@
machine-local and do not run over a physical network.
</p>
+ <h1>ACL Logging</h1>
+ <p>
+ ACL log messages are logged through <code>ovn-controller</code>'s
+ logging mechanism. ACL log entries have the module
+ <code>pinctrl</code> at log level <code>info</code>. Configuring
+ logging is described below in the <code>Logging Options</code>
+ section.
+ </p>
+
<h1>Options</h1>
<h2>Daemon Options</h2>
@@ -41,6 +41,7 @@
#include "ovn/lex.h"
#include "ovn/lib/logical-fields.h"
#include "ovn/lib/ovn-dhcp.h"
+#include "ovn/lib/ovn-log.h"
#include "ovn/lib/ovn-util.h"
#include "poll-loop.h"
#include "rconn.h"
@@ -918,6 +919,39 @@ exit:
}
static void
+pinctrl_handle_log(struct dp_packet *packet OVS_UNUSED,
+ const struct flow *headers,
+ struct ofpbuf *userdata)
+{
+ struct log_pin_header *lph = ofpbuf_try_pull(userdata, sizeof *lph);
+ if (!lph) {
+ VLOG_WARN("log data missing");
+ return;
+ }
+
+ int name_len = ntohs(lph->name_len);
+ char *name = xmalloc(name_len+1);
+ if (name_len) {
+ char *tmp_name = ofpbuf_try_pull(userdata, name_len);
+ if (!name) {
+ VLOG_WARN("name missing");
+ free(name);
+ return;
+ }
+ memcpy(name, tmp_name, name_len);
+ }
+ name[name_len] = '\0';
+
+ char *packet_str = flow_to_string(headers, NULL);
+ VLOG_INFO("ACL name=%s, verdict=%s, severity=%s, packet=\"%s\"",
+ name_len ? name : "<unnamed>",
+ log_verdict_to_string(lph->verdict),
+ log_severity_to_string(lph->severity), packet_str);
+ free(packet_str);
+ free(name);
+}
+
+static void
process_packet_in(const struct ofp_header *msg, struct controller_ctx *ctx)
{
static struct vlog_rate_limit rl = VLOG_RATE_LIMIT_INIT(1, 5);
@@ -981,6 +1015,10 @@ process_packet_in(const struct ofp_header *msg, struct controller_ctx *ctx)
pinctrl_handle_dns_lookup(&packet, &pin, &userdata, &continuation, ctx);
break;
+ case ACTION_OPCODE_LOG:
+ pinctrl_handle_log(&packet, &headers, &userdata);
+ break;
+
default:
VLOG_WARN_RL(&rl, "unrecognized packet-in opcode %"PRIu32,
ntohl(ah->opcode));
@@ -33,6 +33,7 @@
#include "ovn/actions.h"
#include "ovn/expr.h"
#include "ovn/lex.h"
+#include "ovn/lib/ovn-log.h"
#include "packets.h"
#include "openvswitch/shash.h"
#include "simap.h"
@@ -1759,6 +1760,133 @@ ovnact_dns_lookup_free(struct ovnact_dns_lookup *dl OVS_UNUSED)
{
}
+static void
+parse_log_arg(struct action_context *ctx, struct ovnact_log *log)
+{
+
+ if (lexer_match_id(ctx->lexer, "verdict")) {
+ if (!lexer_force_match(ctx->lexer, LEX_T_EQUALS)) {
+ return;
+ }
+ if (lexer_match_id(ctx->lexer, "drop")) {
+ log->verdict = LOG_VERDICT_DROP;
+ } else if (lexer_match_id(ctx->lexer, "reject")) {
+ log->verdict = LOG_VERDICT_REJECT;
+ } else if (lexer_match_id(ctx->lexer, "allow")) {
+ log->verdict = LOG_VERDICT_ALLOW;
+ } else {
+ lexer_syntax_error(ctx->lexer, "unknown acl verdict");
+ }
+ } else if (lexer_match_id(ctx->lexer, "name")) {
+ if (!lexer_force_match(ctx->lexer, LEX_T_EQUALS)) {
+ return;
+ }
+ /* If there are multiple "name" arguments, use the first. */
+ if (log->name) {
+ lexer_get(ctx->lexer);
+ return;
+ }
+ if (ctx->lexer->token.type == LEX_T_STRING) {
+ /* Arbitrarily limit the name length to 64 bytes, since
+ * these will be encoded in datapath actions. */
+ if (strlen(ctx->lexer->token.s) >= 64) {
+ lexer_syntax_error(ctx->lexer, "name must be shorter "
+ "than 64 characters");
+ return;
+ }
+ log->name = xstrdup(ctx->lexer->token.s);
+ } else {
+ lexer_syntax_error(ctx->lexer, "expecting string");
+ return;
+ }
+ lexer_get(ctx->lexer);
+ } else if (lexer_match_id(ctx->lexer, "severity")) {
+ if (!lexer_force_match(ctx->lexer, LEX_T_EQUALS)) {
+ return;
+ }
+ if (ctx->lexer->token.type == LEX_T_ID) {
+ uint8_t severity = log_severity_from_string(ctx->lexer->token.s);
+ if (severity != UINT8_MAX) {
+ log->severity = severity;
+ } else {
+ lexer_syntax_error(ctx->lexer, "expecting integer");
+ lexer_get(ctx->lexer);
+ return;
+ }
+ } else {
+ lexer_syntax_error(ctx->lexer, "expecting token");
+ }
+ lexer_get(ctx->lexer);
+ } else {
+ lexer_syntax_error(ctx->lexer, NULL);
+ }
+}
+
+static void
+parse_LOG(struct action_context *ctx)
+{
+ struct ovnact_log *log = ovnact_put_LOG(ctx->ovnacts);
+
+ /* Provide default values. */
+ log->severity = LOG_SEVERITY_INFO;
+ log->verdict = LOG_VERDICT_UNKNOWN;
+
+ if (lexer_match(ctx->lexer, LEX_T_LPAREN)) {
+ while (!lexer_match(ctx->lexer, LEX_T_RPAREN)) {
+ parse_log_arg(ctx, log);
+ if (ctx->lexer->error) {
+ return;
+ }
+ lexer_match(ctx->lexer, LEX_T_COMMA);
+ }
+ }
+}
+
+static void
+format_LOG(const struct ovnact_log *log, struct ds *s)
+{
+ ds_put_cstr(s, "log(");
+
+ if (log->name) {
+ ds_put_format(s, "name=\"%s\", ", log->name);
+ }
+
+ ds_put_format(s, "verdict=%s, ", log_verdict_to_string(log->verdict));
+ ds_put_format(s, "severity=%s, ", log_severity_to_string(log->severity));
+
+ ds_chomp(s, ' ');
+ ds_chomp(s, ',');
+ ds_put_cstr(s, ");");
+}
+
+static void
+encode_LOG(const struct ovnact_log *log,
+ const struct ovnact_encode_params *ep OVS_UNUSED,
+ struct ofpbuf *ofpacts)
+{
+ size_t oc_offset = encode_start_controller_op(ACTION_OPCODE_LOG, false,
+ ofpacts);
+
+ struct log_pin_header *lph = ofpbuf_put_uninit(ofpacts, sizeof *lph);
+ lph->verdict = log->verdict;
+ lph->severity = log->severity;
+ lph->name_len = 0;
+
+ if (log->name) {
+ int name_len = strlen(log->name);
+ lph->name_len = htons(name_len);
+ ofpbuf_put(ofpacts, log->name, name_len);
+ }
+
+ encode_finish_controller_op(oc_offset, ofpacts);
+}
+
+static void
+ovnact_log_free(struct ovnact_log *log)
+{
+ free(log->name);
+}
+
/* Parses an assignment or exchange or put_dhcp_opts action. */
static void
parse_set_action(struct action_context *ctx)
@@ -1838,6 +1966,8 @@ parse_action(struct action_context *ctx)
parse_put_mac_bind(ctx, 128, ovnact_put_PUT_ND(ctx->ovnacts));
} else if (lexer_match_id(ctx->lexer, "set_queue")) {
parse_SET_QUEUE(ctx);
+ } else if (lexer_match_id(ctx->lexer, "log")) {
+ parse_LOG(ctx);
} else {
lexer_syntax_error(ctx->lexer, "expecting action");
}
@@ -10,6 +10,8 @@ ovn_lib_libovn_la_SOURCES = \
ovn/lib/expr.c \
ovn/lib/lex.c \
ovn/lib/ovn-dhcp.h \
+ ovn/lib/ovn-log.c \
+ ovn/lib/ovn-log.h \
ovn/lib/ovn-util.c \
ovn/lib/ovn-util.h \
ovn/lib/logical-fields.c \
new file mode 100644
@@ -0,0 +1,69 @@
+/*
+ * Copyright (c) 2017 Nicira, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <config.h>
+#include <string.h>
+#include "ovn/lib/ovn-log.h"
+
+const char *
+log_verdict_to_string(uint8_t verdict)
+{
+ if (verdict == LOG_VERDICT_ALLOW) {
+ return "allow";
+ } else if (verdict == LOG_VERDICT_DROP) {
+ return "drop";
+ } else if (verdict == LOG_VERDICT_REJECT) {
+ return "reject";
+ } else {
+ return "<unknown>";
+ }
+}
+
+const char *
+log_severity_to_string(uint8_t severity)
+{
+ if (severity == LOG_SEVERITY_ALERT) {
+ return "alert";
+ } else if (severity == LOG_SEVERITY_WARNING) {
+ return "warning";
+ } else if (severity == LOG_SEVERITY_NOTICE) {
+ return "notice";
+ } else if (severity == LOG_SEVERITY_INFO) {
+ return "info";
+ } else if (severity == LOG_SEVERITY_DEBUG) {
+ return "debug";
+ } else {
+ return "<unknown>";
+ }
+}
+
+uint8_t
+log_severity_from_string(const char *name)
+{
+ if (!strcmp(name, "alert")) {
+ return LOG_SEVERITY_ALERT;
+ } else if (!strcmp(name, "warning")) {
+ return LOG_SEVERITY_WARNING;
+ } else if (!strcmp(name, "notice")) {
+ return LOG_SEVERITY_NOTICE;
+ } else if (!strcmp(name, "info")) {
+ return LOG_SEVERITY_INFO;
+ } else if (!strcmp(name, "debug")) {
+ return LOG_SEVERITY_DEBUG;
+ } else {
+ return UINT8_MAX;
+ }
+}
new file mode 100644
@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2017 Nicira, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef OVN_LOG_H
+#define OVN_LOG_H 1
+
+#include <stdint.h>
+#include "openvswitch/types.h"
+
+
+struct log_pin_header {
+ uint8_t verdict; /* One of LOG_VERDICT_*. */
+ uint8_t severity; /* One of LOG_SEVERITY*. */
+ ovs_be16 name_len;
+ /* Followed by a 'name_len' string containing the rule's name. If
+ * there is no name for this rule, 'name_len' may be zero. */
+};
+
+enum log_verdict {
+ LOG_VERDICT_ALLOW,
+ LOG_VERDICT_DROP,
+ LOG_VERDICT_REJECT,
+ LOG_VERDICT_UNKNOWN = UINT8_MAX
+};
+
+const char *log_verdict_to_string(uint8_t verdict);
+
+
+/* Severity levels. Based on RFC5424 levels. */
+#define LOG_SEVERITY_ALERT 1
+#define LOG_SEVERITY_WARNING 4
+#define LOG_SEVERITY_NOTICE 5
+#define LOG_SEVERITY_INFO 6
+#define LOG_SEVERITY_DEBUG 7
+
+const char *log_severity_to_string(uint8_t severity);
+uint8_t log_severity_from_string(const char *name);
+
+#endif
@@ -2998,6 +2998,40 @@ build_pre_stateful(struct ovn_datapath *od, struct hmap *lflows)
}
static void
+build_acl_log(struct ds *actions, const struct nbrec_acl *acl)
+{
+ if (!acl->log) {
+ return;
+ }
+
+ ds_put_cstr(actions, "log(");
+
+ if (acl->name) {
+ ds_put_format(actions, "name=\"%s\", ", acl->name);
+ }
+
+ /* If a severity level isn't specified, default to "info". */
+ if (acl->severity) {
+ ds_put_format(actions, "severity=%s, ", acl->severity);
+ } else {
+ ds_put_format(actions, "severity=info, ");
+ }
+
+ if (!strcmp(acl->action, "drop")) {
+ ds_put_cstr(actions, "verdict=drop, ");
+ } else if (!strcmp(acl->action, "reject")) {
+ ds_put_cstr(actions, "verdict=reject, ");
+ } else if (!strcmp(acl->action, "allow")
+ || !strcmp(acl->action, "allow-related")) {
+ ds_put_cstr(actions, "verdict=allow, ");
+ }
+
+ ds_chomp(actions, ' ');
+ ds_chomp(actions, ',');
+ ds_put_cstr(actions, "); ");
+}
+
+static void
build_acls(struct ovn_datapath *od, struct hmap *lflows)
{
bool has_stateful = has_stateful_acl(od);
@@ -3111,11 +3145,17 @@ build_acls(struct ovn_datapath *od, struct hmap *lflows)
* may and then its return traffic would not have an
* associated conntrack entry and would return "+invalid". */
if (!has_stateful) {
+ struct ds actions = DS_EMPTY_INITIALIZER;
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "next;");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
- acl->match, "next;", stage_hint);
+ acl->match, ds_cstr(&actions),
+ stage_hint);
+ ds_destroy(&actions);
} else {
struct ds match = DS_EMPTY_INITIALIZER;
+ struct ds actions = DS_EMPTY_INITIALIZER;
/* Commit the connection tracking entry if it's a new
* connection that matches this ACL. After this commit,
@@ -3133,10 +3173,13 @@ build_acls(struct ovn_datapath *od, struct hmap *lflows)
" || (!ct.new && ct.est && !ct.rpl "
"&& ct_label.blocked == 1)) "
"&& (%s)", acl->match);
+ ds_put_cstr(&actions, REGBIT_CONNTRACK_COMMIT" = 1; ");
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "next;");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
ds_cstr(&match),
- REGBIT_CONNTRACK_COMMIT" = 1; next;",
+ ds_cstr(&actions),
stage_hint);
/* Match on traffic in the request direction for an established
@@ -3146,20 +3189,26 @@ build_acls(struct ovn_datapath *od, struct hmap *lflows)
* connection is still allowed by the currently defined
* policy. */
ds_clear(&match);
+ ds_clear(&actions);
ds_put_format(&match,
"!ct.new && ct.est && !ct.rpl"
" && ct_label.blocked == 0 && (%s)",
acl->match);
+
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "next;");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
- ds_cstr(&match), "next;",
+ ds_cstr(&match), ds_cstr(&actions),
stage_hint);
ds_destroy(&match);
+ ds_destroy(&actions);
}
} else if (!strcmp(acl->action, "drop")
|| !strcmp(acl->action, "reject")) {
struct ds match = DS_EMPTY_INITIALIZER;
+ struct ds actions = DS_EMPTY_INITIALIZER;
/* XXX Need to support "reject", treat it as "drop;" for now. */
if (!strcmp(acl->action, "reject")) {
@@ -3177,9 +3226,12 @@ build_acls(struct ovn_datapath *od, struct hmap *lflows)
"(!ct.est || (ct.est && ct_label.blocked == 1)) "
"&& (%s)",
acl->match);
+ ds_clear(&actions);
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "/* drop */");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
- ds_cstr(&match), "drop;",
+ ds_cstr(&match), ds_cstr(&actions),
stage_hint);
/* For an existing connection without ct_label set, we've
@@ -3193,25 +3245,32 @@ build_acls(struct ovn_datapath *od, struct hmap *lflows)
* ct_commit() to the "stateful" stage, but since we're
* dropping the packet, we go ahead and do it here. */
ds_clear(&match);
+ ds_clear(&actions);
ds_put_format(&match,
"ct.est && ct_label.blocked == 0 && (%s)",
acl->match);
+ ds_put_cstr(&actions, "ct_commit(ct_label=1/1); ");
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "/* drop */");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
- ds_cstr(&match),
- "ct_commit(ct_label=1/1);",
+ ds_cstr(&match), ds_cstr(&actions),
stage_hint);
- ds_destroy(&match);
} else {
/* There are no stateful ACLs in use on this datapath,
* so a "drop" ACL is simply the "drop" logical flow action
* in all cases. */
+ ds_clear(&actions);
+ build_acl_log(&actions, acl);
+ ds_put_cstr(&actions, "/* drop */");
ovn_lflow_add_with_hint(lflows, od, stage,
acl->priority + OVN_ACL_PRI_OFFSET,
- acl->match, "drop;", stage_hint);
- ds_destroy(&match);
+ acl->match, ds_cstr(&actions),
+ stage_hint);
}
+ ds_destroy(&match);
+ ds_destroy(&actions);
}
free(stage_hint);
}
@@ -1,7 +1,7 @@
{
"name": "OVN_Northbound",
- "version": "5.7.0",
- "cksum": "3754583060 16164",
+ "version": "5.8.0",
+ "cksum": "2812300190 16766",
"tables": {
"NB_Global": {
"columns": {
@@ -116,7 +116,7 @@
"isRoot": true},
"Load_Balancer": {
"columns": {
- "name": {"type": "string"},
+ "name": {"type": "string"},
"vips": {
"type": {"key": "string", "value": "string",
"min": 0, "max": "unlimited"}},
@@ -130,6 +130,9 @@
"isRoot": true},
"ACL": {
"columns": {
+ "name": {"type": {"key": {"type": "string",
+ "maxLength": 63},
+ "min": 0, "max": 1}},
"priority": {"type": {"key": {"type": "integer",
"minInteger": 0,
"maxInteger": 32767}}},
@@ -139,6 +142,12 @@
"action": {"type": {"key": {"type": "string",
"enum": ["set", ["allow", "allow-related", "drop", "reject"]]}}},
"log": {"type": "boolean"},
+ "severity": {"type": {"key": {"type": "string",
+ "enum": ["set",
+ ["alert", "warning",
+ "notice", "info",
+ "debug"]]},
+ "min": 0, "max": 1}},
"external_ids": {
"type": {"key": "string", "value": "string",
"min": 0, "max": "unlimited"}}},
@@ -958,6 +958,13 @@
<ref column="match"/>, and <code>deny</code> as <ref column="action"/>.)
</p>
+ <column name="name">
+ <p>
+ A name for the ACL. The name has no special meaning, but may be
+ used by the logging system to identify the source rule.
+ </p>
+ </column>
+
<column name="priority">
<p>
The ACL rule's priority. Rules with numerically higher priority
@@ -1048,9 +1055,16 @@
log message on the transport node or nodes that perform ACL processing.
Logging may be combined with any <ref column="action"/>.
</p>
+ </column>
+ <column name="severity">
<p>
- Logging is not yet implemented.
+ When <ref column="log"/> is <code>true</code> indicates the
+ severity of the ACL. The severity levels match those of syslog
+ with the following values (from more to less serious):
+ <code>alert</code>, <code>warning</code>, <code>notice</code>,
+ <code>info</code>, or <code>debug</code>. If a severity is not
+ specified, the default is <code>info</code>.
</p>
</column>
@@ -1515,6 +1515,38 @@
</dd>
</dl>
+ <dl>
+ <dt>
+ <code>log(<var>argument</var>, </code>...<code>);</code>
+ </dt>
+
+ <dd>
+ <p>
+ Send the packet to <code>ovn-controller</code> for potential
+ logging. The local <code>ovn-controller</code> will make a
+ decision whether or where to log the packet.
+ </p>
+ <p>
+ The <code>log</code> action takes zero or more of the
+ following <var>arguments</var>:
+ </p>
+ <ul>
+ <li><code>name</code> An optional name for the ACL.</li>
+ <li><code>severity</code> An indication of the severity
+ of the event. The value is one of following (from more to
+ less serious): <code>alert</code>, <code>warning</code>,
+ <code>notice</code>, <code>info</code>, or
+ <code>debug</code>. If a severity is not provided, the
+ default is <code>info</code>.
+ </li>
+ <li><code>verdict</code> The verdict for packets matching
+ the flow. One of <code>allow</code>, <code>deny</code>,
+ or <code>reject</code>.
+ </li>
+ </ul>
+ </dd>
+ </dl>
+
<p>
The following actions will likely be useful later, but they have not
been thought out carefully.
@@ -76,17 +76,30 @@
<h1>Logical Switch ACL Commands</h1>
<dl>
- <dt>[<code>--log</code>] [<code>--may-exist</code>] <code>acl-add</code> <var>switch</var> <var>direction</var> <var>priority</var> <var>match</var> <var>action</var></dt>
- <dd>
- Adds the specified ACL to <var>switch</var>.
- <var>direction</var> must be either <code>from-lport</code> or
- <code>to-lport</code>. <var>priority</var> must be between
- <code>0</code> and <code>32767</code>, inclusive. If
- <code>--log</code> is specified, packet logging is enabled for the
- ACL. A full description of the fields are in <code>ovn-nb</code>(5).
- If <code>--may-exist</code> is specified, adding a duplicated ACL
- succeeds but the ACL is not really created. Without <code>--may-exist</code>,
- adding a duplicated ACL results in error.
+ <dt>[<code>--log</code>] [<code>--may-exist</code>] <code>acl-add</code> <var>switch</var> <var>direction</var> <var>priority</var> <var>match</var> <var>verdict</var> [<code>severity=</code><var>severity</var>] [<code>name=</code><var>name</var>]</dt>
+ <dd>
+ <p>
+ Adds the specified ACL to <var>switch</var>.
+ <var>direction</var> must be either <code>from-lport</code> or
+ <code>to-lport</code>. <var>priority</var> must be between
+ <code>0</code> and <code>32767</code>, inclusive. A full
+ description of the fields are in <code>ovn-nb</code>(5). If
+ <code>--may-exist</code> is specified, adding a duplicated ACL
+ succeeds but the ACL is not really created. Without
+ <code>--may-exist</code>, adding a duplicated ACL results in
+ error.
+ </p>
+
+ <p>
+ If <code>--log</code> is specified, packet logging is enabled
+ for the ACL. When logging is enabled, the optional arguments
+ <code>severity</code> and <code>name</code> specify a severity
+ and name for the log entries, respectively. The severity must
+ be one of <code>alert</code>, <code>warning</code>,
+ <code>notice</code>, <code>info</code>, or <code>debug</code>.
+ If a severity is not specified, the default is
+ <code>info</code>.
+ </p>
</dd>
<dt><code>acl-del</code> <var>switch</var> [<var>direction</var> [<var>priority</var> <var>match</var>]]</dt>
@@ -25,6 +25,7 @@
#include "fatal-signal.h"
#include "openvswitch/json.h"
#include "ovn/lib/ovn-nb-idl.h"
+#include "ovn/lib/ovn-log.h"
#include "ovn/lib/ovn-util.h"
#include "packets.h"
#include "poll-loop.h"
@@ -332,7 +333,7 @@ Logical switch commands:\n\
ls-list print the names of all logical switches\n\
\n\
ACL commands:\n\
- acl-add SWITCH DIRECTION PRIORITY MATCH ACTION [log]\n\
+ acl-add [--log] SWITCH DIRECTION PRIORITY MATCH ACTION\n\
add an ACL to SWITCH\n\
acl-del SWITCH [DIRECTION [PRIORITY MATCH]]\n\
remove ACLs from SWITCH\n\
@@ -1362,10 +1363,27 @@ nbctl_acl_add(struct ctl_context *ctx)
nbrec_acl_set_direction(acl, direction);
nbrec_acl_set_match(acl, ctx->argv[4]);
nbrec_acl_set_action(acl, action);
+
if (shash_find(&ctx->options, "--log") != NULL) {
nbrec_acl_set_log(acl, true);
}
+ /* Optional fields for logging. */
+ char **settings = (char **) &ctx->argv[6];
+ int n_settings = ctx->argc - 6;
+
+ for (int i = 0; i < n_settings; i++) {
+ if (!strncmp(settings[i], "severity=", 9)) {
+ const char *severity = settings[i] + 9;
+ if (log_severity_from_string(severity) == UINT8_MAX) {
+ ctl_fatal("bad severity: %s", severity);
+ }
+ nbrec_acl_set_severity(acl, severity);
+ } else if (!strncmp(settings[i], "name=", 5)) {
+ nbrec_acl_set_name(acl, settings[i] + 5);
+ }
+ }
+
/* Check if same acl already exists for the ls */
for (size_t i = 0; i < ls->n_acls; i++) {
if (!acl_cmp(&ls->acls[i], &acl)) {
@@ -3364,8 +3382,8 @@ static const struct ctl_command_syntax nbctl_commands[] = {
{ "ls-list", 0, 0, "", NULL, nbctl_ls_list, NULL, "", RO },
/* acl commands. */
- { "acl-add", 5, 5, "SWITCH DIRECTION PRIORITY MATCH ACTION", NULL,
- nbctl_acl_add, NULL, "--log,--may-exist", RW },
+ { "acl-add", 5, 8, "SWITCH DIRECTION PRIORITY MATCH ACTION", NULL,
+ nbctl_acl_add, NULL, "--log,--may-exist,--name=,--severity=", RW },
{ "acl-del", 1, 4, "SWITCH [DIRECTION [PRIORITY MATCH]]", NULL,
nbctl_acl_del, NULL, "", RW },
{ "acl-list", 1, 1, "SWITCH", NULL, nbctl_acl_list, NULL, "", RO },
@@ -37,6 +37,7 @@
#include "ovn/lib/logical-fields.h"
#include "ovn/lib/ovn-sb-idl.h"
#include "ovn/lib/ovn-dhcp.h"
+#include "ovn/lib/ovn-log.h"
#include "ovn/lib/ovn-util.h"
#include "ovsdb-idl.h"
#include "poll-loop.h"
@@ -1682,6 +1683,20 @@ execute_ct_nat(const struct ovnact_ct_nat *ct_nat,
}
static void
+execute_log(const struct ovnact_log *log, struct flow *uflow,
+ struct ovs_list *super)
+{
+ char *packet_str = flow_to_string(uflow, NULL);
+ ovntrace_node_append(super, OVNTRACE_NODE_TRANSFORMATION,
+ "LOG: ACL name=%s, verdict=%s, severity=%s, packet=\"%s\"",
+ log->name ? log->name : "<unnamed>",
+ log_verdict_to_string(log->verdict),
+ log_severity_to_string(log->severity),
+ packet_str);
+ free(packet_str);
+}
+
+static void
trace_actions(const struct ovnact *ovnacts, size_t ovnacts_len,
const struct ovntrace_datapath *dp, struct flow *uflow,
uint8_t table_id, enum ovnact_pipeline pipeline,
@@ -1816,6 +1831,10 @@ trace_actions(const struct ovnact *ovnacts, size_t ovnacts_len,
case OVNACT_DNS_LOOKUP:
execute_dns_lookup(ovnact_get_DNS_LOOKUP(a), uflow, super);
break;
+
+ case OVNACT_LOG:
+ execute_log(ovnact_get_LOG(a), uflow, super);
+ break;
}
}
@@ -5741,6 +5741,111 @@ OVN_CLEANUP([hv1],[hv2])
AT_CLEANUP
+
+AT_SETUP([ovn -- ACL logging])
+AT_KEYWORDS([ovn])
+ovn_start
+
+net_add n1
+
+sim_add hv
+as hv
+ovs-vsctl add-br br-phys
+ovn_attach n1 br-phys 192.168.0.1
+for i in lp1 lp2; do
+ ovs-vsctl -- add-port br-int $i -- \
+ set interface $i external-ids:iface-id=$i \
+ options:tx_pcap=hv/$i-tx.pcap \
+ options:rxq_pcap=hv/$i-rx.pcap
+done
+
+lp1_mac="f0:00:00:00:00:01"
+lp1_ip="192.168.1.2"
+
+lp2_mac="f0:00:00:00:00:02"
+lp2_ip="192.168.1.3"
+
+ovn-nbctl ls-add lsw0
+ovn-nbctl --wait=sb lsp-add lsw0 lp1
+ovn-nbctl --wait=sb lsp-add lsw0 lp2
+ovn-nbctl lsp-set-addresses lp1 $lp1_mac
+ovn-nbctl lsp-set-addresses lp2 $lp2_mac
+ovn-nbctl --wait=sb sync
+
+ovn-nbctl acl-add lsw0 to-lport 1000 'tcp.dst==80' drop
+ovn-nbctl --log acl-add lsw0 to-lport 1000 'tcp.dst==81' drop severity=alert name=drop-flow
+
+ovn-nbctl acl-add lsw0 to-lport 1000 'tcp.dst==82' allow
+ovn-nbctl --log acl-add lsw0 to-lport 1000 'tcp.dst==83' allow severity=info name=allow-flow
+
+ovn-nbctl acl-add lsw0 to-lport 1000 'tcp.dst==84' allow-related
+ovn-nbctl --log acl-add lsw0 to-lport 1000 'tcp.dst==85' allow-related
+
+ovn-nbctl acl-add lsw0 to-lport 1000 'tcp.dst==86' reject
+ovn-nbctl --log acl-add lsw0 to-lport 1000 'tcp.dst==87' reject severity=alert name=reject-flow
+
+ovn-sbctl dump-flows
+
+
+# Send packet that should be dropped without logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4360 && tcp.dst==80"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should be dropped with logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4361 && tcp.dst==81"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should be allowed without logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4362 && tcp.dst==82"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should be allowed with logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4363 && tcp.dst==83"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should allow related flows without logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4364 && tcp.dst==84"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should allow related flows with logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4365 && tcp.dst==85"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should allow related flows with logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4366 && tcp.dst==86"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+# Send packet that should allow related flows with logging.
+packet="inport==\"lp1\" && eth.src==$lp1_mac && eth.dst==$lp2_mac &&
+ ip4 && ip.ttl==64 && ip4.src==$lp1_ip && ip4.dst==$lp2_ip &&
+ tcp && tcp.flags==2 && tcp.src==4367 && tcp.dst==87"
+as hv ovs-appctl -t ovn-controller inject-pkt "$packet"
+
+AT_CHECK([grep 'ACL' hv/ovn-controller.log | sed 's/.*ACL /ACL /'], [0], [dnl
+ACL name=drop-flow, verdict=drop, severity=alert, packet="tcp,vlan_tci=0x0000,dl_src=f0:00:00:00:00:01,dl_dst=f0:00:00:00:00:02,nw_src=192.168.1.2,nw_dst=192.168.1.3,nw_tos=0,nw_ecn=0,nw_ttl=64,tp_src=4361,tp_dst=81,tcp_flags=syn"
+ACL name=allow-flow, verdict=allow, severity=info, packet="tcp,vlan_tci=0x0000,dl_src=f0:00:00:00:00:01,dl_dst=f0:00:00:00:00:02,nw_src=192.168.1.2,nw_dst=192.168.1.3,nw_tos=0,nw_ecn=0,nw_ttl=64,tp_src=4363,tp_dst=83,tcp_flags=syn"
+ACL name=<unnamed>, verdict=allow, severity=info, packet="tcp,vlan_tci=0x0000,dl_src=f0:00:00:00:00:01,dl_dst=f0:00:00:00:00:02,nw_src=192.168.1.2,nw_dst=192.168.1.3,nw_tos=0,nw_ecn=0,nw_ttl=64,tp_src=4365,tp_dst=85,tcp_flags=syn"
+ACL name=reject-flow, verdict=reject, severity=alert, packet="tcp,vlan_tci=0x0000,dl_src=f0:00:00:00:00:01,dl_dst=f0:00:00:00:00:02,nw_src=192.168.1.2,nw_dst=192.168.1.3,nw_tos=0,nw_ecn=0,nw_ttl=64,tp_src=4367,tp_dst=87,tcp_flags=syn"
+])
+
+OVN_CLEANUP([hv])
+AT_CLEANUP
+
+
AT_SETUP([ovn -- DSCP marking check])
AT_KEYWORDS([ovn])
ovn_start
Signed-off-by: Justin Pettit <jpettit@ovn.org> --- NEWS | 1 + include/ovn/actions.h | 67 ++++++++++++------- ovn/controller/ovn-controller.8.xml | 9 +++ ovn/controller/pinctrl.c | 38 +++++++++++ ovn/lib/actions.c | 130 ++++++++++++++++++++++++++++++++++++ ovn/lib/automake.mk | 2 + ovn/lib/ovn-log.c | 69 +++++++++++++++++++ ovn/lib/ovn-log.h | 52 +++++++++++++++ ovn/northd/ovn-northd.c | 77 ++++++++++++++++++--- ovn/ovn-nb.ovsschema | 15 ++++- ovn/ovn-nb.xml | 16 ++++- ovn/ovn-sb.xml | 32 +++++++++ ovn/utilities/ovn-nbctl.8.xml | 35 +++++++--- ovn/utilities/ovn-nbctl.c | 24 ++++++- ovn/utilities/ovn-trace.c | 19 ++++++ tests/ovn.at | 105 +++++++++++++++++++++++++++++ 16 files changed, 640 insertions(+), 51 deletions(-) create mode 100644 ovn/lib/ovn-log.c create mode 100644 ovn/lib/ovn-log.h