xref: /openbmc/bmcweb/features/redfish/lib/virtual_media.hpp (revision b9d36b4791d77a47e1f3c5c4564fcdf7cc68c115)
1107077deSPrzemyslaw Czarnowski /*
2107077deSPrzemyslaw Czarnowski // Copyright (c) 2018 Intel Corporation
3107077deSPrzemyslaw Czarnowski //
4107077deSPrzemyslaw Czarnowski // Licensed under the Apache License, Version 2.0 (the "License");
5107077deSPrzemyslaw Czarnowski // you may not use this file except in compliance with the License.
6107077deSPrzemyslaw Czarnowski // You may obtain a copy of the License at
7107077deSPrzemyslaw Czarnowski //
8107077deSPrzemyslaw Czarnowski //      http://www.apache.org/licenses/LICENSE-2.0
9107077deSPrzemyslaw Czarnowski //
10107077deSPrzemyslaw Czarnowski // Unless required by applicable law or agreed to in writing, software
11107077deSPrzemyslaw Czarnowski // distributed under the License is distributed on an "AS IS" BASIS,
12107077deSPrzemyslaw Czarnowski // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13107077deSPrzemyslaw Czarnowski // See the License for the specific language governing permissions and
14107077deSPrzemyslaw Czarnowski // limitations under the License.
15107077deSPrzemyslaw Czarnowski */
16107077deSPrzemyslaw Czarnowski #pragma once
17107077deSPrzemyslaw Czarnowski 
18*b9d36b47SEd Tanous #include <account_service.hpp>
197e860f15SJohn Edward Broadbent #include <app.hpp>
20988fb7b2SAdrian Ambrożewicz #include <boost/process/async_pipe.hpp>
21988fb7b2SAdrian Ambrożewicz #include <boost/type_traits/has_dereference.hpp>
229e319cf0SAnna Platash #include <boost/url/url_view.hpp>
23ed398213SEd Tanous #include <registries/privilege_registry.hpp>
24*b9d36b47SEd Tanous #include <utils/json_utils.hpp>
25107077deSPrzemyslaw Czarnowski 
26107077deSPrzemyslaw Czarnowski namespace redfish
27107077deSPrzemyslaw Czarnowski {
289e319cf0SAnna Platash /**
299e319cf0SAnna Platash  * @brief Function extracts transfer protocol name from URI.
309e319cf0SAnna Platash  */
3167df073bSEd Tanous inline std::string getTransferProtocolTypeFromUri(const std::string& imageUri)
3267df073bSEd Tanous {
3367df073bSEd Tanous     boost::urls::result<boost::urls::url_view> url =
3467df073bSEd Tanous         boost::urls::parse_uri(boost::string_view(imageUri));
3567df073bSEd Tanous     if (!url)
3667df073bSEd Tanous     {
3767df073bSEd Tanous         return "None";
3867df073bSEd Tanous     }
3967df073bSEd Tanous     boost::string_view scheme = url->scheme();
4067df073bSEd Tanous     if (scheme == "smb")
4167df073bSEd Tanous     {
4267df073bSEd Tanous         return "CIFS";
4367df073bSEd Tanous     }
4467df073bSEd Tanous     if (scheme == "https")
4567df073bSEd Tanous     {
4667df073bSEd Tanous         return "HTTPS";
4767df073bSEd Tanous     }
4867df073bSEd Tanous 
4967df073bSEd Tanous     return "None";
5067df073bSEd Tanous }
51107077deSPrzemyslaw Czarnowski 
52107077deSPrzemyslaw Czarnowski /**
53107077deSPrzemyslaw Czarnowski  * @brief Read all known properties from VM object interfaces
54107077deSPrzemyslaw Czarnowski  */
5522db1728SEd Tanous inline void
56711ac7a9SEd Tanous     vmParseInterfaceObject(const dbus::utility::DBusInteracesMap& interface,
578d1b46d7Szhanghch05                            const std::shared_ptr<bmcweb::AsyncResp>& aResp)
58107077deSPrzemyslaw Czarnowski {
59711ac7a9SEd Tanous     for (const auto& [interface, values] : interface)
60107077deSPrzemyslaw Czarnowski     {
61711ac7a9SEd Tanous         if (interface == "xyz.openbmc_project.VirtualMedia.MountPoint")
62107077deSPrzemyslaw Czarnowski         {
63711ac7a9SEd Tanous             for (const auto& [property, value] : values)
64107077deSPrzemyslaw Czarnowski             {
65711ac7a9SEd Tanous                 if (property == "EndpointId")
66107077deSPrzemyslaw Czarnowski                 {
67107077deSPrzemyslaw Czarnowski                     const std::string* endpointIdValue =
68711ac7a9SEd Tanous                         std::get_if<std::string>(&value);
69711ac7a9SEd Tanous                     if (endpointIdValue == nullptr)
70107077deSPrzemyslaw Czarnowski                     {
71711ac7a9SEd Tanous                         continue;
72711ac7a9SEd Tanous                     }
73107077deSPrzemyslaw Czarnowski                     if (!endpointIdValue->empty())
74107077deSPrzemyslaw Czarnowski                     {
75107077deSPrzemyslaw Czarnowski                         // Proxy mode
76711ac7a9SEd Tanous                         aResp->res
77711ac7a9SEd Tanous                             .jsonValue["Oem"]["OpenBMC"]["WebSocketEndpoint"] =
78d04ba325SPrzemyslaw Czarnowski                             *endpointIdValue;
79107077deSPrzemyslaw Czarnowski                         aResp->res.jsonValue["TransferProtocolType"] = "OEM";
80107077deSPrzemyslaw Czarnowski                     }
81107077deSPrzemyslaw Czarnowski                 }
82711ac7a9SEd Tanous                 if (property == "ImageURL")
83107077deSPrzemyslaw Czarnowski                 {
84107077deSPrzemyslaw Czarnowski                     const std::string* imageUrlValue =
85711ac7a9SEd Tanous                         std::get_if<std::string>(&value);
8626f6976fSEd Tanous                     if (imageUrlValue != nullptr && !imageUrlValue->empty())
87107077deSPrzemyslaw Czarnowski                     {
88da4784d8SPrzemyslaw Czarnowski                         std::filesystem::path filePath = *imageUrlValue;
89da4784d8SPrzemyslaw Czarnowski                         if (!filePath.has_filename())
90da4784d8SPrzemyslaw Czarnowski                         {
919e319cf0SAnna Platash                             // this will handle https share, which not
929e319cf0SAnna Platash                             // necessarily has to have filename given.
93da4784d8SPrzemyslaw Czarnowski                             aResp->res.jsonValue["ImageName"] = "";
94da4784d8SPrzemyslaw Czarnowski                         }
95da4784d8SPrzemyslaw Czarnowski                         else
96da4784d8SPrzemyslaw Czarnowski                         {
979e319cf0SAnna Platash                             aResp->res.jsonValue["ImageName"] =
989e319cf0SAnna Platash                                 filePath.filename();
99da4784d8SPrzemyslaw Czarnowski                         }
100da4784d8SPrzemyslaw Czarnowski 
101da4784d8SPrzemyslaw Czarnowski                         aResp->res.jsonValue["Image"] = *imageUrlValue;
1029e319cf0SAnna Platash                         aResp->res.jsonValue["TransferProtocolType"] =
1039e319cf0SAnna Platash                             getTransferProtocolTypeFromUri(*imageUrlValue);
1049e319cf0SAnna Platash 
105107077deSPrzemyslaw Czarnowski                         aResp->res.jsonValue["ConnectedVia"] = "URI";
106107077deSPrzemyslaw Czarnowski                     }
107107077deSPrzemyslaw Czarnowski                 }
108711ac7a9SEd Tanous                 if (property == "WriteProtected")
1099e319cf0SAnna Platash                 {
110711ac7a9SEd Tanous                     const bool* writeProtectedValue = std::get_if<bool>(&value);
111e662eae8SEd Tanous                     if (writeProtectedValue != nullptr)
1129e319cf0SAnna Platash                     {
1139e319cf0SAnna Platash                         aResp->res.jsonValue["WriteProtected"] =
1149e319cf0SAnna Platash                             *writeProtectedValue;
1159e319cf0SAnna Platash                     }
1169e319cf0SAnna Platash                 }
1179e319cf0SAnna Platash             }
118107077deSPrzemyslaw Czarnowski         }
119711ac7a9SEd Tanous         if (interface == "xyz.openbmc_project.VirtualMedia.Process")
120711ac7a9SEd Tanous         {
121711ac7a9SEd Tanous             for (const auto& [property, value] : values)
122711ac7a9SEd Tanous             {
123711ac7a9SEd Tanous                 if (property == "Active")
124711ac7a9SEd Tanous                 {
125711ac7a9SEd Tanous                     const bool* activeValue = std::get_if<bool>(&value);
126e662eae8SEd Tanous                     if (activeValue == nullptr)
127711ac7a9SEd Tanous                     {
128711ac7a9SEd Tanous                         BMCWEB_LOG_DEBUG << "Value Active not found";
129711ac7a9SEd Tanous                         return;
130711ac7a9SEd Tanous                     }
131711ac7a9SEd Tanous                     aResp->res.jsonValue["Inserted"] = *activeValue;
132711ac7a9SEd Tanous 
133e05aec50SEd Tanous                     if (*activeValue)
134711ac7a9SEd Tanous                     {
135711ac7a9SEd Tanous                         aResp->res.jsonValue["ConnectedVia"] = "Applet";
136711ac7a9SEd Tanous                     }
137711ac7a9SEd Tanous                 }
138711ac7a9SEd Tanous             }
139711ac7a9SEd Tanous         }
140107077deSPrzemyslaw Czarnowski     }
141107077deSPrzemyslaw Czarnowski }
142107077deSPrzemyslaw Czarnowski 
143107077deSPrzemyslaw Czarnowski /**
144107077deSPrzemyslaw Czarnowski  * @brief Fill template for Virtual Media Item.
145107077deSPrzemyslaw Czarnowski  */
14622db1728SEd Tanous inline nlohmann::json vmItemTemplate(const std::string& name,
147107077deSPrzemyslaw Czarnowski                                      const std::string& resName)
148107077deSPrzemyslaw Czarnowski {
149107077deSPrzemyslaw Czarnowski     nlohmann::json item;
15022db1728SEd Tanous 
15122db1728SEd Tanous     std::string id = "/redfish/v1/Managers/";
15222db1728SEd Tanous     id += name;
15322db1728SEd Tanous     id += "/VirtualMedia/";
15422db1728SEd Tanous     id += resName;
15522db1728SEd Tanous     item["@odata.id"] = std::move(id);
15622db1728SEd Tanous 
157d04ba325SPrzemyslaw Czarnowski     item["@odata.type"] = "#VirtualMedia.v1_3_0.VirtualMedia";
158107077deSPrzemyslaw Czarnowski     item["Name"] = "Virtual Removable Media";
159107077deSPrzemyslaw Czarnowski     item["Id"] = resName;
160107077deSPrzemyslaw Czarnowski     item["WriteProtected"] = true;
161107077deSPrzemyslaw Czarnowski     item["MediaTypes"] = {"CD", "USBStick"};
162107077deSPrzemyslaw Czarnowski     item["TransferMethod"] = "Stream";
163d04ba325SPrzemyslaw Czarnowski     item["Oem"]["OpenBMC"]["@odata.type"] =
164d04ba325SPrzemyslaw Czarnowski         "#OemVirtualMedia.v1_0_0.VirtualMedia";
165107077deSPrzemyslaw Czarnowski 
166107077deSPrzemyslaw Czarnowski     return item;
167107077deSPrzemyslaw Czarnowski }
168107077deSPrzemyslaw Czarnowski 
169107077deSPrzemyslaw Czarnowski /**
170107077deSPrzemyslaw Czarnowski  *  @brief Fills collection data
171107077deSPrzemyslaw Czarnowski  */
17222db1728SEd Tanous inline void getVmResourceList(std::shared_ptr<bmcweb::AsyncResp> aResp,
173107077deSPrzemyslaw Czarnowski                               const std::string& service,
174107077deSPrzemyslaw Czarnowski                               const std::string& name)
175107077deSPrzemyslaw Czarnowski {
176107077deSPrzemyslaw Czarnowski     BMCWEB_LOG_DEBUG << "Get available Virtual Media resources.";
177107077deSPrzemyslaw Czarnowski     crow::connections::systemBus->async_method_call(
178711ac7a9SEd Tanous         [name,
179711ac7a9SEd Tanous          aResp{std::move(aResp)}](const boost::system::error_code ec,
180711ac7a9SEd Tanous                                   dbus::utility::ManagedObjectType& subtree) {
181107077deSPrzemyslaw Czarnowski             if (ec)
182107077deSPrzemyslaw Czarnowski             {
183107077deSPrzemyslaw Czarnowski                 BMCWEB_LOG_DEBUG << "DBUS response error";
184107077deSPrzemyslaw Czarnowski                 return;
185107077deSPrzemyslaw Czarnowski             }
186107077deSPrzemyslaw Czarnowski             nlohmann::json& members = aResp->res.jsonValue["Members"];
187107077deSPrzemyslaw Czarnowski             members = nlohmann::json::array();
188107077deSPrzemyslaw Czarnowski 
189107077deSPrzemyslaw Czarnowski             for (const auto& object : subtree)
190107077deSPrzemyslaw Czarnowski             {
191107077deSPrzemyslaw Czarnowski                 nlohmann::json item;
1922dfd18efSEd Tanous                 std::string path = object.first.filename();
1932dfd18efSEd Tanous                 if (path.empty())
194107077deSPrzemyslaw Czarnowski                 {
195107077deSPrzemyslaw Czarnowski                     continue;
196107077deSPrzemyslaw Czarnowski                 }
197107077deSPrzemyslaw Czarnowski 
19822db1728SEd Tanous                 std::string id = "/redfish/v1/Managers/";
19922db1728SEd Tanous                 id += name;
20022db1728SEd Tanous                 id += "/VirtualMedia/";
20122db1728SEd Tanous                 id += path;
202107077deSPrzemyslaw Czarnowski 
20322db1728SEd Tanous                 item["@odata.id"] = std::move(id);
204107077deSPrzemyslaw Czarnowski                 members.emplace_back(std::move(item));
205107077deSPrzemyslaw Czarnowski             }
206107077deSPrzemyslaw Czarnowski             aResp->res.jsonValue["Members@odata.count"] = members.size();
207107077deSPrzemyslaw Czarnowski         },
208107077deSPrzemyslaw Czarnowski         service, "/xyz/openbmc_project/VirtualMedia",
209107077deSPrzemyslaw Czarnowski         "org.freedesktop.DBus.ObjectManager", "GetManagedObjects");
210107077deSPrzemyslaw Czarnowski }
211107077deSPrzemyslaw Czarnowski 
212107077deSPrzemyslaw Czarnowski /**
213107077deSPrzemyslaw Czarnowski  *  @brief Fills data for specific resource
214107077deSPrzemyslaw Czarnowski  */
21522db1728SEd Tanous inline void getVmData(const std::shared_ptr<bmcweb::AsyncResp>& aResp,
216107077deSPrzemyslaw Czarnowski                       const std::string& service, const std::string& name,
217107077deSPrzemyslaw Czarnowski                       const std::string& resName)
218107077deSPrzemyslaw Czarnowski {
219107077deSPrzemyslaw Czarnowski     BMCWEB_LOG_DEBUG << "Get Virtual Media resource data.";
220107077deSPrzemyslaw Czarnowski 
221107077deSPrzemyslaw Czarnowski     crow::connections::systemBus->async_method_call(
222914e2d5dSEd Tanous         [resName, name,
223914e2d5dSEd Tanous          aResp](const boost::system::error_code ec,
224914e2d5dSEd Tanous                 const dbus::utility::ManagedObjectType& subtree) {
225107077deSPrzemyslaw Czarnowski             if (ec)
226107077deSPrzemyslaw Czarnowski             {
227107077deSPrzemyslaw Czarnowski                 BMCWEB_LOG_DEBUG << "DBUS response error";
228e13c2760SPrzemyslaw Czarnowski 
229107077deSPrzemyslaw Czarnowski                 return;
230107077deSPrzemyslaw Czarnowski             }
231107077deSPrzemyslaw Czarnowski 
232914e2d5dSEd Tanous             for (const auto& item : subtree)
233107077deSPrzemyslaw Czarnowski             {
2342dfd18efSEd Tanous                 std::string thispath = item.first.filename();
2352dfd18efSEd Tanous                 if (thispath.empty())
236107077deSPrzemyslaw Czarnowski                 {
237107077deSPrzemyslaw Czarnowski                     continue;
238107077deSPrzemyslaw Czarnowski                 }
239107077deSPrzemyslaw Czarnowski 
2402dfd18efSEd Tanous                 if (thispath != resName)
241107077deSPrzemyslaw Czarnowski                 {
242107077deSPrzemyslaw Czarnowski                     continue;
243107077deSPrzemyslaw Czarnowski                 }
244107077deSPrzemyslaw Czarnowski 
2451a6258dcSPrzemyslaw Czarnowski                 // "Legacy"/"Proxy"
2461a6258dcSPrzemyslaw Czarnowski                 auto mode = item.first.parent_path();
2471a6258dcSPrzemyslaw Czarnowski                 // "VirtualMedia"
2481a6258dcSPrzemyslaw Czarnowski                 auto type = mode.parent_path();
2491a6258dcSPrzemyslaw Czarnowski                 if (mode.filename().empty() || type.filename().empty())
2501a6258dcSPrzemyslaw Czarnowski                 {
2511a6258dcSPrzemyslaw Czarnowski                     continue;
2521a6258dcSPrzemyslaw Czarnowski                 }
2531a6258dcSPrzemyslaw Czarnowski 
2541a6258dcSPrzemyslaw Czarnowski                 if (type.filename() != "VirtualMedia")
2551a6258dcSPrzemyslaw Czarnowski                 {
2561a6258dcSPrzemyslaw Czarnowski                     continue;
2571a6258dcSPrzemyslaw Czarnowski                 }
2581a6258dcSPrzemyslaw Czarnowski 
259107077deSPrzemyslaw Czarnowski                 aResp->res.jsonValue = vmItemTemplate(name, resName);
26022db1728SEd Tanous                 std::string actionsId = "/redfish/v1/Managers/";
26122db1728SEd Tanous                 actionsId += name;
26222db1728SEd Tanous                 actionsId += "/VirtualMedia/";
26322db1728SEd Tanous                 actionsId += resName;
26422db1728SEd Tanous                 actionsId += "/Actions";
265107077deSPrzemyslaw Czarnowski 
266e13c2760SPrzemyslaw Czarnowski                 // Check if dbus path is Legacy type
2671a6258dcSPrzemyslaw Czarnowski                 if (mode.filename() == "Legacy")
268e13c2760SPrzemyslaw Czarnowski                 {
269e13c2760SPrzemyslaw Czarnowski                     aResp->res.jsonValue["Actions"]["#VirtualMedia.InsertMedia"]
270e13c2760SPrzemyslaw Czarnowski                                         ["target"] =
27122db1728SEd Tanous                         actionsId + "/VirtualMedia.InsertMedia";
272e13c2760SPrzemyslaw Czarnowski                 }
273e13c2760SPrzemyslaw Czarnowski 
274107077deSPrzemyslaw Czarnowski                 vmParseInterfaceObject(item.second, aResp);
275107077deSPrzemyslaw Czarnowski 
276e13c2760SPrzemyslaw Czarnowski                 aResp->res.jsonValue["Actions"]["#VirtualMedia.EjectMedia"]
277e13c2760SPrzemyslaw Czarnowski                                     ["target"] =
27822db1728SEd Tanous                     actionsId + "/VirtualMedia.EjectMedia";
279e13c2760SPrzemyslaw Czarnowski 
280107077deSPrzemyslaw Czarnowski                 return;
281107077deSPrzemyslaw Czarnowski             }
282107077deSPrzemyslaw Czarnowski 
283107077deSPrzemyslaw Czarnowski             messages::resourceNotFound(
284d04ba325SPrzemyslaw Czarnowski                 aResp->res, "#VirtualMedia.v1_3_0.VirtualMedia", resName);
285107077deSPrzemyslaw Czarnowski         },
286107077deSPrzemyslaw Czarnowski         service, "/xyz/openbmc_project/VirtualMedia",
287107077deSPrzemyslaw Czarnowski         "org.freedesktop.DBus.ObjectManager", "GetManagedObjects");
288107077deSPrzemyslaw Czarnowski }
289107077deSPrzemyslaw Czarnowski 
290e13c2760SPrzemyslaw Czarnowski /**
291c6f4e017SAgata Olender  * @brief Transfer protocols supported for InsertMedia action.
292c6f4e017SAgata Olender  *
293c6f4e017SAgata Olender  */
294c6f4e017SAgata Olender enum class TransferProtocol
295c6f4e017SAgata Olender {
296c6f4e017SAgata Olender     https,
297c6f4e017SAgata Olender     smb,
298c6f4e017SAgata Olender     invalid
299c6f4e017SAgata Olender };
300c6f4e017SAgata Olender 
301c6f4e017SAgata Olender /**
302c6f4e017SAgata Olender  * @brief Function extracts transfer protocol type from URI.
303c6f4e017SAgata Olender  *
304c6f4e017SAgata Olender  */
30567df073bSEd Tanous inline std::optional<TransferProtocol>
306ace85d60SEd Tanous     getTransferProtocolFromUri(const boost::urls::url_view& imageUri)
30767df073bSEd Tanous {
308ace85d60SEd Tanous     boost::string_view scheme = imageUri.scheme();
30967df073bSEd Tanous     if (scheme == "smb")
31067df073bSEd Tanous     {
31167df073bSEd Tanous         return TransferProtocol::smb;
31267df073bSEd Tanous     }
31367df073bSEd Tanous     if (scheme == "https")
31467df073bSEd Tanous     {
31567df073bSEd Tanous         return TransferProtocol::https;
31667df073bSEd Tanous     }
31767df073bSEd Tanous     if (!scheme.empty())
31867df073bSEd Tanous     {
31967df073bSEd Tanous         return TransferProtocol::invalid;
32067df073bSEd Tanous     }
32167df073bSEd Tanous 
32267df073bSEd Tanous     return {};
32367df073bSEd Tanous }
324c6f4e017SAgata Olender 
325c6f4e017SAgata Olender /**
326c6f4e017SAgata Olender  * @brief Function convert transfer protocol from string param.
327c6f4e017SAgata Olender  *
328c6f4e017SAgata Olender  */
32922db1728SEd Tanous inline std::optional<TransferProtocol> getTransferProtocolFromParam(
330c6f4e017SAgata Olender     const std::optional<std::string>& transferProtocolType)
331c6f4e017SAgata Olender {
332c6f4e017SAgata Olender     if (transferProtocolType == std::nullopt)
333c6f4e017SAgata Olender     {
334c6f4e017SAgata Olender         return {};
335c6f4e017SAgata Olender     }
336c6f4e017SAgata Olender 
337c6f4e017SAgata Olender     if (*transferProtocolType == "CIFS")
338c6f4e017SAgata Olender     {
339c6f4e017SAgata Olender         return TransferProtocol::smb;
340c6f4e017SAgata Olender     }
341c6f4e017SAgata Olender 
342c6f4e017SAgata Olender     if (*transferProtocolType == "HTTPS")
343c6f4e017SAgata Olender     {
344c6f4e017SAgata Olender         return TransferProtocol::https;
345c6f4e017SAgata Olender     }
346c6f4e017SAgata Olender 
347c6f4e017SAgata Olender     return TransferProtocol::invalid;
348c6f4e017SAgata Olender }
349c6f4e017SAgata Olender 
350c6f4e017SAgata Olender /**
351c6f4e017SAgata Olender  * @brief Function extends URI with transfer protocol type.
352c6f4e017SAgata Olender  *
353c6f4e017SAgata Olender  */
35422db1728SEd Tanous inline std::string
355c6f4e017SAgata Olender     getUriWithTransferProtocol(const std::string& imageUri,
356c6f4e017SAgata Olender                                const TransferProtocol& transferProtocol)
357c6f4e017SAgata Olender {
358c6f4e017SAgata Olender     if (transferProtocol == TransferProtocol::smb)
359c6f4e017SAgata Olender     {
360c6f4e017SAgata Olender         return "smb://" + imageUri;
361c6f4e017SAgata Olender     }
362c6f4e017SAgata Olender 
363c6f4e017SAgata Olender     if (transferProtocol == TransferProtocol::https)
364c6f4e017SAgata Olender     {
365c6f4e017SAgata Olender         return "https://" + imageUri;
366c6f4e017SAgata Olender     }
367c6f4e017SAgata Olender 
368c6f4e017SAgata Olender     return imageUri;
369c6f4e017SAgata Olender }
370c6f4e017SAgata Olender 
371c6f4e017SAgata Olender /**
372c6f4e017SAgata Olender  * @brief Function validate parameters of insert media request.
373c6f4e017SAgata Olender  *
374c6f4e017SAgata Olender  */
37522db1728SEd Tanous inline bool
37622db1728SEd Tanous     validateParams(crow::Response& res, std::string& imageUrl,
377c6f4e017SAgata Olender                    const std::optional<bool>& inserted,
378c6f4e017SAgata Olender                    const std::optional<std::string>& transferMethod,
379c6f4e017SAgata Olender                    const std::optional<std::string>& transferProtocolType)
380c6f4e017SAgata Olender {
381c6f4e017SAgata Olender     BMCWEB_LOG_DEBUG << "Validation started";
382c6f4e017SAgata Olender     // required param imageUrl must not be empty
383c6f4e017SAgata Olender     if (imageUrl.empty())
384c6f4e017SAgata Olender     {
385c6f4e017SAgata Olender         BMCWEB_LOG_ERROR << "Request action parameter Image is empty.";
386c6f4e017SAgata Olender 
38722db1728SEd Tanous         messages::propertyValueFormatError(res, "<empty>", "Image");
388c6f4e017SAgata Olender 
389c6f4e017SAgata Olender         return false;
390c6f4e017SAgata Olender     }
391c6f4e017SAgata Olender 
392c6f4e017SAgata Olender     // optional param inserted must be true
393e05aec50SEd Tanous     if ((inserted != std::nullopt) && !*inserted)
394c6f4e017SAgata Olender     {
395c6f4e017SAgata Olender         BMCWEB_LOG_ERROR
396c6f4e017SAgata Olender             << "Request action optional parameter Inserted must be true.";
397c6f4e017SAgata Olender 
39822db1728SEd Tanous         messages::actionParameterNotSupported(res, "Inserted", "InsertMedia");
399c6f4e017SAgata Olender 
400c6f4e017SAgata Olender         return false;
401c6f4e017SAgata Olender     }
402c6f4e017SAgata Olender 
403c6f4e017SAgata Olender     // optional param transferMethod must be stream
404c6f4e017SAgata Olender     if ((transferMethod != std::nullopt) && (*transferMethod != "Stream"))
405c6f4e017SAgata Olender     {
406c6f4e017SAgata Olender         BMCWEB_LOG_ERROR << "Request action optional parameter "
407c6f4e017SAgata Olender                             "TransferMethod must be Stream.";
408c6f4e017SAgata Olender 
40922db1728SEd Tanous         messages::actionParameterNotSupported(res, "TransferMethod",
41022db1728SEd Tanous                                               "InsertMedia");
411c6f4e017SAgata Olender 
412c6f4e017SAgata Olender         return false;
413c6f4e017SAgata Olender     }
414ace85d60SEd Tanous     boost::urls::result<boost::urls::url_view> url =
415ace85d60SEd Tanous         boost::urls::parse_uri(boost::string_view(imageUrl));
416ace85d60SEd Tanous     if (!url)
417ace85d60SEd Tanous     {
418ace85d60SEd Tanous         messages::resourceAtUriInUnknownFormat(res, *url);
419ace85d60SEd Tanous         return {};
420ace85d60SEd Tanous     }
421c6f4e017SAgata Olender     std::optional<TransferProtocol> uriTransferProtocolType =
422ace85d60SEd Tanous         getTransferProtocolFromUri(*url);
423c6f4e017SAgata Olender 
424c6f4e017SAgata Olender     std::optional<TransferProtocol> paramTransferProtocolType =
425c6f4e017SAgata Olender         getTransferProtocolFromParam(transferProtocolType);
426c6f4e017SAgata Olender 
427c6f4e017SAgata Olender     // ImageUrl does not contain valid protocol type
428c6f4e017SAgata Olender     if (*uriTransferProtocolType == TransferProtocol::invalid)
429c6f4e017SAgata Olender     {
430c6f4e017SAgata Olender         BMCWEB_LOG_ERROR << "Request action parameter ImageUrl must "
431c6f4e017SAgata Olender                             "contain specified protocol type from list: "
432c6f4e017SAgata Olender                             "(smb, https).";
433c6f4e017SAgata Olender 
434ace85d60SEd Tanous         messages::resourceAtUriInUnknownFormat(res, *url);
435c6f4e017SAgata Olender 
436c6f4e017SAgata Olender         return false;
437c6f4e017SAgata Olender     }
438c6f4e017SAgata Olender 
439c6f4e017SAgata Olender     // transferProtocolType should contain value from list
440c6f4e017SAgata Olender     if (*paramTransferProtocolType == TransferProtocol::invalid)
441c6f4e017SAgata Olender     {
442c6f4e017SAgata Olender         BMCWEB_LOG_ERROR << "Request action parameter TransferProtocolType "
443c6f4e017SAgata Olender                             "must be provided with value from list: "
444c6f4e017SAgata Olender                             "(CIFS, HTTPS).";
445c6f4e017SAgata Olender 
44622db1728SEd Tanous         messages::propertyValueNotInList(res, *transferProtocolType,
44722db1728SEd Tanous                                          "TransferProtocolType");
448c6f4e017SAgata Olender         return false;
449c6f4e017SAgata Olender     }
450c6f4e017SAgata Olender 
451c6f4e017SAgata Olender     // valid transfer protocol not provided either with URI nor param
452c6f4e017SAgata Olender     if ((uriTransferProtocolType == std::nullopt) &&
453c6f4e017SAgata Olender         (paramTransferProtocolType == std::nullopt))
454c6f4e017SAgata Olender     {
455c6f4e017SAgata Olender         BMCWEB_LOG_ERROR << "Request action parameter ImageUrl must "
456c6f4e017SAgata Olender                             "contain specified protocol type or param "
457c6f4e017SAgata Olender                             "TransferProtocolType must be provided.";
458c6f4e017SAgata Olender 
459ace85d60SEd Tanous         messages::resourceAtUriInUnknownFormat(res, *url);
460c6f4e017SAgata Olender 
461c6f4e017SAgata Olender         return false;
462c6f4e017SAgata Olender     }
463c6f4e017SAgata Olender 
464c6f4e017SAgata Olender     // valid transfer protocol provided both with URI and param
465c6f4e017SAgata Olender     if ((paramTransferProtocolType != std::nullopt) &&
466c6f4e017SAgata Olender         (uriTransferProtocolType != std::nullopt))
467c6f4e017SAgata Olender     {
468c6f4e017SAgata Olender         // check if protocol is the same for URI and param
469c6f4e017SAgata Olender         if (*paramTransferProtocolType != *uriTransferProtocolType)
470c6f4e017SAgata Olender         {
471c6f4e017SAgata Olender             BMCWEB_LOG_ERROR << "Request action parameter "
472c6f4e017SAgata Olender                                 "TransferProtocolType must  contain the "
473c6f4e017SAgata Olender                                 "same protocol type as protocol type "
474c6f4e017SAgata Olender                                 "provided with param imageUrl.";
475c6f4e017SAgata Olender 
47622db1728SEd Tanous             messages::actionParameterValueTypeError(res, *transferProtocolType,
47722db1728SEd Tanous                                                     "TransferProtocolType",
47822db1728SEd Tanous                                                     "InsertMedia");
479c6f4e017SAgata Olender 
480c6f4e017SAgata Olender             return false;
481c6f4e017SAgata Olender         }
482c6f4e017SAgata Olender     }
483c6f4e017SAgata Olender 
484c6f4e017SAgata Olender     // validation passed
485c6f4e017SAgata Olender     // add protocol to URI if needed
486c6f4e017SAgata Olender     if (uriTransferProtocolType == std::nullopt)
487c6f4e017SAgata Olender     {
48822db1728SEd Tanous         imageUrl =
48922db1728SEd Tanous             getUriWithTransferProtocol(imageUrl, *paramTransferProtocolType);
490c6f4e017SAgata Olender     }
491c6f4e017SAgata Olender 
492c6f4e017SAgata Olender     return true;
493c6f4e017SAgata Olender }
494c6f4e017SAgata Olender 
4951214b7e7SGunnar Mills template <typename T>
4961214b7e7SGunnar Mills static void secureCleanup(T& value)
497988fb7b2SAdrian Ambrożewicz {
4984ecc618fSEd Tanous     // NOLINTNEXTLINE(cppcoreguidelines-pro-type-const-cast)
499988fb7b2SAdrian Ambrożewicz     auto raw = const_cast<typename T::value_type*>(value.data());
500988fb7b2SAdrian Ambrożewicz     explicit_bzero(raw, value.size() * sizeof(*raw));
501988fb7b2SAdrian Ambrożewicz }
502988fb7b2SAdrian Ambrożewicz 
503988fb7b2SAdrian Ambrożewicz class Credentials
504988fb7b2SAdrian Ambrożewicz {
505988fb7b2SAdrian Ambrożewicz   public:
506988fb7b2SAdrian Ambrożewicz     Credentials(std::string&& user, std::string&& password) :
507988fb7b2SAdrian Ambrożewicz         userBuf(std::move(user)), passBuf(std::move(password))
5081214b7e7SGunnar Mills     {}
509988fb7b2SAdrian Ambrożewicz 
510988fb7b2SAdrian Ambrożewicz     ~Credentials()
511988fb7b2SAdrian Ambrożewicz     {
512988fb7b2SAdrian Ambrożewicz         secureCleanup(userBuf);
513988fb7b2SAdrian Ambrożewicz         secureCleanup(passBuf);
514988fb7b2SAdrian Ambrożewicz     }
515988fb7b2SAdrian Ambrożewicz 
516988fb7b2SAdrian Ambrożewicz     const std::string& user()
517988fb7b2SAdrian Ambrożewicz     {
518988fb7b2SAdrian Ambrożewicz         return userBuf;
519988fb7b2SAdrian Ambrożewicz     }
520988fb7b2SAdrian Ambrożewicz 
521988fb7b2SAdrian Ambrożewicz     const std::string& password()
522988fb7b2SAdrian Ambrożewicz     {
523988fb7b2SAdrian Ambrożewicz         return passBuf;
524988fb7b2SAdrian Ambrożewicz     }
525988fb7b2SAdrian Ambrożewicz 
526988fb7b2SAdrian Ambrożewicz     Credentials() = delete;
527988fb7b2SAdrian Ambrożewicz     Credentials(const Credentials&) = delete;
528988fb7b2SAdrian Ambrożewicz     Credentials& operator=(const Credentials&) = delete;
529ecd6a3a2SEd Tanous     Credentials(Credentials&&) = delete;
530ecd6a3a2SEd Tanous     Credentials& operator=(Credentials&&) = delete;
531988fb7b2SAdrian Ambrożewicz 
53222db1728SEd Tanous   private:
533988fb7b2SAdrian Ambrożewicz     std::string userBuf;
534988fb7b2SAdrian Ambrożewicz     std::string passBuf;
535988fb7b2SAdrian Ambrożewicz };
536988fb7b2SAdrian Ambrożewicz 
537988fb7b2SAdrian Ambrożewicz class CredentialsProvider
538988fb7b2SAdrian Ambrożewicz {
539988fb7b2SAdrian Ambrożewicz   public:
5401214b7e7SGunnar Mills     template <typename T>
5411214b7e7SGunnar Mills     struct Deleter
542988fb7b2SAdrian Ambrożewicz     {
543988fb7b2SAdrian Ambrożewicz         void operator()(T* buff) const
544988fb7b2SAdrian Ambrożewicz         {
545988fb7b2SAdrian Ambrożewicz             if (buff)
546988fb7b2SAdrian Ambrożewicz             {
547988fb7b2SAdrian Ambrożewicz                 secureCleanup(*buff);
548988fb7b2SAdrian Ambrożewicz                 delete buff;
549988fb7b2SAdrian Ambrożewicz             }
550988fb7b2SAdrian Ambrożewicz         }
551988fb7b2SAdrian Ambrożewicz     };
552988fb7b2SAdrian Ambrożewicz 
553988fb7b2SAdrian Ambrożewicz     using Buffer = std::vector<char>;
554988fb7b2SAdrian Ambrożewicz     using SecureBuffer = std::unique_ptr<Buffer, Deleter<Buffer>>;
555988fb7b2SAdrian Ambrożewicz     // Using explicit definition instead of std::function to avoid implicit
556988fb7b2SAdrian Ambrożewicz     // conversions eg. stack copy instead of reference
557988fb7b2SAdrian Ambrożewicz     using FormatterFunc = void(const std::string& username,
558988fb7b2SAdrian Ambrożewicz                                const std::string& password, Buffer& dest);
559988fb7b2SAdrian Ambrożewicz 
560988fb7b2SAdrian Ambrożewicz     CredentialsProvider(std::string&& user, std::string&& password) :
561988fb7b2SAdrian Ambrożewicz         credentials(std::move(user), std::move(password))
5621214b7e7SGunnar Mills     {}
563988fb7b2SAdrian Ambrożewicz 
564988fb7b2SAdrian Ambrożewicz     const std::string& user()
565988fb7b2SAdrian Ambrożewicz     {
566988fb7b2SAdrian Ambrożewicz         return credentials.user();
567988fb7b2SAdrian Ambrożewicz     }
568988fb7b2SAdrian Ambrożewicz 
569988fb7b2SAdrian Ambrożewicz     const std::string& password()
570988fb7b2SAdrian Ambrożewicz     {
571988fb7b2SAdrian Ambrożewicz         return credentials.password();
572988fb7b2SAdrian Ambrożewicz     }
573988fb7b2SAdrian Ambrożewicz 
57481ce609eSEd Tanous     SecureBuffer pack(FormatterFunc formatter)
575988fb7b2SAdrian Ambrożewicz     {
576988fb7b2SAdrian Ambrożewicz         SecureBuffer packed{new Buffer{}};
577e662eae8SEd Tanous         if (formatter != nullptr)
578988fb7b2SAdrian Ambrożewicz         {
579988fb7b2SAdrian Ambrożewicz             formatter(credentials.user(), credentials.password(), *packed);
580988fb7b2SAdrian Ambrożewicz         }
581988fb7b2SAdrian Ambrożewicz 
582988fb7b2SAdrian Ambrożewicz         return packed;
583988fb7b2SAdrian Ambrożewicz     }
584988fb7b2SAdrian Ambrożewicz 
585988fb7b2SAdrian Ambrożewicz   private:
586988fb7b2SAdrian Ambrożewicz     Credentials credentials;
587988fb7b2SAdrian Ambrożewicz };
588988fb7b2SAdrian Ambrożewicz 
589988fb7b2SAdrian Ambrożewicz // Wrapper for boost::async_pipe ensuring proper pipe cleanup
5901214b7e7SGunnar Mills template <typename Buffer>
5911214b7e7SGunnar Mills class Pipe
592988fb7b2SAdrian Ambrożewicz {
593988fb7b2SAdrian Ambrożewicz   public:
594988fb7b2SAdrian Ambrożewicz     using unix_fd = sdbusplus::message::unix_fd;
595988fb7b2SAdrian Ambrożewicz 
596988fb7b2SAdrian Ambrożewicz     Pipe(boost::asio::io_context& io, Buffer&& buffer) :
597988fb7b2SAdrian Ambrożewicz         impl(io), buffer{std::move(buffer)}
5981214b7e7SGunnar Mills     {}
599988fb7b2SAdrian Ambrożewicz 
600988fb7b2SAdrian Ambrożewicz     ~Pipe()
601988fb7b2SAdrian Ambrożewicz     {
602988fb7b2SAdrian Ambrożewicz         // Named pipe needs to be explicitly removed
603988fb7b2SAdrian Ambrożewicz         impl.close();
604988fb7b2SAdrian Ambrożewicz     }
605988fb7b2SAdrian Ambrożewicz 
606ecd6a3a2SEd Tanous     Pipe(const Pipe&) = delete;
607ecd6a3a2SEd Tanous     Pipe(Pipe&&) = delete;
608ecd6a3a2SEd Tanous     Pipe& operator=(const Pipe&) = delete;
609ecd6a3a2SEd Tanous     Pipe& operator=(Pipe&&) = delete;
610ecd6a3a2SEd Tanous 
611988fb7b2SAdrian Ambrożewicz     unix_fd fd()
612988fb7b2SAdrian Ambrożewicz     {
613988fb7b2SAdrian Ambrożewicz         return unix_fd{impl.native_source()};
614988fb7b2SAdrian Ambrożewicz     }
615988fb7b2SAdrian Ambrożewicz 
616988fb7b2SAdrian Ambrożewicz     template <typename WriteHandler>
61781ce609eSEd Tanous     void asyncWrite(WriteHandler&& handler)
618988fb7b2SAdrian Ambrożewicz     {
619988fb7b2SAdrian Ambrożewicz         impl.async_write_some(data(), std::forward<WriteHandler>(handler));
620988fb7b2SAdrian Ambrożewicz     }
621988fb7b2SAdrian Ambrożewicz 
622988fb7b2SAdrian Ambrożewicz   private:
623988fb7b2SAdrian Ambrożewicz     // Specialization for pointer types
624988fb7b2SAdrian Ambrożewicz     template <typename B = Buffer>
625988fb7b2SAdrian Ambrożewicz     typename std::enable_if<boost::has_dereference<B>::value,
626988fb7b2SAdrian Ambrożewicz                             boost::asio::const_buffer>::type
627988fb7b2SAdrian Ambrożewicz         data()
628988fb7b2SAdrian Ambrożewicz     {
629988fb7b2SAdrian Ambrożewicz         return boost::asio::buffer(*buffer);
630988fb7b2SAdrian Ambrożewicz     }
631988fb7b2SAdrian Ambrożewicz 
632988fb7b2SAdrian Ambrożewicz     template <typename B = Buffer>
633988fb7b2SAdrian Ambrożewicz     typename std::enable_if<!boost::has_dereference<B>::value,
634988fb7b2SAdrian Ambrożewicz                             boost::asio::const_buffer>::type
635988fb7b2SAdrian Ambrożewicz         data()
636988fb7b2SAdrian Ambrożewicz     {
637988fb7b2SAdrian Ambrożewicz         return boost::asio::buffer(buffer);
638988fb7b2SAdrian Ambrożewicz     }
639988fb7b2SAdrian Ambrożewicz 
640988fb7b2SAdrian Ambrożewicz     const std::string name;
641988fb7b2SAdrian Ambrożewicz     boost::process::async_pipe impl;
642988fb7b2SAdrian Ambrożewicz     Buffer buffer;
643988fb7b2SAdrian Ambrożewicz };
644988fb7b2SAdrian Ambrożewicz 
645e13c2760SPrzemyslaw Czarnowski /**
646e13c2760SPrzemyslaw Czarnowski  * @brief Function transceives data with dbus directly.
647e13c2760SPrzemyslaw Czarnowski  *
648e13c2760SPrzemyslaw Czarnowski  * All BMC state properties will be retrieved before sending reset request.
649e13c2760SPrzemyslaw Czarnowski  */
65022db1728SEd Tanous inline void doMountVmLegacy(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
651e13c2760SPrzemyslaw Czarnowski                             const std::string& service, const std::string& name,
652988fb7b2SAdrian Ambrożewicz                             const std::string& imageUrl, const bool rw,
653988fb7b2SAdrian Ambrożewicz                             std::string&& userName, std::string&& password)
654e13c2760SPrzemyslaw Czarnowski {
655988fb7b2SAdrian Ambrożewicz     using SecurePipe = Pipe<CredentialsProvider::SecureBuffer>;
656988fb7b2SAdrian Ambrożewicz     constexpr const size_t secretLimit = 1024;
657988fb7b2SAdrian Ambrożewicz 
658988fb7b2SAdrian Ambrożewicz     std::shared_ptr<SecurePipe> secretPipe;
659168e20c1SEd Tanous     dbus::utility::DbusVariantType unixFd = -1;
660988fb7b2SAdrian Ambrożewicz 
661988fb7b2SAdrian Ambrożewicz     if (!userName.empty() || !password.empty())
662988fb7b2SAdrian Ambrożewicz     {
663988fb7b2SAdrian Ambrożewicz         // Encapsulate in safe buffer
664988fb7b2SAdrian Ambrożewicz         CredentialsProvider credentials(std::move(userName),
665988fb7b2SAdrian Ambrożewicz                                         std::move(password));
666988fb7b2SAdrian Ambrożewicz 
667988fb7b2SAdrian Ambrożewicz         // Payload must contain data + NULL delimiters
668988fb7b2SAdrian Ambrożewicz         if (credentials.user().size() + credentials.password().size() + 2 >
669988fb7b2SAdrian Ambrożewicz             secretLimit)
670988fb7b2SAdrian Ambrożewicz         {
671988fb7b2SAdrian Ambrożewicz             BMCWEB_LOG_ERROR << "Credentials too long to handle";
672988fb7b2SAdrian Ambrożewicz             messages::unrecognizedRequestBody(asyncResp->res);
673988fb7b2SAdrian Ambrożewicz             return;
674988fb7b2SAdrian Ambrożewicz         }
675988fb7b2SAdrian Ambrożewicz 
676988fb7b2SAdrian Ambrożewicz         // Pack secret
67722db1728SEd Tanous         auto secret = credentials.pack(
67822db1728SEd Tanous             [](const auto& user, const auto& pass, auto& buff) {
679988fb7b2SAdrian Ambrożewicz                 std::copy(user.begin(), user.end(), std::back_inserter(buff));
680988fb7b2SAdrian Ambrożewicz                 buff.push_back('\0');
681988fb7b2SAdrian Ambrożewicz                 std::copy(pass.begin(), pass.end(), std::back_inserter(buff));
682988fb7b2SAdrian Ambrożewicz                 buff.push_back('\0');
683988fb7b2SAdrian Ambrożewicz             });
684988fb7b2SAdrian Ambrożewicz 
685988fb7b2SAdrian Ambrożewicz         // Open pipe
686988fb7b2SAdrian Ambrożewicz         secretPipe = std::make_shared<SecurePipe>(
68722db1728SEd Tanous             crow::connections::systemBus->get_io_context(), std::move(secret));
688988fb7b2SAdrian Ambrożewicz         unixFd = secretPipe->fd();
689988fb7b2SAdrian Ambrożewicz 
690988fb7b2SAdrian Ambrożewicz         // Pass secret over pipe
69181ce609eSEd Tanous         secretPipe->asyncWrite(
692f5b16f03SVikram Bodireddy             [asyncResp](const boost::system::error_code& ec, std::size_t) {
693988fb7b2SAdrian Ambrożewicz                 if (ec)
694988fb7b2SAdrian Ambrożewicz                 {
695988fb7b2SAdrian Ambrożewicz                     BMCWEB_LOG_ERROR << "Failed to pass secret: " << ec;
696988fb7b2SAdrian Ambrożewicz                     messages::internalError(asyncResp->res);
697988fb7b2SAdrian Ambrożewicz                 }
698988fb7b2SAdrian Ambrożewicz             });
699988fb7b2SAdrian Ambrożewicz     }
700988fb7b2SAdrian Ambrożewicz 
701e13c2760SPrzemyslaw Czarnowski     crow::connections::systemBus->async_method_call(
702988fb7b2SAdrian Ambrożewicz         [asyncResp, secretPipe](const boost::system::error_code ec,
703988fb7b2SAdrian Ambrożewicz                                 bool success) {
704e13c2760SPrzemyslaw Czarnowski             if (ec)
705e13c2760SPrzemyslaw Czarnowski             {
706e13c2760SPrzemyslaw Czarnowski                 BMCWEB_LOG_ERROR << "Bad D-Bus request error: " << ec;
707e13c2760SPrzemyslaw Czarnowski                 messages::internalError(asyncResp->res);
708d6da5bebSAdrian Ambrożewicz             }
709d6da5bebSAdrian Ambrożewicz             else if (!success)
710d6da5bebSAdrian Ambrożewicz             {
711d6da5bebSAdrian Ambrożewicz                 BMCWEB_LOG_ERROR << "Service responded with error";
712d6da5bebSAdrian Ambrożewicz                 messages::generalError(asyncResp->res);
713e13c2760SPrzemyslaw Czarnowski             }
714e13c2760SPrzemyslaw Czarnowski         },
715e13c2760SPrzemyslaw Czarnowski         service, "/xyz/openbmc_project/VirtualMedia/Legacy/" + name,
716988fb7b2SAdrian Ambrożewicz         "xyz.openbmc_project.VirtualMedia.Legacy", "Mount", imageUrl, rw,
717988fb7b2SAdrian Ambrożewicz         unixFd);
718e13c2760SPrzemyslaw Czarnowski }
719e13c2760SPrzemyslaw Czarnowski 
720e13c2760SPrzemyslaw Czarnowski /**
721e13c2760SPrzemyslaw Czarnowski  * @brief Function transceives data with dbus directly.
722e13c2760SPrzemyslaw Czarnowski  *
723e13c2760SPrzemyslaw Czarnowski  * All BMC state properties will be retrieved before sending reset request.
724e13c2760SPrzemyslaw Czarnowski  */
72522db1728SEd Tanous inline void doVmAction(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
726e13c2760SPrzemyslaw Czarnowski                        const std::string& service, const std::string& name,
727e13c2760SPrzemyslaw Czarnowski                        bool legacy)
728e13c2760SPrzemyslaw Czarnowski {
729e13c2760SPrzemyslaw Czarnowski 
730e13c2760SPrzemyslaw Czarnowski     // Legacy mount requires parameter with image
731e13c2760SPrzemyslaw Czarnowski     if (legacy)
732e13c2760SPrzemyslaw Czarnowski     {
733e13c2760SPrzemyslaw Czarnowski         crow::connections::systemBus->async_method_call(
734e13c2760SPrzemyslaw Czarnowski             [asyncResp](const boost::system::error_code ec) {
735e13c2760SPrzemyslaw Czarnowski                 if (ec)
736e13c2760SPrzemyslaw Czarnowski                 {
737e13c2760SPrzemyslaw Czarnowski                     BMCWEB_LOG_ERROR << "Bad D-Bus request error: " << ec;
738e13c2760SPrzemyslaw Czarnowski 
739e13c2760SPrzemyslaw Czarnowski                     messages::internalError(asyncResp->res);
740e13c2760SPrzemyslaw Czarnowski                     return;
741e13c2760SPrzemyslaw Czarnowski                 }
742e13c2760SPrzemyslaw Czarnowski             },
743e13c2760SPrzemyslaw Czarnowski             service, "/xyz/openbmc_project/VirtualMedia/Legacy/" + name,
744e13c2760SPrzemyslaw Czarnowski             "xyz.openbmc_project.VirtualMedia.Legacy", "Unmount");
745e13c2760SPrzemyslaw Czarnowski     }
746e13c2760SPrzemyslaw Czarnowski     else // proxy
747e13c2760SPrzemyslaw Czarnowski     {
748e13c2760SPrzemyslaw Czarnowski         crow::connections::systemBus->async_method_call(
749e13c2760SPrzemyslaw Czarnowski             [asyncResp](const boost::system::error_code ec) {
750e13c2760SPrzemyslaw Czarnowski                 if (ec)
751e13c2760SPrzemyslaw Czarnowski                 {
752e13c2760SPrzemyslaw Czarnowski                     BMCWEB_LOG_ERROR << "Bad D-Bus request error: " << ec;
753e13c2760SPrzemyslaw Czarnowski 
754e13c2760SPrzemyslaw Czarnowski                     messages::internalError(asyncResp->res);
755e13c2760SPrzemyslaw Czarnowski                     return;
756e13c2760SPrzemyslaw Czarnowski                 }
757e13c2760SPrzemyslaw Czarnowski             },
758e13c2760SPrzemyslaw Czarnowski             service, "/xyz/openbmc_project/VirtualMedia/Proxy/" + name,
759e13c2760SPrzemyslaw Czarnowski             "xyz.openbmc_project.VirtualMedia.Proxy", "Unmount");
760e13c2760SPrzemyslaw Czarnowski     }
761e13c2760SPrzemyslaw Czarnowski }
762e13c2760SPrzemyslaw Czarnowski 
76398be3e39SEd Tanous struct InsertMediaActionParams
76498be3e39SEd Tanous {
76598be3e39SEd Tanous     std::string imageUrl;
76698be3e39SEd Tanous     std::optional<std::string> userName;
76798be3e39SEd Tanous     std::optional<std::string> password;
76898be3e39SEd Tanous     std::optional<std::string> transferMethod;
76998be3e39SEd Tanous     std::optional<std::string> transferProtocolType;
77098be3e39SEd Tanous     std::optional<bool> writeProtected = true;
77198be3e39SEd Tanous     std::optional<bool> inserted;
77298be3e39SEd Tanous };
77398be3e39SEd Tanous 
77422db1728SEd Tanous inline void requestNBDVirtualMediaRoutes(App& app)
775107077deSPrzemyslaw Czarnowski {
7760fda0f12SGeorge Liu     BMCWEB_ROUTE(
7770fda0f12SGeorge Liu         app,
7780fda0f12SGeorge Liu         "/redfish/v1/Managers/<str>/VirtualMedia/<str>/Actions/VirtualMedia.InsertMedia")
779ed398213SEd Tanous         .privileges(redfish::privileges::postVirtualMedia)
78022db1728SEd Tanous         .methods(boost::beast::http::verb::post)(
78122db1728SEd Tanous             [](const crow::Request& req,
78222db1728SEd Tanous                const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
78322db1728SEd Tanous                const std::string& name, const std::string& resName) {
78422db1728SEd Tanous                 if (name != "bmc")
785107077deSPrzemyslaw Czarnowski                 {
78622db1728SEd Tanous                     messages::resourceNotFound(asyncResp->res,
78722db1728SEd Tanous                                                "VirtualMedia.Insert", resName);
788107077deSPrzemyslaw Czarnowski 
789107077deSPrzemyslaw Czarnowski                     return;
790107077deSPrzemyslaw Czarnowski                 }
79198be3e39SEd Tanous                 InsertMediaActionParams actionParams;
79298be3e39SEd Tanous 
79398be3e39SEd Tanous                 // Read obligatory parameters (url of
79498be3e39SEd Tanous                 // image)
79515ed6780SWilly Tu                 if (!json_util::readJsonAction(
79698be3e39SEd Tanous                         req, asyncResp->res, "Image", actionParams.imageUrl,
79798be3e39SEd Tanous                         "WriteProtected", actionParams.writeProtected,
79898be3e39SEd Tanous                         "UserName", actionParams.userName, "Password",
79998be3e39SEd Tanous                         actionParams.password, "Inserted",
80098be3e39SEd Tanous                         actionParams.inserted, "TransferMethod",
80198be3e39SEd Tanous                         actionParams.transferMethod, "TransferProtocolType",
80298be3e39SEd Tanous                         actionParams.transferProtocolType))
80398be3e39SEd Tanous                 {
80498be3e39SEd Tanous                     BMCWEB_LOG_DEBUG << "Image is not provided";
80598be3e39SEd Tanous                     return;
80698be3e39SEd Tanous                 }
80798be3e39SEd Tanous 
80898be3e39SEd Tanous                 bool paramsValid = validateParams(
80998be3e39SEd Tanous                     asyncResp->res, actionParams.imageUrl,
81098be3e39SEd Tanous                     actionParams.inserted, actionParams.transferMethod,
81198be3e39SEd Tanous                     actionParams.transferProtocolType);
81298be3e39SEd Tanous 
813e05aec50SEd Tanous                 if (!paramsValid)
81498be3e39SEd Tanous                 {
81598be3e39SEd Tanous                     return;
81698be3e39SEd Tanous                 }
817107077deSPrzemyslaw Czarnowski 
81822db1728SEd Tanous                 crow::connections::systemBus->async_method_call(
81998be3e39SEd Tanous                     [asyncResp, actionParams,
82022db1728SEd Tanous                      resName](const boost::system::error_code ec,
821*b9d36b47SEd Tanous                               const dbus::utility::MapperGetObject&
822*b9d36b47SEd Tanous                                   getObjectType) mutable {
82322db1728SEd Tanous                         if (ec)
82422db1728SEd Tanous                         {
82522db1728SEd Tanous                             BMCWEB_LOG_ERROR
82622db1728SEd Tanous                                 << "ObjectMapper::GetObject call failed: "
82722db1728SEd Tanous                                 << ec;
82822db1728SEd Tanous                             messages::internalError(asyncResp->res);
829107077deSPrzemyslaw Czarnowski 
83022db1728SEd Tanous                             return;
83122db1728SEd Tanous                         }
83222db1728SEd Tanous                         std::string service = getObjectType.begin()->first;
83322db1728SEd Tanous                         BMCWEB_LOG_DEBUG << "GetObjectType: " << service;
83422db1728SEd Tanous 
83522db1728SEd Tanous                         crow::connections::systemBus->async_method_call(
83698be3e39SEd Tanous                             [service, resName, actionParams,
83722db1728SEd Tanous                              asyncResp](const boost::system::error_code ec,
838711ac7a9SEd Tanous                                         dbus::utility::ManagedObjectType&
839711ac7a9SEd Tanous                                             subtree) mutable {
84022db1728SEd Tanous                                 if (ec)
84122db1728SEd Tanous                                 {
84222db1728SEd Tanous                                     BMCWEB_LOG_DEBUG << "DBUS response error";
84322db1728SEd Tanous 
84422db1728SEd Tanous                                     return;
84522db1728SEd Tanous                                 }
84622db1728SEd Tanous 
84722db1728SEd Tanous                                 for (const auto& object : subtree)
84822db1728SEd Tanous                                 {
84922db1728SEd Tanous                                     const std::string& path =
85022db1728SEd Tanous                                         static_cast<const std::string&>(
85122db1728SEd Tanous                                             object.first);
85222db1728SEd Tanous 
85322db1728SEd Tanous                                     std::size_t lastIndex = path.rfind('/');
85422db1728SEd Tanous                                     if (lastIndex == std::string::npos)
85522db1728SEd Tanous                                     {
85622db1728SEd Tanous                                         continue;
85722db1728SEd Tanous                                     }
85822db1728SEd Tanous 
85922db1728SEd Tanous                                     lastIndex += 1;
86022db1728SEd Tanous 
86122db1728SEd Tanous                                     if (path.substr(lastIndex) == resName)
86222db1728SEd Tanous                                     {
86322db1728SEd Tanous                                         lastIndex = path.rfind("Proxy");
86422db1728SEd Tanous                                         if (lastIndex != std::string::npos)
86522db1728SEd Tanous                                         {
86622db1728SEd Tanous                                             // Not possible in proxy mode
86722db1728SEd Tanous                                             BMCWEB_LOG_DEBUG
86822db1728SEd Tanous                                                 << "InsertMedia not "
86922db1728SEd Tanous                                                    "allowed in proxy mode";
87022db1728SEd Tanous                                             messages::resourceNotFound(
87122db1728SEd Tanous                                                 asyncResp->res,
87222db1728SEd Tanous                                                 "VirtualMedia.InsertMedia",
87322db1728SEd Tanous                                                 resName);
87422db1728SEd Tanous 
87522db1728SEd Tanous                                             return;
87622db1728SEd Tanous                                         }
87722db1728SEd Tanous 
87822db1728SEd Tanous                                         lastIndex = path.rfind("Legacy");
87922db1728SEd Tanous                                         if (lastIndex == std::string::npos)
88022db1728SEd Tanous                                         {
88122db1728SEd Tanous                                             continue;
88222db1728SEd Tanous                                         }
88322db1728SEd Tanous 
88422db1728SEd Tanous                                         // manager is irrelevant for
88522db1728SEd Tanous                                         // VirtualMedia dbus calls
88698be3e39SEd Tanous                                         doMountVmLegacy(
88798be3e39SEd Tanous                                             asyncResp, service, resName,
88898be3e39SEd Tanous                                             actionParams.imageUrl,
88998be3e39SEd Tanous                                             !(*actionParams.writeProtected),
89098be3e39SEd Tanous                                             std::move(*actionParams.userName),
89198be3e39SEd Tanous                                             std::move(*actionParams.password));
89222db1728SEd Tanous 
89322db1728SEd Tanous                                         return;
89422db1728SEd Tanous                                     }
89522db1728SEd Tanous                                 }
89622db1728SEd Tanous                                 BMCWEB_LOG_DEBUG << "Parent item not found";
89722db1728SEd Tanous                                 messages::resourceNotFound(
89822db1728SEd Tanous                                     asyncResp->res, "VirtualMedia", resName);
89922db1728SEd Tanous                             },
90022db1728SEd Tanous                             service, "/xyz/openbmc_project/VirtualMedia",
90122db1728SEd Tanous                             "org.freedesktop.DBus.ObjectManager",
90222db1728SEd Tanous                             "GetManagedObjects");
90322db1728SEd Tanous                     },
90422db1728SEd Tanous                     "xyz.openbmc_project.ObjectMapper",
90522db1728SEd Tanous                     "/xyz/openbmc_project/object_mapper",
90622db1728SEd Tanous                     "xyz.openbmc_project.ObjectMapper", "GetObject",
90722db1728SEd Tanous                     "/xyz/openbmc_project/VirtualMedia",
90822db1728SEd Tanous                     std::array<const char*, 0>());
90922db1728SEd Tanous             });
91022db1728SEd Tanous 
9110fda0f12SGeorge Liu     BMCWEB_ROUTE(
9120fda0f12SGeorge Liu         app,
9130fda0f12SGeorge Liu         "/redfish/v1/Managers/<str>/VirtualMedia/<str>/Actions/VirtualMedia.EjectMedia")
914ed398213SEd Tanous         .privileges(redfish::privileges::postVirtualMedia)
91522db1728SEd Tanous         .methods(boost::beast::http::verb::post)(
91698be3e39SEd Tanous             [](const crow::Request&,
91722db1728SEd Tanous                const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
91822db1728SEd Tanous                const std::string& name, const std::string& resName) {
919107077deSPrzemyslaw Czarnowski                 if (name != "bmc")
920107077deSPrzemyslaw Czarnowski                 {
92122db1728SEd Tanous                     messages::resourceNotFound(asyncResp->res,
92222db1728SEd Tanous                                                "VirtualMedia.Eject", resName);
92322db1728SEd Tanous 
92422db1728SEd Tanous                     return;
92522db1728SEd Tanous                 }
92622db1728SEd Tanous 
92722db1728SEd Tanous                 crow::connections::systemBus->async_method_call(
928*b9d36b47SEd Tanous                     [asyncResp, resName](
929*b9d36b47SEd Tanous                         const boost::system::error_code ec,
930*b9d36b47SEd Tanous                         const dbus::utility::MapperGetObject& getObjectType) {
93122db1728SEd Tanous                         if (ec)
93222db1728SEd Tanous                         {
93322db1728SEd Tanous                             BMCWEB_LOG_ERROR
93422db1728SEd Tanous                                 << "ObjectMapper::GetObject call failed: "
93522db1728SEd Tanous                                 << ec;
93622db1728SEd Tanous                             messages::internalError(asyncResp->res);
93722db1728SEd Tanous 
93822db1728SEd Tanous                             return;
93922db1728SEd Tanous                         }
94022db1728SEd Tanous                         std::string service = getObjectType.begin()->first;
94122db1728SEd Tanous                         BMCWEB_LOG_DEBUG << "GetObjectType: " << service;
94222db1728SEd Tanous 
94322db1728SEd Tanous                         crow::connections::systemBus->async_method_call(
94498be3e39SEd Tanous                             [resName, service, asyncResp{asyncResp}](
94522db1728SEd Tanous                                 const boost::system::error_code ec,
946711ac7a9SEd Tanous                                 dbus::utility::ManagedObjectType& subtree) {
94722db1728SEd Tanous                                 if (ec)
94822db1728SEd Tanous                                 {
94922db1728SEd Tanous                                     BMCWEB_LOG_DEBUG << "DBUS response error";
95022db1728SEd Tanous 
95122db1728SEd Tanous                                     return;
95222db1728SEd Tanous                                 }
95322db1728SEd Tanous 
95422db1728SEd Tanous                                 for (const auto& object : subtree)
95522db1728SEd Tanous                                 {
95622db1728SEd Tanous                                     const std::string& path =
95722db1728SEd Tanous                                         static_cast<const std::string&>(
95822db1728SEd Tanous                                             object.first);
95922db1728SEd Tanous 
96022db1728SEd Tanous                                     std::size_t lastIndex = path.rfind('/');
96122db1728SEd Tanous                                     if (lastIndex == std::string::npos)
96222db1728SEd Tanous                                     {
96322db1728SEd Tanous                                         continue;
96422db1728SEd Tanous                                     }
96522db1728SEd Tanous 
96622db1728SEd Tanous                                     lastIndex += 1;
96722db1728SEd Tanous 
96822db1728SEd Tanous                                     if (path.substr(lastIndex) == resName)
96922db1728SEd Tanous                                     {
97022db1728SEd Tanous                                         lastIndex = path.rfind("Proxy");
97122db1728SEd Tanous                                         if (lastIndex != std::string::npos)
97222db1728SEd Tanous                                         {
97322db1728SEd Tanous                                             // Proxy mode
97422db1728SEd Tanous                                             doVmAction(asyncResp, service,
97522db1728SEd Tanous                                                        resName, false);
97622db1728SEd Tanous                                         }
97722db1728SEd Tanous 
97822db1728SEd Tanous                                         lastIndex = path.rfind("Legacy");
97922db1728SEd Tanous                                         if (lastIndex != std::string::npos)
98022db1728SEd Tanous                                         {
98122db1728SEd Tanous                                             // Legacy mode
98222db1728SEd Tanous                                             doVmAction(asyncResp, service,
98322db1728SEd Tanous                                                        resName, true);
98422db1728SEd Tanous                                         }
98522db1728SEd Tanous 
98622db1728SEd Tanous                                         return;
98722db1728SEd Tanous                                     }
98822db1728SEd Tanous                                 }
98922db1728SEd Tanous                                 BMCWEB_LOG_DEBUG << "Parent item not found";
99022db1728SEd Tanous                                 messages::resourceNotFound(
99122db1728SEd Tanous                                     asyncResp->res, "VirtualMedia", resName);
99222db1728SEd Tanous                             },
99322db1728SEd Tanous                             service, "/xyz/openbmc_project/VirtualMedia",
99422db1728SEd Tanous                             "org.freedesktop.DBus.ObjectManager",
99522db1728SEd Tanous                             "GetManagedObjects");
99622db1728SEd Tanous                     },
99722db1728SEd Tanous                     "xyz.openbmc_project.ObjectMapper",
99822db1728SEd Tanous                     "/xyz/openbmc_project/object_mapper",
99922db1728SEd Tanous                     "xyz.openbmc_project.ObjectMapper", "GetObject",
100022db1728SEd Tanous                     "/xyz/openbmc_project/VirtualMedia",
100122db1728SEd Tanous                     std::array<const char*, 0>());
100222db1728SEd Tanous             });
100322db1728SEd Tanous     BMCWEB_ROUTE(app, "/redfish/v1/Managers/<str>/VirtualMedia/")
1004ed398213SEd Tanous         .privileges(redfish::privileges::getVirtualMediaCollection)
100522db1728SEd Tanous         .methods(boost::beast::http::verb::get)(
100622db1728SEd Tanous             [](const crow::Request& /* req */,
100722db1728SEd Tanous                const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
100822db1728SEd Tanous                const std::string& name) {
100922db1728SEd Tanous                 if (name != "bmc")
101022db1728SEd Tanous                 {
101122db1728SEd Tanous                     messages::resourceNotFound(asyncResp->res, "VirtualMedia",
101222db1728SEd Tanous                                                name);
1013107077deSPrzemyslaw Czarnowski 
1014107077deSPrzemyslaw Czarnowski                     return;
1015107077deSPrzemyslaw Czarnowski                 }
1016107077deSPrzemyslaw Czarnowski 
10178d1b46d7Szhanghch05                 asyncResp->res.jsonValue["@odata.type"] =
1018107077deSPrzemyslaw Czarnowski                     "#VirtualMediaCollection.VirtualMediaCollection";
10198d1b46d7Szhanghch05                 asyncResp->res.jsonValue["Name"] = "Virtual Media Services";
10208d1b46d7Szhanghch05                 asyncResp->res.jsonValue["@odata.id"] =
1021d6c414f3SPrzemyslaw Czarnowski                     "/redfish/v1/Managers/" + name + "/VirtualMedia";
1022107077deSPrzemyslaw Czarnowski 
1023107077deSPrzemyslaw Czarnowski                 crow::connections::systemBus->async_method_call(
1024*b9d36b47SEd Tanous                     [asyncResp, name](
1025*b9d36b47SEd Tanous                         const boost::system::error_code ec,
1026*b9d36b47SEd Tanous                         const dbus::utility::MapperGetObject& getObjectType) {
1027107077deSPrzemyslaw Czarnowski                         if (ec)
1028107077deSPrzemyslaw Czarnowski                         {
102922db1728SEd Tanous                             BMCWEB_LOG_ERROR
103022db1728SEd Tanous                                 << "ObjectMapper::GetObject call failed: "
1031107077deSPrzemyslaw Czarnowski                                 << ec;
1032107077deSPrzemyslaw Czarnowski                             messages::internalError(asyncResp->res);
1033107077deSPrzemyslaw Czarnowski 
1034107077deSPrzemyslaw Czarnowski                             return;
1035107077deSPrzemyslaw Czarnowski                         }
1036107077deSPrzemyslaw Czarnowski                         std::string service = getObjectType.begin()->first;
1037107077deSPrzemyslaw Czarnowski                         BMCWEB_LOG_DEBUG << "GetObjectType: " << service;
1038107077deSPrzemyslaw Czarnowski 
1039107077deSPrzemyslaw Czarnowski                         getVmResourceList(asyncResp, service, name);
1040107077deSPrzemyslaw Czarnowski                     },
1041107077deSPrzemyslaw Czarnowski                     "xyz.openbmc_project.ObjectMapper",
1042107077deSPrzemyslaw Czarnowski                     "/xyz/openbmc_project/object_mapper",
1043107077deSPrzemyslaw Czarnowski                     "xyz.openbmc_project.ObjectMapper", "GetObject",
104422db1728SEd Tanous                     "/xyz/openbmc_project/VirtualMedia",
104522db1728SEd Tanous                     std::array<const char*, 0>());
104622db1728SEd Tanous             });
1047107077deSPrzemyslaw Czarnowski 
104822db1728SEd Tanous     BMCWEB_ROUTE(app, "/redfish/v1/Managers/<str>/VirtualMedia/<str>/")
1049ed398213SEd Tanous         .privileges(redfish::privileges::getVirtualMedia)
105022db1728SEd Tanous         .methods(boost::beast::http::verb::get)(
105122db1728SEd Tanous             [](const crow::Request& /* req */,
105222db1728SEd Tanous                const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
105322db1728SEd Tanous                const std::string& name, const std::string& resName) {
1054107077deSPrzemyslaw Czarnowski                 if (name != "bmc")
1055107077deSPrzemyslaw Czarnowski                 {
105622db1728SEd Tanous                     messages::resourceNotFound(asyncResp->res, "VirtualMedia",
105722db1728SEd Tanous                                                resName);
1058107077deSPrzemyslaw Czarnowski 
1059107077deSPrzemyslaw Czarnowski                     return;
1060107077deSPrzemyslaw Czarnowski                 }
1061107077deSPrzemyslaw Czarnowski 
1062107077deSPrzemyslaw Czarnowski                 crow::connections::systemBus->async_method_call(
1063*b9d36b47SEd Tanous                     [asyncResp, name, resName](
1064*b9d36b47SEd Tanous                         const boost::system::error_code ec,
1065*b9d36b47SEd Tanous                         const dbus::utility::MapperGetObject& getObjectType) {
1066107077deSPrzemyslaw Czarnowski                         if (ec)
1067107077deSPrzemyslaw Czarnowski                         {
106822db1728SEd Tanous                             BMCWEB_LOG_ERROR
106922db1728SEd Tanous                                 << "ObjectMapper::GetObject call failed: "
1070107077deSPrzemyslaw Czarnowski                                 << ec;
1071107077deSPrzemyslaw Czarnowski                             messages::internalError(asyncResp->res);
1072107077deSPrzemyslaw Czarnowski 
1073107077deSPrzemyslaw Czarnowski                             return;
1074107077deSPrzemyslaw Czarnowski                         }
1075107077deSPrzemyslaw Czarnowski                         std::string service = getObjectType.begin()->first;
1076107077deSPrzemyslaw Czarnowski                         BMCWEB_LOG_DEBUG << "GetObjectType: " << service;
1077107077deSPrzemyslaw Czarnowski 
1078107077deSPrzemyslaw Czarnowski                         getVmData(asyncResp, service, name, resName);
1079107077deSPrzemyslaw Czarnowski                     },
1080107077deSPrzemyslaw Czarnowski                     "xyz.openbmc_project.ObjectMapper",
1081107077deSPrzemyslaw Czarnowski                     "/xyz/openbmc_project/object_mapper",
1082107077deSPrzemyslaw Czarnowski                     "xyz.openbmc_project.ObjectMapper", "GetObject",
108322db1728SEd Tanous                     "/xyz/openbmc_project/VirtualMedia",
108422db1728SEd Tanous                     std::array<const char*, 0>());
108522db1728SEd Tanous             });
1086107077deSPrzemyslaw Czarnowski }
1087107077deSPrzemyslaw Czarnowski 
1088107077deSPrzemyslaw Czarnowski } // namespace redfish
1089