blob: ee8fc5da1dfed255211632ba3d60fbfb30558da4 [file] [log] [blame]
AppaRao Pulie5aaf042020-03-20 01:05:52 +05301/*
2// Copyright (c) 2020 Intel Corporation
3//
4// Licensed under the Apache License, Version 2.0 (the "License");
5// you may not use this file except in compliance with the License.
6// You may obtain a copy of the License at
7//
8// http://www.apache.org/licenses/LICENSE-2.0
9//
10// Unless required by applicable law or agreed to in writing, software
11// distributed under the License is distributed on an "AS IS" BASIS,
12// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13// See the License for the specific language governing permissions and
14// limitations under the License.
15*/
16#pragma once
Ed Tanous3ccb3ad2023-01-13 17:40:03 -080017#include "app.hpp"
AppaRao Pulib52664e2020-04-09 21:36:51 +053018#include "event_service_manager.hpp"
Ed Tanous3ccb3ad2023-01-13 17:40:03 -080019#include "http/utility.hpp"
20#include "logging.hpp"
21#include "query.hpp"
22#include "registries/privilege_registry.hpp"
Chicago Duan3d307082020-11-26 14:12:12 +080023#include "snmp_trap_event_clients.hpp"
AppaRao Pulie5aaf042020-03-20 01:05:52 +053024
Ed Tanous601c71a2021-09-08 16:40:12 -070025#include <boost/beast/http/fields.hpp>
Chicago Duan3d307082020-11-26 14:12:12 +080026#include <boost/system/error_code.hpp>
Ed Tanousa716aa72023-08-01 11:35:53 -070027#include <boost/url/parse.hpp>
Chicago Duan3d307082020-11-26 14:12:12 +080028#include <sdbusplus/unpack_properties.hpp>
29#include <utils/dbus_utils.hpp>
Ed Tanoused398212021-06-09 17:05:54 -070030
Chicago Duan3d307082020-11-26 14:12:12 +080031#include <charconv>
32#include <memory>
Ed Tanous3544d2a2023-08-06 18:12:20 -070033#include <ranges>
Patrick Williams1e270c52021-12-04 06:06:56 -060034#include <span>
Chicago Duan3d307082020-11-26 14:12:12 +080035#include <string>
Patrick Williams1e270c52021-12-04 06:06:56 -060036
AppaRao Pulie5aaf042020-03-20 01:05:52 +053037namespace redfish
38{
39
AppaRao Puli156d6b02020-04-25 06:04:05 +053040static constexpr const std::array<const char*, 2> supportedEvtFormatTypes = {
41 eventFormatType, metricReportFormatType};
AppaRao Pulie5aaf042020-03-20 01:05:52 +053042static constexpr const std::array<const char*, 3> supportedRegPrefixes = {
P Dheeraj Srujan Kumarb304bd72021-01-29 17:46:35 +053043 "Base", "OpenBMC", "TaskEvent"};
AppaRao Pulie5aaf042020-03-20 01:05:52 +053044static constexpr const std::array<const char*, 3> supportedRetryPolicies = {
45 "TerminateAfterRetries", "SuspendRetries", "RetryForever"};
46
Sunitha Harishe56f2542020-07-22 02:38:59 -050047static constexpr const std::array<const char*, 1> supportedResourceTypes = {
48 "Task"};
Sunitha Harishe56f2542020-07-22 02:38:59 -050049
John Edward Broadbent7e860f12021-04-08 15:57:16 -070050inline void requestRoutesEventService(App& app)
AppaRao Pulie5aaf042020-03-20 01:05:52 +053051{
John Edward Broadbent7e860f12021-04-08 15:57:16 -070052 BMCWEB_ROUTE(app, "/redfish/v1/EventService/")
Ed Tanoused398212021-06-09 17:05:54 -070053 .privileges(redfish::privileges::getEventService)
Ed Tanous002d39b2022-05-31 08:59:27 -070054 .methods(boost::beast::http::verb::get)(
55 [&app](const crow::Request& req,
56 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp) {
Carson Labrado3ba00072022-06-06 19:40:56 +000057 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -070058 {
59 return;
60 }
Ed Tanous14766872022-03-15 10:44:42 -070061
Ed Tanous002d39b2022-05-31 08:59:27 -070062 asyncResp->res.jsonValue["@odata.id"] = "/redfish/v1/EventService";
63 asyncResp->res.jsonValue["@odata.type"] =
64 "#EventService.v1_5_0.EventService";
65 asyncResp->res.jsonValue["Id"] = "EventService";
66 asyncResp->res.jsonValue["Name"] = "Event Service";
AppaRao Puli5e44e3d2021-03-16 15:37:24 +000067 asyncResp->res.jsonValue["ServerSentEventUri"] =
68 "/redfish/v1/EventService/SSE";
69
Ed Tanous002d39b2022-05-31 08:59:27 -070070 asyncResp->res.jsonValue["Subscriptions"]["@odata.id"] =
71 "/redfish/v1/EventService/Subscriptions";
72 asyncResp->res
73 .jsonValue["Actions"]["#EventService.SubmitTestEvent"]["target"] =
74 "/redfish/v1/EventService/Actions/EventService.SubmitTestEvent";
AppaRao Pulie5aaf042020-03-20 01:05:52 +053075
Ed Tanous002d39b2022-05-31 08:59:27 -070076 const persistent_data::EventServiceConfig eventServiceConfig =
77 persistent_data::EventServiceStore::getInstance()
78 .getEventServiceConfig();
zhanghch058d1b46d2021-04-01 11:18:24 +080079
Ed Tanous002d39b2022-05-31 08:59:27 -070080 asyncResp->res.jsonValue["Status"]["State"] =
81 (eventServiceConfig.enabled ? "Enabled" : "Disabled");
82 asyncResp->res.jsonValue["ServiceEnabled"] = eventServiceConfig.enabled;
83 asyncResp->res.jsonValue["DeliveryRetryAttempts"] =
84 eventServiceConfig.retryAttempts;
85 asyncResp->res.jsonValue["DeliveryRetryIntervalSeconds"] =
86 eventServiceConfig.retryTimeoutInterval;
87 asyncResp->res.jsonValue["EventFormatTypes"] = supportedEvtFormatTypes;
88 asyncResp->res.jsonValue["RegistryPrefixes"] = supportedRegPrefixes;
89 asyncResp->res.jsonValue["ResourceTypes"] = supportedResourceTypes;
AppaRao Pulie5aaf042020-03-20 01:05:52 +053090
Ed Tanous613dabe2022-07-09 11:17:36 -070091 nlohmann::json::object_t supportedSSEFilters;
92 supportedSSEFilters["EventFormatType"] = true;
93 supportedSSEFilters["MessageId"] = true;
94 supportedSSEFilters["MetricReportDefinition"] = true;
95 supportedSSEFilters["RegistryPrefix"] = true;
96 supportedSSEFilters["OriginResource"] = false;
97 supportedSSEFilters["ResourceType"] = false;
AppaRao Puli7d1cc382020-05-16 02:42:22 +053098
Ed Tanous002d39b2022-05-31 08:59:27 -070099 asyncResp->res.jsonValue["SSEFilterPropertiesSupported"] =
Ed Tanous613dabe2022-07-09 11:17:36 -0700100 std::move(supportedSSEFilters);
Patrick Williams5a39f772023-10-20 11:20:21 -0500101 });
Ayushi Smriti07941a82020-05-21 15:55:34 +0530102
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700103 BMCWEB_ROUTE(app, "/redfish/v1/EventService/")
Ed Tanoused398212021-06-09 17:05:54 -0700104 .privileges(redfish::privileges::patchEventService)
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700105 .methods(boost::beast::http::verb::patch)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700106 [&app](const crow::Request& req,
107 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000108 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700109 {
110 return;
111 }
112 std::optional<bool> serviceEnabled;
113 std::optional<uint32_t> retryAttemps;
114 std::optional<uint32_t> retryInterval;
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530115
Ed Tanous002d39b2022-05-31 08:59:27 -0700116 if (!json_util::readJsonPatch(
117 req, asyncResp->res, "ServiceEnabled", serviceEnabled,
118 "DeliveryRetryAttempts", retryAttemps,
119 "DeliveryRetryIntervalSeconds", retryInterval))
120 {
121 return;
122 }
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530123
Ed Tanous002d39b2022-05-31 08:59:27 -0700124 persistent_data::EventServiceConfig eventServiceConfig =
125 persistent_data::EventServiceStore::getInstance()
126 .getEventServiceConfig();
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700127
Ed Tanous002d39b2022-05-31 08:59:27 -0700128 if (serviceEnabled)
129 {
130 eventServiceConfig.enabled = *serviceEnabled;
131 }
Sunitha Harishe56f2542020-07-22 02:38:59 -0500132
Ed Tanous002d39b2022-05-31 08:59:27 -0700133 if (retryAttemps)
134 {
135 // Supported range [1-3]
136 if ((*retryAttemps < 1) || (*retryAttemps > 3))
137 {
138 messages::queryParameterOutOfRange(
139 asyncResp->res, std::to_string(*retryAttemps),
140 "DeliveryRetryAttempts", "[1-3]");
141 }
142 else
143 {
144 eventServiceConfig.retryAttempts = *retryAttemps;
145 }
146 }
P Dheeraj Srujan Kumarb304bd72021-01-29 17:46:35 +0530147
Ed Tanous002d39b2022-05-31 08:59:27 -0700148 if (retryInterval)
149 {
Gunnar Mills33a32b32022-11-17 14:29:07 -0600150 // Supported range [5 - 180]
151 if ((*retryInterval < 5) || (*retryInterval > 180))
Ed Tanous002d39b2022-05-31 08:59:27 -0700152 {
153 messages::queryParameterOutOfRange(
154 asyncResp->res, std::to_string(*retryInterval),
Gunnar Mills33a32b32022-11-17 14:29:07 -0600155 "DeliveryRetryIntervalSeconds", "[5-180]");
Ed Tanous002d39b2022-05-31 08:59:27 -0700156 }
157 else
158 {
159 eventServiceConfig.retryTimeoutInterval = *retryInterval;
160 }
161 }
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700162
Ed Tanous002d39b2022-05-31 08:59:27 -0700163 EventServiceManager::getInstance().setEventServiceConfig(
164 eventServiceConfig);
Patrick Williams5a39f772023-10-20 11:20:21 -0500165 });
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700166}
167
168inline void requestRoutesSubmitTestEvent(App& app)
169{
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700170 BMCWEB_ROUTE(
171 app, "/redfish/v1/EventService/Actions/EventService.SubmitTestEvent/")
Ed Tanoused398212021-06-09 17:05:54 -0700172 .privileges(redfish::privileges::postEventService)
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700173 .methods(boost::beast::http::verb::post)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700174 [&app](const crow::Request& req,
175 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000176 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700177 {
178 return;
179 }
180 if (!EventServiceManager::getInstance().sendTestEventLog())
181 {
182 messages::serviceDisabled(asyncResp->res,
183 "/redfish/v1/EventService/");
184 return;
185 }
186 asyncResp->res.result(boost::beast::http::status::no_content);
Patrick Williams5a39f772023-10-20 11:20:21 -0500187 });
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700188}
189
Chicago Duan3d307082020-11-26 14:12:12 +0800190inline void doSubscriptionCollection(
Ed Tanouse81de512023-06-27 17:07:00 -0700191 const boost::system::error_code& ec,
Chicago Duan3d307082020-11-26 14:12:12 +0800192 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
193 const dbus::utility::ManagedObjectType& resp)
194{
195 if (ec)
196 {
Ed Tanous13061012023-07-25 11:12:19 -0700197 if (ec.value() == EBADR || ec.value() == EHOSTUNREACH)
Chicago Duan3d307082020-11-26 14:12:12 +0800198 {
199 // This is an optional process so just return if it isn't there
200 return;
201 }
202
Ed Tanous62598e32023-07-17 17:06:25 -0700203 BMCWEB_LOG_ERROR("D-Bus response error on GetManagedObjects {}", ec);
Chicago Duan3d307082020-11-26 14:12:12 +0800204 messages::internalError(asyncResp->res);
205 return;
206 }
207 nlohmann::json& memberArray = asyncResp->res.jsonValue["Members"];
208 for (const auto& objpath : resp)
209 {
210 sdbusplus::message::object_path path(objpath.first);
211 const std::string snmpId = path.filename();
212 if (snmpId.empty())
213 {
Ed Tanous62598e32023-07-17 17:06:25 -0700214 BMCWEB_LOG_ERROR("The SNMP client ID is wrong");
Chicago Duan3d307082020-11-26 14:12:12 +0800215 messages::internalError(asyncResp->res);
216 return;
217 }
218
219 getSnmpSubscriptionList(asyncResp, snmpId, memberArray);
220 }
221}
222
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700223inline void requestRoutesEventDestinationCollection(App& app)
224{
Gayathri Leburu1ebe3e42022-02-09 10:45:19 +0000225 BMCWEB_ROUTE(app, "/redfish/v1/EventService/Subscriptions/")
Ed Tanoused398212021-06-09 17:05:54 -0700226 .privileges(redfish::privileges::getEventDestinationCollection)
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700227 .methods(boost::beast::http::verb::get)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700228 [&app](const crow::Request& req,
229 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000230 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700231 {
232 return;
233 }
234 asyncResp->res.jsonValue["@odata.type"] =
235 "#EventDestinationCollection.EventDestinationCollection";
236 asyncResp->res.jsonValue["@odata.id"] =
237 "/redfish/v1/EventService/Subscriptions";
238 asyncResp->res.jsonValue["Name"] = "Event Destination Collections";
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700239
Ed Tanous002d39b2022-05-31 08:59:27 -0700240 nlohmann::json& memberArray = asyncResp->res.jsonValue["Members"];
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700241
Ed Tanous002d39b2022-05-31 08:59:27 -0700242 std::vector<std::string> subscripIds =
243 EventServiceManager::getInstance().getAllIDs();
244 memberArray = nlohmann::json::array();
245 asyncResp->res.jsonValue["Members@odata.count"] = subscripIds.size();
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700246
Ed Tanous002d39b2022-05-31 08:59:27 -0700247 for (const std::string& id : subscripIds)
248 {
249 nlohmann::json::object_t member;
Chicago Duan3d307082020-11-26 14:12:12 +0800250 member["@odata.id"] = boost::urls::format(
251 "/redfish/v1/EventService/Subscriptions/{}" + id);
Patrick Williamsb2ba3072023-05-12 10:27:39 -0500252 memberArray.emplace_back(std::move(member));
Ed Tanous002d39b2022-05-31 08:59:27 -0700253 }
Chicago Duan3d307082020-11-26 14:12:12 +0800254 crow::connections::systemBus->async_method_call(
Ed Tanouse81de512023-06-27 17:07:00 -0700255 [asyncResp](const boost::system::error_code& ec,
Chicago Duan3d307082020-11-26 14:12:12 +0800256 const dbus::utility::ManagedObjectType& resp) {
257 doSubscriptionCollection(ec, asyncResp, resp);
Patrick Williams5a39f772023-10-20 11:20:21 -0500258 },
Chicago Duan3d307082020-11-26 14:12:12 +0800259 "xyz.openbmc_project.Network.SNMP",
260 "/xyz/openbmc_project/network/snmp/manager",
261 "org.freedesktop.DBus.ObjectManager", "GetManagedObjects");
Patrick Williams5a39f772023-10-20 11:20:21 -0500262 });
Chicago Duan3d307082020-11-26 14:12:12 +0800263
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700264 BMCWEB_ROUTE(app, "/redfish/v1/EventService/Subscriptions/")
Abhishek Patel7eeafa72021-07-28 10:59:16 -0500265 .privileges(redfish::privileges::postEventDestinationCollection)
Ed Tanous002d39b2022-05-31 08:59:27 -0700266 .methods(boost::beast::http::verb::post)(
267 [&app](const crow::Request& req,
268 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000269 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700270 {
271 return;
272 }
273 if (EventServiceManager::getInstance().getNumberOfSubscriptions() >=
274 maxNoOfSubscriptions)
275 {
276 messages::eventSubscriptionLimitExceeded(asyncResp->res);
277 return;
278 }
279 std::string destUrl;
280 std::string protocol;
281 std::optional<std::string> context;
282 std::optional<std::string> subscriptionType;
283 std::optional<std::string> eventFormatType2;
284 std::optional<std::string> retryPolicy;
285 std::optional<std::vector<std::string>> msgIds;
286 std::optional<std::vector<std::string>> regPrefixes;
287 std::optional<std::vector<std::string>> resTypes;
288 std::optional<std::vector<nlohmann::json>> headers;
289 std::optional<std::vector<nlohmann::json>> mrdJsonArray;
Ed Tanousfffb8c12022-02-07 23:53:03 -0800290
Ed Tanous002d39b2022-05-31 08:59:27 -0700291 if (!json_util::readJsonPatch(
292 req, asyncResp->res, "Destination", destUrl, "Context", context,
293 "Protocol", protocol, "SubscriptionType", subscriptionType,
294 "EventFormatType", eventFormatType2, "HttpHeaders", headers,
295 "RegistryPrefixes", regPrefixes, "MessageIds", msgIds,
296 "DeliveryRetryPolicy", retryPolicy, "MetricReportDefinitions",
297 mrdJsonArray, "ResourceTypes", resTypes))
298 {
299 return;
300 }
301
AppaRao Puli600af5f2021-10-06 21:51:16 +0000302 // https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers
303 static constexpr const uint16_t maxDestinationSize = 2000;
304 if (destUrl.size() > maxDestinationSize)
305 {
306 messages::stringValueTooLong(asyncResp->res, "Destination",
307 maxDestinationSize);
308 return;
309 }
310
Ed Tanous002d39b2022-05-31 08:59:27 -0700311 if (regPrefixes && msgIds)
312 {
313 if (!regPrefixes->empty() && !msgIds->empty())
Ed Tanousfffb8c12022-02-07 23:53:03 -0800314 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700315 messages::propertyValueConflict(asyncResp->res, "MessageIds",
316 "RegistryPrefixes");
Ed Tanousfffb8c12022-02-07 23:53:03 -0800317 return;
318 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700319 }
Ed Tanousfffb8c12022-02-07 23:53:03 -0800320
Ed Tanous6fd29552023-10-04 09:40:14 -0700321 boost::system::result<boost::urls::url> url =
Ed Tanousa716aa72023-08-01 11:35:53 -0700322 boost::urls::parse_absolute_uri(destUrl);
323 if (!url)
Ed Tanous002d39b2022-05-31 08:59:27 -0700324 {
Ed Tanous62598e32023-07-17 17:06:25 -0700325 BMCWEB_LOG_WARNING("Failed to validate and split destination url");
Ed Tanous002d39b2022-05-31 08:59:27 -0700326 messages::propertyValueFormatError(asyncResp->res, destUrl,
327 "Destination");
328 return;
329 }
Ed Tanousa716aa72023-08-01 11:35:53 -0700330 url->normalize();
331 crow::utility::setProtocolDefaults(*url, protocol);
332 crow::utility::setPortDefaults(*url);
333
334 if (url->path().empty())
335 {
336 url->set_path("/");
337 }
338
339 if (url->has_userinfo())
340 {
341 messages::propertyValueFormatError(asyncResp->res, destUrl,
342 "Destination");
343 return;
344 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700345
Chicago Duan3d307082020-11-26 14:12:12 +0800346 if (protocol == "SNMPv2c")
347 {
348 if (context)
349 {
350 messages::propertyValueConflict(asyncResp->res, "Context",
351 "Protocol");
352 return;
353 }
354 if (eventFormatType2)
355 {
356 messages::propertyValueConflict(asyncResp->res,
357 "EventFormatType", "Protocol");
358 return;
359 }
360 if (retryPolicy)
361 {
362 messages::propertyValueConflict(asyncResp->res, "RetryPolicy",
363 "Protocol");
364 return;
365 }
366 if (msgIds)
367 {
368 messages::propertyValueConflict(asyncResp->res, "MessageIds",
369 "Protocol");
370 return;
371 }
372 if (regPrefixes)
373 {
374 messages::propertyValueConflict(asyncResp->res,
375 "RegistryPrefixes", "Protocol");
376 return;
377 }
378 if (resTypes)
379 {
380 messages::propertyValueConflict(asyncResp->res, "ResourceTypes",
381 "Protocol");
382 return;
383 }
384 if (headers)
385 {
386 messages::propertyValueConflict(asyncResp->res, "HttpHeaders",
387 "Protocol");
388 return;
389 }
390 if (mrdJsonArray)
391 {
392 messages::propertyValueConflict(
393 asyncResp->res, "MetricReportDefinitions", "Protocol");
394 return;
395 }
Ed Tanousa716aa72023-08-01 11:35:53 -0700396 if (url->scheme() != "snmp")
397 {
398 messages::propertyValueConflict(asyncResp->res, "Destination",
399 "Protocol");
400 return;
401 }
Chicago Duan3d307082020-11-26 14:12:12 +0800402
Ed Tanousa716aa72023-08-01 11:35:53 -0700403 addSnmpTrapClient(asyncResp, url->host_address(),
404 url->port_number());
Chicago Duan3d307082020-11-26 14:12:12 +0800405 return;
406 }
407
Ed Tanousa716aa72023-08-01 11:35:53 -0700408 std::shared_ptr<Subscription> subValue =
409 std::make_shared<Subscription>(*url, app.ioContext());
Chicago Duan3d307082020-11-26 14:12:12 +0800410
Ed Tanousa716aa72023-08-01 11:35:53 -0700411 subValue->destinationUrl = std::move(*url);
Ed Tanous002d39b2022-05-31 08:59:27 -0700412
413 if (subscriptionType)
414 {
415 if (*subscriptionType != "RedfishEvent")
Ed Tanousfffb8c12022-02-07 23:53:03 -0800416 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700417 messages::propertyValueNotInList(
418 asyncResp->res, *subscriptionType, "SubscriptionType");
419 return;
420 }
421 subValue->subscriptionType = *subscriptionType;
422 }
423 else
424 {
425 subValue->subscriptionType = "RedfishEvent"; // Default
426 }
427
428 if (protocol != "Redfish")
429 {
430 messages::propertyValueNotInList(asyncResp->res, protocol,
431 "Protocol");
432 return;
433 }
434 subValue->protocol = protocol;
435
436 if (eventFormatType2)
437 {
Ed Tanous3544d2a2023-08-06 18:12:20 -0700438 if (std::ranges::find(supportedEvtFormatTypes, *eventFormatType2) ==
439 supportedEvtFormatTypes.end())
Ed Tanous002d39b2022-05-31 08:59:27 -0700440 {
441 messages::propertyValueNotInList(
442 asyncResp->res, *eventFormatType2, "EventFormatType");
443 return;
444 }
445 subValue->eventFormatType = *eventFormatType2;
446 }
447 else
448 {
449 // If not specified, use default "Event"
450 subValue->eventFormatType = "Event";
451 }
452
453 if (context)
454 {
AppaRao Puli600af5f2021-10-06 21:51:16 +0000455 // This value is selected aribitrarily.
456 constexpr const size_t maxContextSize = 256;
457 if (context->size() > maxContextSize)
458 {
459 messages::stringValueTooLong(asyncResp->res, "Context",
460 maxContextSize);
461 return;
462 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700463 subValue->customText = *context;
464 }
465
466 if (headers)
467 {
AppaRao Puli600af5f2021-10-06 21:51:16 +0000468 size_t cumulativeLen = 0;
469
Ed Tanous002d39b2022-05-31 08:59:27 -0700470 for (const nlohmann::json& headerChunk : *headers)
471 {
AppaRao Puli600af5f2021-10-06 21:51:16 +0000472 std::string hdr{headerChunk.dump(
473 -1, ' ', true, nlohmann::json::error_handler_t::replace)};
474 cumulativeLen += hdr.length();
475
476 // This value is selected to mirror http_connection.hpp
477 constexpr const uint16_t maxHeaderSizeED = 8096;
478 if (cumulativeLen > maxHeaderSizeED)
479 {
480 messages::arraySizeTooLong(asyncResp->res, "HttpHeaders",
481 maxHeaderSizeED);
482 return;
483 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700484 for (const auto& item : headerChunk.items())
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700485 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700486 const std::string* value =
487 item.value().get_ptr<const std::string*>();
488 if (value == nullptr)
489 {
490 messages::propertyValueFormatError(
Ed Tanousf818b042022-06-27 13:17:35 -0700491 asyncResp->res, item.value(),
Ed Tanous002d39b2022-05-31 08:59:27 -0700492 "HttpHeaders/" + item.key());
493 return;
494 }
495 subValue->httpHeaders.set(item.key(), *value);
496 }
497 }
498 }
499
500 if (regPrefixes)
501 {
502 for (const std::string& it : *regPrefixes)
503 {
Ed Tanous3544d2a2023-08-06 18:12:20 -0700504 if (std::ranges::find(supportedRegPrefixes, it) ==
505 supportedRegPrefixes.end())
Ed Tanous002d39b2022-05-31 08:59:27 -0700506 {
507 messages::propertyValueNotInList(asyncResp->res, it,
508 "RegistryPrefixes");
P Dheeraj Srujan Kumarb304bd72021-01-29 17:46:35 +0530509 return;
510 }
Ed Tanousfffb8c12022-02-07 23:53:03 -0800511 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700512 subValue->registryPrefixes = *regPrefixes;
513 }
P Dheeraj Srujan Kumarb304bd72021-01-29 17:46:35 +0530514
Ed Tanous002d39b2022-05-31 08:59:27 -0700515 if (resTypes)
516 {
517 for (const std::string& it : *resTypes)
Ed Tanousfffb8c12022-02-07 23:53:03 -0800518 {
Ed Tanous3544d2a2023-08-06 18:12:20 -0700519 if (std::ranges::find(supportedResourceTypes, it) ==
520 supportedResourceTypes.end())
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700521 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700522 messages::propertyValueNotInList(asyncResp->res, it,
523 "ResourceTypes");
AppaRao Puli144b6312020-08-03 22:23:12 +0530524 return;
525 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700526 }
527 subValue->resourceTypes = *resTypes;
528 }
529
530 if (msgIds)
531 {
532 std::vector<std::string> registryPrefix;
533
534 // If no registry prefixes are mentioned, consider all
535 // supported prefixes
536 if (subValue->registryPrefixes.empty())
537 {
538 registryPrefix.assign(supportedRegPrefixes.begin(),
539 supportedRegPrefixes.end());
Ed Tanousfffb8c12022-02-07 23:53:03 -0800540 }
541 else
542 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700543 registryPrefix = subValue->registryPrefixes;
Ed Tanousfffb8c12022-02-07 23:53:03 -0800544 }
AppaRao Puli156d6b02020-04-25 06:04:05 +0530545
Ed Tanous002d39b2022-05-31 08:59:27 -0700546 for (const std::string& id : *msgIds)
Ed Tanousfffb8c12022-02-07 23:53:03 -0800547 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700548 bool validId = false;
Ed Tanousfffb8c12022-02-07 23:53:03 -0800549
Ed Tanous002d39b2022-05-31 08:59:27 -0700550 // Check for Message ID in each of the selected Registry
551 for (const std::string& it : registryPrefix)
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700552 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700553 const std::span<const redfish::registries::MessageEntry>
554 registry =
555 redfish::registries::getRegistryFromPrefix(it);
556
Ed Tanous3544d2a2023-08-06 18:12:20 -0700557 if (std::ranges::any_of(
558 registry,
Ed Tanous002d39b2022-05-31 08:59:27 -0700559 [&id](const redfish::registries::MessageEntry&
560 messageEntry) {
561 return id == messageEntry.first;
Patrick Williams5a39f772023-10-20 11:20:21 -0500562 }))
Ed Tanous002d39b2022-05-31 08:59:27 -0700563 {
564 validId = true;
565 break;
566 }
567 }
568
569 if (!validId)
570 {
571 messages::propertyValueNotInList(asyncResp->res, id,
572 "MessageIds");
Ed Tanousfffb8c12022-02-07 23:53:03 -0800573 return;
574 }
Ed Tanousfffb8c12022-02-07 23:53:03 -0800575 }
576
Ed Tanous002d39b2022-05-31 08:59:27 -0700577 subValue->registryMsgIds = *msgIds;
578 }
579
580 if (retryPolicy)
581 {
Ed Tanous3544d2a2023-08-06 18:12:20 -0700582 if (std::ranges::find(supportedRetryPolicies, *retryPolicy) ==
583 supportedRetryPolicies.end())
Ed Tanousfffb8c12022-02-07 23:53:03 -0800584 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700585 messages::propertyValueNotInList(asyncResp->res, *retryPolicy,
586 "DeliveryRetryPolicy");
Ed Tanousfffb8c12022-02-07 23:53:03 -0800587 return;
588 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700589 subValue->retryPolicy = *retryPolicy;
590 }
591 else
592 {
593 // Default "TerminateAfterRetries"
594 subValue->retryPolicy = "TerminateAfterRetries";
595 }
Ed Tanousfffb8c12022-02-07 23:53:03 -0800596
Ed Tanous002d39b2022-05-31 08:59:27 -0700597 if (mrdJsonArray)
598 {
599 for (nlohmann::json& mrdObj : *mrdJsonArray)
600 {
601 std::string mrdUri;
602
603 if (!json_util::readJson(mrdObj, asyncResp->res, "@odata.id",
604 mrdUri))
605
606 {
607 return;
608 }
609 subValue->metricReportDefinitions.emplace_back(mrdUri);
610 }
611 }
612
613 std::string id =
614 EventServiceManager::getInstance().addSubscription(subValue);
615 if (id.empty())
616 {
617 messages::internalError(asyncResp->res);
618 return;
619 }
620
621 messages::created(asyncResp->res);
622 asyncResp->res.addHeader(
623 "Location", "/redfish/v1/EventService/Subscriptions/" + id);
Patrick Williams5a39f772023-10-20 11:20:21 -0500624 });
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700625}
626
627inline void requestRoutesEventDestination(App& app)
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530628{
Ravi Teja9d41aec2021-07-23 01:57:01 -0500629 BMCWEB_ROUTE(app, "/redfish/v1/EventService/Subscriptions/<str>/")
Ed Tanoused398212021-06-09 17:05:54 -0700630 .privileges(redfish::privileges::getEventDestination)
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700631 .methods(boost::beast::http::verb::get)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700632 [&app](const crow::Request& req,
633 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
634 const std::string& param) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000635 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700636 {
637 return;
638 }
Chicago Duan3d307082020-11-26 14:12:12 +0800639
640 if (param.starts_with("snmp"))
641 {
642 getSnmpTrapClient(asyncResp, param);
643 return;
644 }
645
Ed Tanous002d39b2022-05-31 08:59:27 -0700646 std::shared_ptr<Subscription> subValue =
647 EventServiceManager::getInstance().getSubscription(param);
648 if (subValue == nullptr)
649 {
650 asyncResp->res.result(boost::beast::http::status::not_found);
651 return;
652 }
653 const std::string& id = param;
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530654
Ed Tanous002d39b2022-05-31 08:59:27 -0700655 asyncResp->res.jsonValue["@odata.type"] =
Chicago Duan3d307082020-11-26 14:12:12 +0800656 "#EventDestination.v1_8_0.EventDestination";
Ed Tanous002d39b2022-05-31 08:59:27 -0700657 asyncResp->res.jsonValue["Protocol"] = "Redfish";
Ed Tanous3b327802023-08-14 09:23:43 -0700658 asyncResp->res.jsonValue["@odata.id"] = boost::urls::format(
659 "/redfish/v1/EventService/Subscriptions/{}", id);
Ed Tanous002d39b2022-05-31 08:59:27 -0700660 asyncResp->res.jsonValue["Id"] = id;
661 asyncResp->res.jsonValue["Name"] = "Event Destination " + id;
662 asyncResp->res.jsonValue["Destination"] = subValue->destinationUrl;
663 asyncResp->res.jsonValue["Context"] = subValue->customText;
664 asyncResp->res.jsonValue["SubscriptionType"] =
665 subValue->subscriptionType;
666 asyncResp->res.jsonValue["HttpHeaders"] = nlohmann::json::array();
667 asyncResp->res.jsonValue["EventFormatType"] = subValue->eventFormatType;
668 asyncResp->res.jsonValue["RegistryPrefixes"] =
669 subValue->registryPrefixes;
670 asyncResp->res.jsonValue["ResourceTypes"] = subValue->resourceTypes;
zhanghch058d1b46d2021-04-01 11:18:24 +0800671
Ed Tanous002d39b2022-05-31 08:59:27 -0700672 asyncResp->res.jsonValue["MessageIds"] = subValue->registryMsgIds;
673 asyncResp->res.jsonValue["DeliveryRetryPolicy"] = subValue->retryPolicy;
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530674
Ed Tanous002d39b2022-05-31 08:59:27 -0700675 nlohmann::json::array_t mrdJsonArray;
676 for (const auto& mdrUri : subValue->metricReportDefinitions)
677 {
678 nlohmann::json::object_t mdr;
679 mdr["@odata.id"] = mdrUri;
680 mrdJsonArray.emplace_back(std::move(mdr));
681 }
682 asyncResp->res.jsonValue["MetricReportDefinitions"] = mrdJsonArray;
Patrick Williams5a39f772023-10-20 11:20:21 -0500683 });
Ravi Teja9d41aec2021-07-23 01:57:01 -0500684 BMCWEB_ROUTE(app, "/redfish/v1/EventService/Subscriptions/<str>/")
Ed Tanoused398212021-06-09 17:05:54 -0700685 // The below privilege is wrong, it should be ConfigureManager OR
686 // ConfigureSelf
Abhishek Patel7eeafa72021-07-28 10:59:16 -0500687 // https://github.com/openbmc/bmcweb/issues/220
Ed Tanoused398212021-06-09 17:05:54 -0700688 //.privileges(redfish::privileges::patchEventDestination)
Ed Tanous432a8902021-06-14 15:28:56 -0700689 .privileges({{"ConfigureManager"}})
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700690 .methods(boost::beast::http::verb::patch)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700691 [&app](const crow::Request& req,
692 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
693 const std::string& param) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000694 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700695 {
696 return;
697 }
698 std::shared_ptr<Subscription> subValue =
699 EventServiceManager::getInstance().getSubscription(param);
700 if (subValue == nullptr)
701 {
702 asyncResp->res.result(boost::beast::http::status::not_found);
703 return;
704 }
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530705
Ed Tanous002d39b2022-05-31 08:59:27 -0700706 std::optional<std::string> context;
707 std::optional<std::string> retryPolicy;
708 std::optional<std::vector<nlohmann::json>> headers;
Sunitha Harishe56f2542020-07-22 02:38:59 -0500709
Ed Tanous002d39b2022-05-31 08:59:27 -0700710 if (!json_util::readJsonPatch(req, asyncResp->res, "Context", context,
711 "DeliveryRetryPolicy", retryPolicy,
712 "HttpHeaders", headers))
713 {
714 return;
715 }
AppaRao Puli144b6312020-08-03 22:23:12 +0530716
Ed Tanous002d39b2022-05-31 08:59:27 -0700717 if (context)
718 {
719 subValue->customText = *context;
720 }
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530721
Ed Tanous002d39b2022-05-31 08:59:27 -0700722 if (headers)
723 {
724 boost::beast::http::fields fields;
725 for (const nlohmann::json& headerChunk : *headers)
726 {
Patrick Williams62bafc02022-09-08 17:35:35 -0500727 for (const auto& it : headerChunk.items())
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700728 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700729 const std::string* value =
730 it.value().get_ptr<const std::string*>();
731 if (value == nullptr)
Ed Tanous601c71a2021-09-08 16:40:12 -0700732 {
Ed Tanous002d39b2022-05-31 08:59:27 -0700733 messages::propertyValueFormatError(
Ed Tanousf818b042022-06-27 13:17:35 -0700734 asyncResp->res, it.value(),
Ed Tanous002d39b2022-05-31 08:59:27 -0700735 "HttpHeaders/" + it.key());
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700736 return;
737 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700738 fields.set(it.key(), *value);
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700739 }
Ed Tanous002d39b2022-05-31 08:59:27 -0700740 }
741 subValue->httpHeaders = fields;
742 }
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530743
Ed Tanous002d39b2022-05-31 08:59:27 -0700744 if (retryPolicy)
745 {
Ed Tanous3544d2a2023-08-06 18:12:20 -0700746 if (std::ranges::find(supportedRetryPolicies, *retryPolicy) ==
747 supportedRetryPolicies.end())
Ed Tanous002d39b2022-05-31 08:59:27 -0700748 {
749 messages::propertyValueNotInList(asyncResp->res, *retryPolicy,
750 "DeliveryRetryPolicy");
751 return;
752 }
753 subValue->retryPolicy = *retryPolicy;
Ed Tanous002d39b2022-05-31 08:59:27 -0700754 }
755
756 EventServiceManager::getInstance().updateSubscriptionData();
Patrick Williams5a39f772023-10-20 11:20:21 -0500757 });
Ravi Teja9d41aec2021-07-23 01:57:01 -0500758 BMCWEB_ROUTE(app, "/redfish/v1/EventService/Subscriptions/<str>/")
Ed Tanoused398212021-06-09 17:05:54 -0700759 // The below privilege is wrong, it should be ConfigureManager OR
760 // ConfigureSelf
Abhishek Patel7eeafa72021-07-28 10:59:16 -0500761 // https://github.com/openbmc/bmcweb/issues/220
Ed Tanoused398212021-06-09 17:05:54 -0700762 //.privileges(redfish::privileges::deleteEventDestination)
Ed Tanous432a8902021-06-14 15:28:56 -0700763 .privileges({{"ConfigureManager"}})
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700764 .methods(boost::beast::http::verb::delete_)(
Ed Tanous45ca1b82022-03-25 13:07:27 -0700765 [&app](const crow::Request& req,
766 const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
767 const std::string& param) {
Carson Labrado3ba00072022-06-06 19:40:56 +0000768 if (!redfish::setUpRedfishRoute(app, req, asyncResp))
Ed Tanous002d39b2022-05-31 08:59:27 -0700769 {
770 return;
771 }
Chicago Duan3d307082020-11-26 14:12:12 +0800772
773 if (param.starts_with("snmp"))
774 {
775 deleteSnmpTrapClient(asyncResp, param);
776 EventServiceManager::getInstance().deleteSubscription(param);
777 return;
778 }
779
Ed Tanous002d39b2022-05-31 08:59:27 -0700780 if (!EventServiceManager::getInstance().isSubscriptionExist(param))
781 {
782 asyncResp->res.result(boost::beast::http::status::not_found);
783 return;
784 }
785 EventServiceManager::getInstance().deleteSubscription(param);
Patrick Williams5a39f772023-10-20 11:20:21 -0500786 });
John Edward Broadbent7e860f12021-04-08 15:57:16 -0700787}
AppaRao Pulie5aaf042020-03-20 01:05:52 +0530788
789} // namespace redfish