// Copyright (C) 2024, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using System; using System.Collections.Generic; using System.Linq; using System.Threading; using Duplicati.Library.Interface; namespace Duplicati.Server.WebServer.RESTMethods { public class RemoteOperation : IRESTMethodGET, IRESTMethodPOST { private void LocateDbUri(string uri, RequestInfo info) { var path = Library.Main.DatabaseLocator.GetDatabasePath(uri, null, false, false); info.OutputOK(new { Exists = !string.IsNullOrWhiteSpace(path), Path = path }); } private Dictionary ParseUrlOptions(Library.Utility.Uri uri) { var qp = uri.QueryParameters; var opts = Runner.GetCommonOptions(); foreach (var k in qp.Keys.Cast()) opts[k] = qp[k]; return opts; } private IEnumerable ConfigureModules(IDictionary opts) { // TODO: This works because the generic modules are implemented // with pre .NetCore logic, using static methods // The modules are created to allow multipe dispose, // which violates the .Net patterns var modules = (from n in Library.DynamicLoader.GenericLoader.Modules where n is Library.Interface.IConnectionModule select n).ToArray(); foreach (var n in modules) n.Configure(opts); return modules; } private class TupleDisposeWrapper : IDisposable { public IBackend Backend { get; set; } public IEnumerable Modules { get; set; } public void Dispose() { Backend.Dispose(); DisposeModules(); } public void DisposeModules() { foreach (var n in Modules) if (n is IDisposable disposable) disposable.Dispose(); } } private TupleDisposeWrapper GetBackend(string url) { var uri = new Library.Utility.Uri(url); var opts = ParseUrlOptions(uri); var modules = ConfigureModules(opts); var backend = Duplicati.Library.DynamicLoader.BackendLoader.GetBackend(url, new Dictionary()); return new TupleDisposeWrapper() { Backend = backend, Modules = modules }; } private void CreateFolder(string uri, RequestInfo info) { using(var b = Duplicati.Library.DynamicLoader.BackendLoader.GetBackend(uri, new Dictionary())) b.CreateFolder(); info.OutputOK(); } private void UploadFile(string uri, RequestInfo info) { var data = info.Request.QueryString["data"].Value; var remotename = info.Request.QueryString["filename"].Value; using(var ms = new System.IO.MemoryStream()) using(var b = GetBackend(uri)) { using(var tf = new Library.Utility.TempFile()) { System.IO.File.WriteAllText(tf, data); b.Backend.PutAsync(remotename, tf, CancellationToken.None).Wait(); } } info.OutputOK(); } private void ListFolder(string uri, RequestInfo info) { using(var b = GetBackend(uri)) info.OutputOK(b.Backend.List()); } private void TestConnection(string url, RequestInfo info) { bool autoCreate = info.Request.Param.Contains("autocreate") ? Library.Utility.Utility.ParseBool(info.Request.Param["autocreate"].Value, false) : false; TupleDisposeWrapper wrapper = null; try { wrapper = GetBackend(url); using (var b = wrapper.Backend) { try { b.Test(); } catch (FolderMissingException) { if (!autoCreate) throw; b.CreateFolder(); b.Test(); } info.OutputOK(); } } catch (Duplicati.Library.Interface.FolderMissingException) { if (!autoCreate) { info.ReportServerError("missing-folder"); } else { info.ReportServerError("error-creating-folder"); } } catch (Duplicati.Library.Utility.SslCertificateValidator.InvalidCertificateException icex) { if (string.IsNullOrWhiteSpace(icex.Certificate)) info.ReportServerError(icex.Message); else info.ReportServerError("incorrect-cert:" + icex.Certificate); } catch (Duplicati.Library.Utility.HostKeyException hex) { if (string.IsNullOrWhiteSpace(hex.ReportedHostKey)) info.ReportServerError(hex.Message); else { info.ReportServerError(string.Format( @"incorrect-host-key:""{0}"", accepted-host-key:""{1}""", hex.ReportedHostKey, hex.AcceptedHostKey )); } } finally { if (wrapper != null) wrapper.DisposeModules(); } } public void GET(string key, RequestInfo info) { var parts = (key ?? "").Split(new char[] { '/' }, 2); if (parts.Length <= 1) { info.ReportClientError("No url or operation supplied", System.Net.HttpStatusCode.BadRequest); return; } var url = Library.Utility.Uri.UrlDecode(parts.First()); var operation = parts.Last().ToLowerInvariant(); switch (operation) { case "dbpath": LocateDbUri(url, info); return; case "list": ListFolder(url, info); return; case "create": CreateFolder(url, info); return; case "test": TestConnection(url, info); return; default: info.ReportClientError("No such method", System.Net.HttpStatusCode.BadRequest); return; } } public void POST(string key, RequestInfo info) { string url; using(var sr = new System.IO.StreamReader(info.Request.Body, System.Text.Encoding.UTF8, true)) url = sr.ReadToEnd(); switch (key) { case "dbpath": LocateDbUri(url, info); return; case "list": ListFolder(url, info); return; case "create": CreateFolder(url, info); return; case "put": UploadFile(url, info); return; case "test": TestConnection(url, info); return; default: info.ReportClientError("No such method", System.Net.HttpStatusCode.BadRequest); return; } } } }