WebListener.cs 47 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157
  1. using System;
  2. using System.Collections.Generic;
  3. using System.IO;
  4. using System.Linq;
  5. using System.Linq.Expressions;
  6. using System.Net;
  7. using System.Reflection;
  8. using System.Security.Cryptography.X509Certificates;
  9. using System.Threading.Tasks;
  10. using Comal.Classes;
  11. using GenHTTP.Api.Content;
  12. using GenHTTP.Api.Infrastructure;
  13. using GenHTTP.Api.Protocol;
  14. using GenHTTP.Api.Routing;
  15. using GenHTTP.Engine;
  16. using GenHTTP.Modules.IO;
  17. using GenHTTP.Modules.IO.Streaming;
  18. using GenHTTP.Modules.Practices;
  19. using InABox.Clients;
  20. using InABox.Core;
  21. using Newtonsoft.Json.Linq;
  22. using PRSServer.Engines;
  23. using RazorEngine;
  24. using RazorEngine.Compilation;
  25. using RazorEngine.Compilation.ReferenceResolver;
  26. using RazorEngine.Configuration;
  27. using RazorEngine.Templating;
  28. using static System.Windows.Forms.VisualStyles.VisualStyleElement.StartPanel;
  29. using Cookie = GenHTTP.Api.Protocol.Cookie;
  30. namespace PRSServer
  31. {
  32. public class WebModel : IDataModel
  33. {
  34. public WebModel(DataModel model, IRequest request, User? user)
  35. {
  36. _dataModel = model;
  37. Request = request;
  38. User = user;
  39. }
  40. public User? User { get; }
  41. private IDataModel _dataModel { get; }
  42. /// <summary>
  43. /// A set of cookies to be used in the event of normal response.
  44. /// </summary>
  45. /// <remarks>
  46. /// Note that these are not used if <see cref="Respond"/> has been called.
  47. /// </remarks>
  48. public Dictionary<string, string> Cookies { get; } = new();
  49. public IRequest Request { get; init; }
  50. public IResponseBuilder? Response { get; private set; }
  51. public IEnumerable<System.Data.DataTable> DefaultTables => throw new NotImplementedException();
  52. public IResponseBuilder Respond()
  53. {
  54. Response = Request.Respond();
  55. return Response;
  56. }
  57. public bool UserCanAccess<T>() where T : ISecurityDescriptor, new()
  58. {
  59. return User != null && Security.IsAllowed<T>(User.ID, User.SecurityGroup.ID);
  60. }
  61. public bool IsLoggedIn()
  62. {
  63. return User != null;
  64. }
  65. public void AddTable(Type type, CoreTable table, bool isdefault = false, string? alias = null)
  66. {
  67. _dataModel.AddTable(type, table, isdefault, alias);
  68. }
  69. public void AddTable<TType>(Filter<TType>? filter, Columns<TType>? columns, bool isdefault = false, string? alias = null,
  70. bool shouldLoad = true)
  71. {
  72. _dataModel.AddTable(filter, columns, isdefault, alias, shouldLoad);
  73. }
  74. public void LinkTable(Type parenttype, string parentcolumn, Type childtype, string childcolumn, string? parentalias = null,
  75. string? childalias = null, bool isLookup = false)
  76. {
  77. _dataModel.LinkTable(parenttype, parentcolumn, childtype, childcolumn, parentalias, childalias);
  78. }
  79. public void LinkTable<TParent, TChild>(Expression<Func<TParent, object>> parent, Expression<Func<TChild, object>> child,
  80. string? parentalias = null, string? childalias = null, bool isLookup = false)
  81. {
  82. _dataModel.LinkTable(parent, child, parentalias, childalias);
  83. }
  84. public void AddChildTable<TParent, TChild>(Expression<Func<TParent, object>> parentcolumn, Expression<Func<TChild, object>> childcolumn,
  85. Filter<TChild>? filter = null, Columns<TChild>? columns = null, bool isdefault = false, string? parentalias = null,
  86. string? childalias = null)
  87. {
  88. _dataModel.AddChildTable(parentcolumn, childcolumn, filter, columns, isdefault, parentalias, childalias);
  89. }
  90. public void AddLookupTable<TSource, TLookup>(Expression<Func<TSource, object>> sourcecolumn, Expression<Func<TLookup, object>> lookupcolumn,
  91. Filter<TLookup>? filter = null, Columns<TLookup>? columns = null, bool isdefault = false, string? sourcealias = null,
  92. string? lookupalias = null)
  93. {
  94. _dataModel.AddLookupTable(sourcecolumn, lookupcolumn, filter, columns, isdefault, sourcealias, lookupalias);
  95. }
  96. public CoreTable GetTable<TType>(string? alias = null)
  97. {
  98. return _dataModel.GetTable<TType>(alias);
  99. }
  100. public void SetTableData(Type type, CoreTable tableData, string? alias = null)
  101. {
  102. _dataModel.SetTableData(type, tableData, alias);
  103. }
  104. public bool HasTable(Type type, string? alias = null)
  105. {
  106. return _dataModel.HasTable(type, alias);
  107. }
  108. public void LoadModel(IEnumerable<string> requiredTables, Dictionary<string, IQueryDef>? requiredQueries = null)
  109. {
  110. _dataModel.LoadModel(requiredTables, requiredQueries);
  111. }
  112. public void LoadModel(IEnumerable<string> requiredTables, params IDataModelQueryDef[] requiredQueries)
  113. {
  114. _dataModel.LoadModel(requiredTables, requiredQueries);
  115. }
  116. public TType[] ExtractValues<TSource, TType>(Expression<Func<TSource, TType>> column, bool distinct = true, string? alias = null)
  117. {
  118. return _dataModel.ExtractValues(column, distinct, alias);
  119. }
  120. public bool RemoveTable<TType>(string? alias = null)
  121. {
  122. return _dataModel.RemoveTable<TType>(alias);
  123. }
  124. public Filter<TType>? GetFilter<TType>(string? alias = null) => _dataModel.GetFilter<TType>(alias);
  125. public Columns<TType>? GetColumns<TType>(string? alias = null) => _dataModel.GetColumns<TType>(alias);
  126. public void SetFilter<TType>(Filter<TType>? filter, string? alias = null) => _dataModel.SetFilter(filter, alias);
  127. public void SetColumns<TType>(Columns<TType>? columns, string? alias = null) => _dataModel.SetColumns(columns, alias);
  128. public void SetIsDefault<TType>(bool isDefault, string? alias = null) => _dataModel.SetIsDefault<TType>(isDefault, alias);
  129. public void SetShouldLoad<TType>(bool shouldLoad, string? alias = null) => _dataModel.SetShouldLoad<TType>(shouldLoad, alias);
  130. }
  131. public class RazorReferenceResolver : IReferenceResolver
  132. {
  133. public IEnumerable<CompilerReference> GetReferences(TypeContext context, IEnumerable<CompilerReference> includeAssemblies = null)
  134. {
  135. foreach(var reference in new UseCurrentAssembliesReferenceResolver().GetReferences(context, includeAssemblies))
  136. {
  137. yield return reference;
  138. }
  139. foreach(var reference in Directory.GetFiles(AppDomain.CurrentDomain.BaseDirectory, "*.dll")
  140. .Where(x => !Path.GetFileName(x).StartsWith("pdfium") && !Path.GetFileName(x).StartsWith("gsdll"))
  141. .Select(x => CompilerReference.From(x)))
  142. {
  143. yield return reference;
  144. }
  145. }
  146. }
  147. public class WebHandler : Handler<WebHandlerProperties>
  148. {
  149. public ulong LoginExpiry; // In seconds
  150. public override void Init(WebHandlerProperties properties)
  151. {
  152. MaxFileSize = properties.MaxFileSize;
  153. LoginExpiry = properties.LoginExpiry;
  154. if (CoreUtils.GetVersion() != "???") CompileAllTemplates();
  155. }
  156. static WebHandler()
  157. {
  158. var config = new TemplateServiceConfiguration();
  159. config.BaseTemplateType = typeof(WebTemplateBase<>);
  160. config.ReferenceResolver = new RazorReferenceResolver();
  161. RazorService = RazorEngineService.Create(config);
  162. }
  163. public int MaxFileSize { get; set; }
  164. private void RunTestDataModel<T>()
  165. where T : Entity, IRemotable, IPersistent, new()
  166. {
  167. Logger.Send(LogType.Information, "", string.Format("Started '{0}'", typeof(T).Name));
  168. var id = new Client<T>().Query(null, new Columns<T>(x => x.ID)).ExtractValues<Guid>("ID").FirstOrDefault();
  169. Logger.Send(LogType.Information, "", string.Format("Using id '{0}'", id));
  170. var autoDataModel = new AutoDataModel<T>(new Filter<T>(x => x.ID).IsEqualTo(id));
  171. autoDataModel.LoadModel(null);
  172. Logger.Send(LogType.Information, "", string.Format("Finished '{0}'", typeof(T).Name));
  173. }
  174. private IResponseBuilder HandleTest(IRequest request)
  175. {
  176. Logger.Send(LogType.Information, "", "Starting tests");
  177. var id = Guid.Parse(request.Query["id"]);
  178. var doc = new Client<Document>().Query(
  179. new Filter<Document>(x => x.ID).IsEqualTo(id),
  180. new Columns<Document>(x => x.Data)
  181. ).Rows[0].ToObject<Document>();
  182. return request.Respond();
  183. }
  184. #region Authentication
  185. private class LoginSession
  186. {
  187. public Guid DatabaseSession { get; set; }
  188. public User User { get; set; }
  189. public bool Valid { get; set; }
  190. public LoginSession(Guid databaseSession, User user, bool valid)
  191. {
  192. DatabaseSession = databaseSession;
  193. User = user;
  194. Valid = valid;
  195. }
  196. }
  197. private static readonly Dictionary<Guid, LoginSession> Sessions = new();
  198. private static bool UserCanEdit<T>(User user) where T : Entity, new()
  199. {
  200. return Security.CanEdit<T>(user.ID, user.SecurityGroup.ID);
  201. }
  202. private LoginSession? GetClientSession(IRequest request)
  203. {
  204. if (!request.Cookies.ContainsKey("SessionID")) return null;
  205. var sessionId = request.Cookies["SessionID"].Value;
  206. if (Guid.TryParse(sessionId, out var guid))
  207. return Sessions.GetValueOrDefault(guid);
  208. return null;
  209. }
  210. /// <summary>
  211. /// Returns a User object based on a session id cookie.
  212. /// </summary>
  213. /// <param name="request"></param>
  214. /// <returns>null if the user is not logged in, otherwise the current user that is logged in</returns>
  215. private User? GetClientUser(IRequest request)
  216. {
  217. var session = GetClientSession(request);
  218. if (session?.Valid == true)
  219. return session.User;
  220. return null;
  221. }
  222. public static Guid LoginUser(User user)
  223. {
  224. var newSessionID = Guid.NewGuid();
  225. Sessions[newSessionID] = new(Guid.Empty, user, true);
  226. return newSessionID;
  227. }
  228. private class ValidateResponse
  229. {
  230. public bool Require2FA { get; set; }
  231. public string? Recipient { get; set; }
  232. }
  233. private class TwoFARequest
  234. {
  235. public string Code { get; set; }
  236. }
  237. private IResponseBuilder Handle2FA(IRequest request)
  238. {
  239. var session = GetClientSession(request);
  240. if(session == null)
  241. {
  242. Logger.Send(LogType.Information, "", "Invalid request for 2FA: no Session ID cookie");
  243. return request.Respond().Status(ResponseStatus.BadRequest);
  244. }
  245. else if(request.Content == null)
  246. {
  247. Logger.Send(LogType.Information, session.User.UserID, "Invalid request for 2FA: no content");
  248. return request.Respond().Status(ResponseStatus.BadRequest);
  249. }
  250. var requestObj = Serialization.Deserialize<TwoFARequest>(request.Content);
  251. if (requestObj == null || requestObj.Code == null)
  252. {
  253. Logger.Send(LogType.Information, session.User.UserID, "Invalid request for 2FA: invalid content");
  254. return request.Respond().Status(ResponseStatus.BadRequest);
  255. }
  256. Logger.Send(LogType.Information, session.User.UserID, $"2FA check for code {requestObj.Code}");
  257. if(Client.Check2FA(requestObj.Code, session.DatabaseSession))
  258. {
  259. Logger.Send(LogType.Information, session.User.UserID, $"2FA check success!");
  260. session.Valid = true;
  261. return request.Respond().Status(ResponseStatus.OK);
  262. }
  263. Logger.Send(LogType.Information, session.User.UserID, $"2FA check failed");
  264. return request.Respond().Status(ResponseStatus.Unauthorized);
  265. }
  266. /// <summary>
  267. /// www.domain.com/login
  268. /// </summary>
  269. /// <param name="request"></param>
  270. /// <returns></returns>
  271. private IResponseBuilder HandleLogin(IRequest request)
  272. {
  273. var obj = JObject.Parse(new StreamReader(request.Content).ReadToEnd());
  274. var username = obj["username"]?.ToString();
  275. var password = obj["password"]?.ToString();
  276. if (username == null || password == null)
  277. {
  278. Logger.Send(LogType.Information, "", "Username or password unspecified");
  279. return request.Respond().Status(ResponseStatus.BadRequest);
  280. }
  281. Logger.Send(LogType.Information, "", string.Format("Request to login with username '{0}'", username));
  282. var validation = Client.Validate(username, password);
  283. switch (validation.Status)
  284. {
  285. case ValidationResult.INVALID:
  286. Logger.Send(LogType.Information, "", "User name or password is incorrect");
  287. return request.Respond().Status(ResponseStatus.Unauthorized);
  288. case ValidationResult.PASSWORD_EXPIRED:
  289. Logger.Send(LogType.Information, "", "Password has expired");
  290. return request.Respond().Status(ResponseStatus.Unauthorized);
  291. }
  292. var require2FA = validation.Status == ValidationResult.REQUIRE_2FA;
  293. var newSessionID = Guid.NewGuid();
  294. var user = new User
  295. {
  296. ID = validation.UserGuid,
  297. UserID = validation.UserID,
  298. };
  299. user.SecurityGroup.ID = validation.SecurityID;
  300. Sessions[newSessionID] = new LoginSession(validation.SessionID, user, !require2FA);
  301. var response = new ValidateResponse
  302. {
  303. Require2FA = require2FA
  304. };
  305. if (require2FA)
  306. {
  307. response.Recipient = validation.Recipient2FA;
  308. Logger.Send(LogType.Information, "", string.Format("Login ({0}) requires 2FA!", user.UserID));
  309. }
  310. else
  311. {
  312. Logger.Send(LogType.Information, "", string.Format("Login ({0}) Success!", user.UserID));
  313. }
  314. var responseString = Serialization.Serialize(response);
  315. return request.Respond()
  316. .Cookie(new Cookie("SessionID", newSessionID.ToString(), LoginExpiry)) // Expires after 30 minutes
  317. .Content(new ResourceContent(Resource.FromString(responseString).Build()))
  318. .Type(new FlexibleContentType(ContentType.ApplicationJson))
  319. .Status(ResponseStatus.OK);
  320. }
  321. #endregion
  322. #region Digital Forms
  323. private IResponseBuilder HandleFormSubmissionResolvedGeneric<TForm, TEntityLink, TEntity>(IRequest request, User user)
  324. where TForm : Entity, IDigitalFormInstance<TEntityLink>, IRemotable, IPersistent, new()
  325. where TEntityLink : IEntityLink<TEntity>
  326. where TEntity : Entity, IRemotable, IPersistent, new()
  327. {
  328. var complete = request.Query.ContainsKey("complete");
  329. Guid formID;
  330. if (!request.Query.TryGetValue("id", out var formIDStr))
  331. {
  332. Logger.Send(LogType.Error, "", "No form id passed");
  333. return request.Respond().Status(ResponseStatus.BadRequest);
  334. } else if(!Guid.TryParse(formIDStr, out formID))
  335. {
  336. Logger.Send(LogType.Error, "", "Invalid GUID format '" + formIDStr + "'");
  337. return request.Respond().Status(ResponseStatus.BadRequest);
  338. }
  339. Logger.Send(LogType.Information, user.UserID, $"Request to {(complete ? "submit" : "save")} form '{formID}'");
  340. if (!Security.CanEdit<TForm>(user.ID, user.SecurityGroup.ID))
  341. {
  342. Logger.Send(LogType.Information, user.UserID, string.Format("User does not have the security rights to edit {0}!", typeof(TForm)));
  343. return request.Respond().Status(ResponseStatus.Forbidden);
  344. }
  345. var formTable = new Client<TForm>().Query(
  346. new Filter<TForm>(x => x.ID).IsEqualTo(formID),
  347. new Columns<TForm>(x => x.ID).Add(x => x.Form.ID).Add(x => x.Parent.ID)
  348. );
  349. if (formTable.Rows.Count == 0)
  350. {
  351. Logger.Send(LogType.Error, "", "Form does not exist");
  352. return request.Respond().Status(ResponseStatus.NotFound);
  353. }
  354. var form = formTable.Rows[0].ToObject<TForm>();
  355. var digitalFormTable = new Client<DigitalForm>().Query(
  356. new Filter<DigitalForm>(x => x.ID).IsEqualTo(form.Form.ID),
  357. new Columns<DigitalForm>(x => x.ID)
  358. );
  359. if (digitalFormTable.Rows.Count == 0)
  360. {
  361. Logger.Send(LogType.Error, "", "Digital form does not exist");
  362. return request.Respond().Status(ResponseStatus.NotFound);
  363. }
  364. var digitalForm = digitalFormTable.Rows[0].ToObject<DigitalForm>();
  365. var json = new StreamReader(request.Content).ReadToEnd();
  366. var values = Serialization.Deserialize<Dictionary<string, object>>(json);
  367. var variables = new Client<DigitalFormVariable>().Query(
  368. new Filter<DigitalFormVariable>(x => x.Form.ID).IsEqualTo(digitalForm.ID),
  369. new Columns<DigitalFormVariable>(x => x.Code).Add(x => x.VariableType).Add(x => x.Parameters)
  370. ).Rows.Select(x => x.ToObject<DigitalFormVariable>()).ToArray();
  371. var entity = new Client<TEntity>().Query(
  372. new Filter<TEntity>(x => x.ID).IsEqualTo(form.Parent.ID)
  373. ).Rows.FirstOrDefault()?.ToObject<TEntity>();
  374. var formData = DigitalForm.GenerateFormData(values, variables, entity);
  375. if (formData == null)
  376. {
  377. Logger.Send(LogType.Error, "", "Not all required fields are present");
  378. return request.Respond().Status(ResponseStatus.BadRequest);
  379. }
  380. form.FormData = formData;
  381. if (complete)
  382. {
  383. form.FormCompleted = DateTime.Now;
  384. form.FormCompletedBy = new UserLink { ID = user.ID };
  385. }
  386. new Client<TForm>().Save(form, $"{(complete ? "Submitted" : "Saved")} by '{user.UserID}' from the web");
  387. if (entity?.IsChanged() == true) new Client<TEntity>().Save(entity, $"Saved by '{user.UserID}' from the web");
  388. Logger.Send(LogType.Information, user.UserID, $"Form '{formID}' {(complete ? "submitted" : "saved")}.");
  389. return request.Respond().Status(ResponseStatus.OK);
  390. }
  391. /// <summary>
  392. /// For urls of the form 'www.domain.com/form_submission/XXXXForm?id=XXXX'
  393. /// </summary>
  394. /// <param name="request"></param>
  395. /// <returns></returns>
  396. private IResponseBuilder HandleFormSubmission(IRequest request)
  397. {
  398. var user = GetClientUser(request);
  399. if (user == null)
  400. {
  401. Logger.Send(LogType.Information, "", "User is not logged in!");
  402. return request.Respond().Status(ResponseStatus.Forbidden);
  403. }
  404. if (request.Content == null)
  405. return request.Respond().Status(ResponseStatus.BadRequest);
  406. if (request.ContentType.KnownType != ContentType.ApplicationJson) return request.Respond().Status(ResponseStatus.UnsupportedMediaType);
  407. // Get EntityForm Type
  408. var remaining = request.Target.GetRemaining();
  409. if (remaining.Parts.Count < 2) return request.Respond().Status(ResponseStatus.NotFound);
  410. var formTypeName = remaining.Parts[1].Value;
  411. var formType = GetPersistentRemotableEntities(formTypeName).FirstOrDefault();
  412. if (formType == null || !formType.IsSubclassOfRawGeneric(typeof(EntityForm<,>))) return request.Respond().Status(ResponseStatus.NotFound);
  413. var entityTypes = formType.GetSuperclassDefinition(typeof(EntityForm<,>)).GetGenericArguments();
  414. var genericMethod = typeof(WebHandler).GetMethod(nameof(HandleFormSubmissionResolvedGeneric), BindingFlags.Instance | BindingFlags.NonPublic);
  415. return genericMethod.MakeGenericMethod(formType, entityTypes[1], entityTypes[0]).Invoke(this, new object[] { request, user }) as
  416. IResponseBuilder;
  417. }
  418. #endregion
  419. #region RazorEngine
  420. /// <summary>
  421. /// Associates a "template.DataModel/template.Slug" to (template source, template Key)
  422. /// </summary>
  423. private static readonly Dictionary<string, Tuple<string, string>> templates = new();
  424. private static int Key;
  425. private static IRazorEngineService RazorService { get; set; }
  426. private void CompileAllTemplates()
  427. {
  428. var templates = new Client<WebTemplate>().Query(
  429. null,
  430. new Columns<WebTemplate>().Add(x => x.DataModel).Add(x => x.Slug).Add(x => x.Template)
  431. );
  432. foreach (var templateRow in templates.Rows)
  433. {
  434. var template = templateRow.ToObject<WebTemplate>();
  435. try
  436. {
  437. Logger.Send(LogType.Information, "",
  438. string.Format("Compiling Template {0}{1}", !string.IsNullOrWhiteSpace(template.DataModel) ? template.DataModel + "/" : "",
  439. template.Slug));
  440. CompileTemplate(template);
  441. }
  442. catch (Exception e)
  443. {
  444. LogTemplateError(e);
  445. }
  446. }
  447. }
  448. private static void LogTemplateError(Exception e)
  449. {
  450. var templateStart = e.Message.IndexOf("The template we tried to compile is: "); // Chop from here
  451. if (templateStart == -1) templateStart = e.Message.IndexOf("------------- START -----------"); // If that doesn't exist, chop from here
  452. if (templateStart == -1) templateStart = e.Message.Length;
  453. Logger.Send(LogType.Error, "", string.Format("Error while compiling or running template: {0}", e.Message.Substring(0, templateStart)));
  454. }
  455. public static void CompileTemplate(WebTemplate template)
  456. {
  457. var templateKey = template.DataModel + "/" + template.Slug;
  458. if (templates.TryGetValue(templateKey, out var cachedTemplate))
  459. {
  460. if (template.Template != cachedTemplate.Item1)
  461. {
  462. var newKey = (Key++).ToString();
  463. RazorService.Compile(template.Template, newKey, typeof(WebModel));
  464. templates[templateKey] = new Tuple<string, string>(template.Template, newKey);
  465. }
  466. }
  467. else
  468. {
  469. var newKey = (Key++).ToString();
  470. RazorService.Compile(template.Template, newKey, typeof(WebModel));
  471. templates[templateKey] = new Tuple<string, string>(template.Template, newKey);
  472. }
  473. }
  474. public static string? RunTemplate(WebTemplate template, object? model = null)
  475. {
  476. try
  477. {
  478. var templateKey = template.DataModel + "/" + template.Slug;
  479. if (templates.ContainsKey(templateKey))
  480. {
  481. var cachedTemplate = templates[templateKey];
  482. if (template.Template != cachedTemplate.Item1)
  483. {
  484. var newKey = (Key++).ToString();
  485. var result = RazorService.RunCompile(template.Template, newKey, typeof(WebModel), model);
  486. templates[templateKey] = new Tuple<string, string>(template.Template, newKey);
  487. return result;
  488. }
  489. else
  490. {
  491. var result = RazorService.Run(cachedTemplate.Item2, typeof(WebModel), model);
  492. return result;
  493. }
  494. }
  495. {
  496. var newKey = (Key++).ToString();
  497. var result = RazorService.RunCompile(template.Template, newKey, typeof(WebModel), model);
  498. templates[templateKey] = new Tuple<string, string>(template.Template, newKey);
  499. return result;
  500. }
  501. }
  502. catch (Exception e)
  503. {
  504. LogTemplateError(e);
  505. return null;
  506. }
  507. }
  508. private WebTemplate GenerateNewPageForDataModel(string dataModel)
  509. {
  510. var html = @"@using PRSServer;
  511. @using Comal.Classes;
  512. @using InABox.Core;
  513. @using InABox.Clients;
  514. @using System.Reflection;
  515. @using System.Text;
  516. @{
  517. Model.LoadModel(
  518. new string[] { ""CompanyInformation"", ""CompanyLogo"", """ + dataModel + @""", ""User"" }
  519. );
  520. }
  521. <!DOCTYPE html>
  522. <html>
  523. <head>
  524. <title>" + dataModel + @"</title>
  525. <meta charset=""utf8"">
  526. <meta name=""viewport"" content=""width = device-width,initial-scale = 1"">
  527. <style>
  528. @(WebDatabaseInterface.GetStylesheet(""DEFAULT"").Style)
  529. </style>
  530. </head>
  531. <body>
  532. <header class=""prs-web_engine-header"">
  533. @{CoreTable companyInformationTable = Model.AsDictionary[typeof(CompanyInformation)];
  534. if(companyInformationTable.Rows.Count > 0){
  535. CompanyInformation companyInformation = companyInformationTable.Rows[0].ToObject<CompanyInformation>();
  536. CoreTable documentTable = Model.AsDictionary[typeof(Document)];
  537. Document logo = null;
  538. foreach(var row in documentTable.Rows){
  539. if((Guid)row[""ID""] == companyInformation.Logo.ID){
  540. logo = row.ToObject<Document>();
  541. }
  542. }
  543. <div class=""left"">
  544. @if(logo != null){
  545. <img src=""data:;base64,@(Convert.ToBase64String(logo.Data))"" class=""prs-web_engine-header_img"" />
  546. }
  547. </div>
  548. <div class=""center"">
  549. <h1>@companyInformation.CompanyName</h1>
  550. </div>
  551. <div class=""right"">
  552. <ul class=""prs-web_engine-header_address"">
  553. <li>@(companyInformation.PostalAddress.Street)</li>
  554. <li>@(companyInformation.PostalAddress.City), @(companyInformation.PostalAddress.State) @(companyInformation.PostalAddress.PostCode)</li>
  555. </ul>
  556. </div>
  557. }
  558. </header>
  559. <main>
  560. <h1>@Model.Name</h1>
  561. @if(WebUtils.UserCanAccess<AutoSecurityDescriptor<" + dataModel + @",CanView<" + dataModel + @">>>(Model)){
  562. <div class=""table_scroll"">
  563. @Raw(WebUtils.BuildHTMLTableFromCoreTable<" + dataModel + @">(Model.AsDictionary[typeof(" + dataModel +
  564. @")],WebUtils.EntityTableColumns.VISIBLE))
  565. </div>
  566. foreach(var item in Model.AsDictionary){
  567. if(item.Key != typeof(" + dataModel + @") && Model.IsChildTable(item.Key.Name) && item.Value.Rows.Count > 0){
  568. @:<br/>
  569. <div class=""table_scroll"">
  570. @Raw(WebUtils.BuildHTMLTableFromCoreTable(item.Key, item.Value, WebUtils.EntityTableColumns.VISIBLE))
  571. </div>
  572. }
  573. }
  574. }
  575. </main>
  576. </body>
  577. </html>";
  578. var template = new WebTemplate();
  579. template.Template = html;
  580. return template;
  581. }
  582. private List<Type>? _persistentRemotable;
  583. private IEnumerable<Type> GetPersistentRemotableEntities(string entityName)
  584. {
  585. _persistentRemotable ??= CoreUtils.TypeList(
  586. e => e.GetInterfaces().Contains(typeof(IRemotable)) &&
  587. e.GetInterfaces().Contains(typeof(IPersistent))).ToList();
  588. return _persistentRemotable.Where(x => x.Name == entityName);
  589. }
  590. private void PrepareDataModel(DataModel model, IRequest request, User? user)
  591. {
  592. var userTable = new CoreTable();
  593. userTable.LoadColumns(typeof(User));
  594. if (user != null)
  595. userTable.LoadRow(user);
  596. model.SetTableData(typeof(User), userTable);
  597. var requestQueryTable = new CoreTable();
  598. requestQueryTable.Columns.Add(new CoreColumn { ColumnName = "Key", DataType = typeof(string) });
  599. requestQueryTable.Columns.Add(new CoreColumn { ColumnName = "Value", DataType = typeof(string) });
  600. foreach (var query in request.Query)
  601. {
  602. var row = requestQueryTable.NewRow();
  603. row["Key"] = query.Key;
  604. row["Value"] = query.Value;
  605. requestQueryTable.Rows.Add(row);
  606. }
  607. model.AddTable(typeof(CoreTable), requestQueryTable, alias: "Queries");
  608. }
  609. private IResponseBuilder GetResponse(WebTemplate template, WebModel model)
  610. {
  611. var compiledHTML = RunTemplate(template, model) ?? "";
  612. if (model.Response != null) return model.Response;
  613. var response = model.Request.Respond()
  614. .Content(compiledHTML)
  615. .Type(new FlexibleContentType(ContentType.TextHtml));
  616. foreach (var (key, value) in model.Cookies)
  617. {
  618. response.Cookie(new Cookie(key, value));
  619. }
  620. return response;
  621. }
  622. /// <summary>
  623. /// Literally exists so that minimising reflection code. Called once entityType has been resolved
  624. /// </summary>
  625. /// <typeparam name="T"></typeparam>
  626. /// <returns></returns>
  627. private IResponseBuilder HandleDataModelWithResolvedEntity<T>(IRequest request, string slug, string dataModelName,
  628. Guid entityId, bool isRoot) where T : Entity, IPersistent, IRemotable, new()
  629. {
  630. var templates = new Client<WebTemplate>().Query(
  631. new Filter<WebTemplate>(x => x.Slug).IsEqualTo(slug)
  632. .And(x => x.DataModel).IsEqualTo(dataModelName)
  633. .And(x => x.RootURL).IsEqualTo(isRoot),
  634. new Columns<WebTemplate>(x => x.Template).Add(x => x.Visible)).Rows;
  635. WebTemplate template;
  636. if (templates.Count == 0)
  637. {
  638. template = GenerateNewPageForDataModel(dataModelName);
  639. Logger.Send(LogType.Information, "ADMIN", "Template generated");
  640. }
  641. else
  642. {
  643. template = templates[0].ToObject<WebTemplate>();
  644. if (!template.Visible)
  645. {
  646. Logger.Send(LogType.Information, "ADMIN", "Template is not public");
  647. return request.Respond().Status(ResponseStatus.NotFound);
  648. }
  649. Logger.Send(LogType.Information, "ADMIN", "Template retrieved");
  650. }
  651. var dataModel = new AutoDataModel<T>(new Filter<T>(x => x.ID).IsEqualTo(entityId));
  652. var user = GetClientUser(request);
  653. PrepareDataModel(dataModel, request, user);
  654. var model = new WebModel(dataModel, request, user);
  655. return GetResponse(template, model);
  656. }
  657. // For requests like 'www.domain.com/v1/slug'
  658. private IResponseBuilder HandleWebTemplate(IRequest request, string slug, bool isRoot = false)
  659. {
  660. var templates = new Client<WebTemplate>().Query(
  661. new Filter<WebTemplate>(x => x.Slug).IsEqualTo(slug)
  662. .And(x => x.DataModel).IsEqualTo("")
  663. .And(x => x.RootURL).IsEqualTo(isRoot),
  664. new Columns<WebTemplate>(x => x.Template).Add(x => x.Visible)).Rows;
  665. WebTemplate template;
  666. if (templates.Count == 0)
  667. {
  668. Logger.Send(LogType.Information, "ADMIN", "Template does not exist");
  669. return request.Respond().Status(ResponseStatus.NotFound);
  670. }
  671. template = templates[0].ToObject<WebTemplate>();
  672. if (!template.Visible)
  673. {
  674. Logger.Send(LogType.Information, "ADMIN", "Template is not public");
  675. return request.Respond().Status(ResponseStatus.NotFound);
  676. }
  677. Logger.Send(LogType.Information, "ADMIN", "Template retrieved");
  678. var dataModel = new EmptyDataModel();
  679. var user = GetClientUser(request);
  680. PrepareDataModel(dataModel, request, user);
  681. var model = new WebModel(dataModel, request, user);
  682. return GetResponse(template, model);
  683. }
  684. // For requests like 'www.domain.com/v1/*'
  685. private IResponseBuilder HandleDataModel(IRequest request, IList<string> endpoint, bool isRoot = false)
  686. {
  687. if (endpoint.Count == 0)
  688. return HandleUnknown(request);
  689. if (endpoint.Count == 1) return HandleWebTemplate(request, endpoint[0], isRoot);
  690. // Matches the DataModel entry in WebTemplate
  691. var dataModelName = endpoint[0];
  692. // Matches the Slug entry in WebTemplate
  693. var slug = endpoint[1];
  694. var entityId = request.Query.GetValueOrDefault("id");
  695. if (entityId == null)
  696. {
  697. Logger.Send(LogType.Error, "", "No entity id passed");
  698. return request.Respond().Status(ResponseStatus.BadRequest);
  699. }
  700. if(!Guid.TryParse(entityId, out var guid))
  701. {
  702. Logger.Send(LogType.Error, "", "Invalid GUID format '" + entityId + "'");
  703. return request.Respond().Status(ResponseStatus.BadRequest);
  704. }
  705. Logger.Send(LogType.Information, "ADMIN",
  706. "Request to Datamodel '" + dataModelName + "' with slug '" + slug + "' and entity id '" + entityId + "'");
  707. var entityTypes = GetPersistentRemotableEntities(dataModelName);
  708. if (entityTypes.Count() == 0)
  709. {
  710. Logger.Send(LogType.Error, "", "No entity named '" + dataModelName + "'");
  711. return request.Respond().Status(ResponseStatus.NotFound);
  712. }
  713. var entityType = entityTypes.First();
  714. var method = typeof(WebHandler).GetMethods(BindingFlags.NonPublic | BindingFlags.Instance)
  715. .Where(x => x.Name == nameof(HandleDataModelWithResolvedEntity))
  716. .FirstOrDefault()!.MakeGenericMethod(entityType);
  717. return (method.Invoke(this, new object[] { request, slug, dataModelName, guid, isRoot }) as IResponseBuilder)!;
  718. }
  719. #endregion
  720. #region Edit
  721. public static Dictionary<string, object> SerializeEntityForEditing(Type entityType, Entity entity)
  722. {
  723. var data = new Dictionary<string, object>();
  724. foreach (var property in DatabaseSchema.Properties(entityType))
  725. {
  726. var editor = EditorUtils.GetPropertyEditor(entityType, property);
  727. if (editor != null && !(editor is NullEditor) && editor.Editable != Editable.Hidden)
  728. {
  729. if (editor is LookupEditor)
  730. {
  731. data[property.Name + "$ID"] = CoreUtils.GetPropertyValue(entity, property.Name);
  732. }
  733. else
  734. {
  735. data[property.Name] = CoreUtils.GetPropertyValue(entity, property.Name);
  736. }
  737. }
  738. }
  739. data["ID"] = entity.ID;
  740. return data;
  741. }
  742. public static T DeserializeEditedEntity<T>(Dictionary<string, object> data) where T : Entity, IRemotable, IPersistent, new()
  743. {
  744. var id = data.GetValueOrDefault("ID");
  745. T entity;
  746. if (id != null && id is string idStr && Guid.TryParse(idStr, out var guid) && guid != Guid.Empty)
  747. entity = new Client<T>().Load(new Filter<T>(x => x.ID).IsEqualTo(guid)).FirstOrDefault() ?? new T();
  748. else
  749. entity = new T();
  750. foreach (var property in DatabaseSchema.Properties(typeof(T)))
  751. {
  752. var editor = EditorUtils.GetPropertyEditor(typeof(T), property);
  753. var value = editor is LookupEditor ?
  754. (data.GetValueOrDefault(property.Name + "$ID") ?? data.GetValueOrDefault(property.Name)) :
  755. data.GetValueOrDefault(property.Name);
  756. if (value != null)
  757. {
  758. CoreUtils.SetPropertyValue(entity, property.Name, CoreUtils.ChangeType(value, property.PropertyType));
  759. }
  760. }
  761. return entity;
  762. }
  763. /// <summary>
  764. /// www.domain.com/save/XXXX
  765. /// A POST request to this URL with JSON data representing an entity saves the entity to the database.
  766. /// </summary>
  767. private IResponseBuilder HandleSave(IRequest request)
  768. {
  769. var endpoint = request.Target.GetRemaining();
  770. Logger.Send(LogType.Information, "ADMIN", "Request to endpoint '" + endpoint + "'");
  771. if (endpoint.Parts.Count < 2)
  772. return request.Respond().Status(ResponseStatus.NotFound);
  773. if (request.Content == null)
  774. return request.Respond().Status(ResponseStatus.BadRequest);
  775. if (request.ContentType.KnownType != ContentType.ApplicationJson) return request.Respond().Status(ResponseStatus.UnsupportedMediaType);
  776. var user = GetClientUser(request);
  777. if (user == null)
  778. {
  779. Logger.Send(LogType.Information, "", "User is not logged in!");
  780. return request.Respond().Status(ResponseStatus.Forbidden);
  781. }
  782. var entityName = endpoint.Parts[1].Value;
  783. var entityType = GetPersistentRemotableEntities(entityName).FirstOrDefault();
  784. if (entityType == null)
  785. {
  786. Logger.Send(LogType.Information, "", string.Format("Entity {0} does not exist", entityName));
  787. return request.Respond().Status(ResponseStatus.NotFound);
  788. }
  789. var securityMethod = typeof(WebHandler).GetMethods(BindingFlags.NonPublic | BindingFlags.Static)
  790. .Where(x => x.Name == "UserCanEdit").FirstOrDefault()?.MakeGenericMethod(entityType);
  791. if ((bool?)securityMethod?.Invoke(this, new object[] { user }) != true)
  792. {
  793. Logger.Send(LogType.Information, "", string.Format("User does not have the security rights to edit {0}!", entityName));
  794. return request.Respond().Status(ResponseStatus.Forbidden);
  795. }
  796. var dictionary = Serialization.Deserialize<Dictionary<string, object>>(request.Content);
  797. var entity = typeof(WebHandler).GetMethod("DeserializeEditedEntity", BindingFlags.Static | BindingFlags.Public)
  798. .MakeGenericMethod(entityType).Invoke(this, new object[] { dictionary }) as Entity;
  799. var client = ClientFactory.CreateClient(entityType);
  800. client.Save(entity, string.Format("Edited by {0} from the web", user.UserID));
  801. Logger.Send(LogType.Information, user.UserID, string.Format("{0} saved with ID '{1}'", entityName, entity.ID));
  802. var returnJSON = Serialization.Serialize(SerializeEntityForEditing(entityType, entity));
  803. return request.Respond()
  804. .Content(new ResourceContent(Resource.FromString(returnJSON).Build()))
  805. .Type(FlexibleContentType.Get(ContentType.ApplicationJson))
  806. .Status(ResponseStatus.OK);
  807. }
  808. #endregion
  809. #region Documents
  810. private class DocumentData
  811. {
  812. public DocumentData(byte[] data, string fileName, bool priv)
  813. {
  814. Data = data;
  815. FileName = fileName;
  816. Private = priv;
  817. }
  818. public byte[] Data { get; }
  819. public string FileName { get; }
  820. public bool Private { get; }
  821. }
  822. private enum DocumentError
  823. {
  824. NOT_FOUND,
  825. TOO_LARGE
  826. }
  827. private DocumentData? GetDocumentByID(Guid guid)
  828. {
  829. var documentTable = new Client<Document>().Query(
  830. new Filter<Document>(x => x.ID).IsEqualTo(guid),
  831. new Columns<Document>(x => x.Data).Add(x => x.FileName).Add(x => x.Private)
  832. );
  833. if (documentTable.Rows.Count == 0) return null;
  834. var row = documentTable.Rows[0];
  835. return new DocumentData(row["Data"] as byte[], row["FileName"] as string, (bool)row["Private"]);
  836. }
  837. private IResponseBuilder HandleDocument(IRequest request)
  838. {
  839. var user = GetClientUser(request);
  840. var canViewPrivate = user != null && Security.CanView<Document>(user.ID, user.SecurityGroup.ID);
  841. var documentId = request.Query.GetValueOrDefault("id");
  842. DocumentData? document;
  843. if (documentId != null)
  844. {
  845. Guid guid;
  846. try
  847. {
  848. guid = Guid.Parse(documentId);
  849. }
  850. catch (FormatException e)
  851. {
  852. Logger.Send(LogType.Error, "", "Invalid GUID format '" + documentId + "'");
  853. return request.Respond().Status(ResponseStatus.BadRequest);
  854. }
  855. Logger.Send(LogType.Error, "", string.Format("Request to document with id '{0}'", documentId));
  856. document = GetDocumentByID(guid);
  857. }
  858. else
  859. {
  860. Logger.Send(LogType.Error, "", "No document id passed");
  861. return request.Respond().Status(ResponseStatus.BadRequest);
  862. }
  863. if (document == null) return request.Respond().Status(ResponseStatus.NotFound);
  864. if (document.Private && !canViewPrivate)
  865. {
  866. Logger.Send(LogType.Error, "", "User is not authorised to access this resource");
  867. return request.Respond().Status(ResponseStatus.Forbidden);
  868. }
  869. var extension = Path.GetExtension(document.FileName).ToLower();
  870. if (request.Query.GetValueOrDefault("to_img") != null && extension == ".pdf")
  871. {
  872. var imgs = WebUtils.RenderPDFToImages(document.Data);
  873. var responseString = Serialization.Serialize(imgs);
  874. return request.Respond()
  875. .Content(new ResourceContent(Resource.FromString(responseString).Build()))
  876. .Type(new FlexibleContentType(ContentType.ImageJpg));
  877. }
  878. var contentType = extension switch
  879. {
  880. ".pdf" => ContentType.TextPlain,
  881. ".png" => ContentType.ImagePng,
  882. _ => ContentType.TextPlain
  883. };
  884. return request.Respond()
  885. .Content(new ByteArrayResource(document.Data, document.FileName, FlexibleContentType.Get(contentType), null))
  886. .Type(new FlexibleContentType(contentType));
  887. }
  888. #endregion
  889. #region Root Handlers
  890. private IResponseBuilder HandleGet(IRequest request)
  891. {
  892. var endpoint = request.Target.GetRemaining();
  893. if (endpoint.Parts.Count == 0)
  894. {
  895. Logger.Send(LogType.Error, "", $"Request to endpoint '{endpoint}' from IP {request.Client.IPAddress} does not exist!");
  896. return request.Respond().Status(ResponseStatus.NotFound);
  897. }
  898. Logger.Send(LogType.Information, "ADMIN", "Request to endpoint '" + endpoint + "'");
  899. var endpointNamespace = endpoint.Parts[0].Value;
  900. var responseBuilder = endpointNamespace switch
  901. {
  902. "v1" => HandleDataModel(request, endpoint.Parts.Skip(1).Select(x => x.Value).ToList(), false),
  903. "document" => HandleDocument(request),
  904. "test" => HandleTest(request),
  905. _ => HandleDataModel(request, endpoint.Parts.Select(x => x.Value).ToList(), true)
  906. };
  907. if(responseBuilder == null)
  908. {
  909. Logger.Send(LogType.Error, "", $"Request to endpoint '{endpoint}' from IP {request.Client.IPAddress} does not exist!");
  910. return request.Respond().Status(ResponseStatus.NotFound);
  911. }
  912. if (request.Cookies.TryGetValue("SessionID", out var sessionID))
  913. try
  914. {
  915. var guid = Guid.Parse(sessionID.Value);
  916. if (Sessions.ContainsKey(guid)) responseBuilder.Cookie(new Cookie("SessionID", sessionID.Value, LoginExpiry));
  917. }
  918. catch (FormatException)
  919. {
  920. }
  921. return responseBuilder;
  922. }
  923. private IResponseBuilder HandleUnknown(IRequest request)
  924. {
  925. Logger.Send(LogType.Error, "", $"{request.Method.RawMethod} request to endpoint '{request.Target.Path}' from IP {request.Client.IPAddress} does not exist!");
  926. return request.Respond().Status(ResponseStatus.NotFound);
  927. }
  928. public override ValueTask<IResponse?> HandleAsync(IRequest request)
  929. {
  930. try
  931. {
  932. return request.Method.KnownMethod switch
  933. {
  934. RequestMethod.GET or RequestMethod.HEAD => new ValueTask<IResponse?>(HandleGet(request).Build()),
  935. RequestMethod.POST => new ValueTask<IResponse?>((request.Target.Current?.Value switch
  936. {
  937. "login" => HandleLogin(request),
  938. "2fa" => Handle2FA(request),
  939. "save" => HandleSave(request),
  940. "form_submission" => HandleFormSubmission(request),
  941. "v1" => HandleDataModel(request, request.Target.GetRemaining().Parts.Skip(1).Select(x => x.Value).ToList(), false),
  942. _ => HandleDataModel(request, request.Target.GetRemaining().Parts.Select(x => x.Value).ToList(), true)
  943. }).Build()),
  944. _ => new ValueTask<IResponse?>(request.Respond().Status(ResponseStatus.MethodNotAllowed).Header("Allow", "GET, HEAD").Build())
  945. };
  946. }
  947. catch (Exception eListen)
  948. {
  949. Logger.Send(LogType.Error, ClientFactory.UserID, eListen.Message);
  950. return new ValueTask<IResponse?>(request.Respond().Status(ResponseStatus.InternalServerError).Build());
  951. }
  952. }
  953. #endregion
  954. }
  955. public class WebHandlerProperties
  956. {
  957. public int MaxFileSize { get; }
  958. public ulong LoginExpiry { get; }
  959. /// <summary>
  960. /// Create a new web listener
  961. /// </summary>
  962. /// <param name="maxFileSize">The maximum size in megabytes for file transfer</param>
  963. /// <param name="loginExpiry">The time, in seconds, for how long login sessions should last</param>
  964. public WebHandlerProperties(int maxFileSize, ulong loginExpiry)
  965. {
  966. MaxFileSize = maxFileSize;
  967. LoginExpiry = loginExpiry;
  968. }
  969. }
  970. public class WebListener : Listener<WebHandler, WebHandlerProperties>
  971. {
  972. public WebListener(WebHandlerProperties properties): base(properties) { }
  973. }
  974. }