duplicati/Duplicati/Library/Backend/OneDrive/SharePointV2.cs

// Copyright (C) 2025, 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 Duplicati.Library.Backend.MicrosoftGraph;
using Duplicati.Library.Interface;

namespace Duplicati.Library.Backend
{
    public class SharePointV2 : MicrosoftGraphBackend
    {
        private const string SITE_ID_OPTION = "site-id";
        private const string PROTOCOL_KEY = "sharepoint";

        private readonly Task<string> drivePath;
        private string siteId;

        public SharePointV2()
        {
            // Constructor needed for dynamic loading to find it
            drivePath = null!;
            siteId = null!;
        }

        public SharePointV2(string url, Dictionary<string, string?> options)
            : base(url, PROTOCOL_KEY, options)
        {
            // Check to see if a site ID was explicitly provided
            var siteIdOption = options.GetValueOrDefault(SITE_ID_OPTION);
            if (!string.IsNullOrWhiteSpace(siteIdOption))
                siteId = siteIdOption;
            else
                throw new UserInformationException(Strings.SharePointV2.MissingSiteId, "SharePointMissingSiteId");

            drivePath = Task.FromResult(string.Format("/sites/{0}/drive", siteId));
        }

        public override string ProtocolKey => PROTOCOL_KEY;

        public override string DisplayName => Strings.SharePointV2.DisplayName;

        protected override Task<string> GetDrivePath(CancellationToken cancelToken) => drivePath;

        protected override DescriptionTemplateDelegate DescriptionTemplate => Strings.SharePointV2.Description;

        protected override IList<ICommandLineArgument> AdditionalSupportedCommands => [
            new CommandLineArgument(SITE_ID_OPTION, CommandLineArgument.ArgumentType.String, Strings.SharePointV2.SiteIdShort, Strings.SharePointV2.SiteIdLong),
        ];

        /// <summary>
        /// This method takes an input URL, which could be either in the format that the old SharePoint backend accepted or
        /// just the host and path (effectively, just the path) that the graph base backend expects,
        /// and converts it to just the local path within the drive.
        /// 
        /// At the same time, if the given URL is in the form of a full SharePoint site URL, then it also determines the site-id and stores it.
        /// </summary>
        /// <param name="url">Input URL</param>
        /// <returns>Path within the drive</returns>
        protected override async Task<string> GetRootPathFromUrlAsync(string url, CancellationToken cancelToken)
        {
            var uri = new Uri(url);

            // If the user gave a URL like "https://{tenant}.sharepoint.com/path" in the UI,
            // it might appear here as "sharepoint://https://{tenant}.sharepoint.com/path".
            // If that's the case, the URIs Host will be https, and we should create a new URI without it.
            if (string.Equals(uri.Host, "https", StringComparison.OrdinalIgnoreCase) || string.Equals(uri.Host, "http", StringComparison.OrdinalIgnoreCase))
            {
                // LocalPath will already be prefixed by "//", due to the https:// part.
                uri = new Uri(string.Format("{0}:{1}", uri.Scheme, uri.LocalPath));
            }

            var site = await GetSharePointSite(uri, cancelToken).ConfigureAwait(false);
            if (site != null)
            {
                // Get the web URL of the site's main drive
                try
                {
                    var drive = await Utility.Utility.WithTimeout(m_timeouts.ShortTimeout, cancelToken, ct => this.GetAsync<Drive>(string.Format("{0}/sites/{1}/drive", this.ApiVersion, site.Id), ct)).ConfigureAwait(false);

                    if (drive != null && !string.IsNullOrEmpty(drive.WebUrl) && !string.IsNullOrWhiteSpace(site.Id))
                    {
                        siteId = site.Id;
                        var driveWebUrl = new Uri(drive.WebUrl);

                        // Make sure to replace any "//" in the original path with "/", so the substrings line up.
                        return uri.LocalPath.Replace("//", "/").Substring(driveWebUrl.LocalPath.Length);
                    }
                }
                catch (MicrosoftGraphException)
                {
                    // Couldn't get the drive info, so assume the URL we were given isn't actually a full SharePoint site.
                }
            }

            return await base.GetRootPathFromUrlAsync(url, cancelToken).ConfigureAwait(false);
        }

        private async Task<SharePointSite?> GetSharePointSite(Uri url, CancellationToken cancelToken)
        {
            var uri = new UriBuilder(url);

            // We can get a SharePoint site's info by querying /v1.0/sites/{hostname}:{siteWebPath}.
            // Since this full URL likely has the web path as some subpart of it, we check against each subpath to see if that is a site,
            // and if it is, we record the site ID.
            string requestBase = string.Format("{0}/sites/{1}", this.ApiVersion, uri.Host);

            // Just like the original SharePoint backend, use the "//" as a hint at where the site might be
            int siteHint = uri.Path.IndexOf("//", StringComparison.Ordinal);
            if (siteHint >= 0)
            {
                try
                {
                    var request = string.Format("{0}:/{1}", requestBase, uri.Path.Substring(0, siteHint));
                    return await Utility.Utility.WithTimeout(m_timeouts.ShortTimeout, cancelToken, ct => this.GetAsync<SharePointSite>(request, ct)).ConfigureAwait(false);
                }
                catch (MicrosoftGraphException)
                {
                    // This isn't the right path
                }
            }

            string[] pathPieces = uri.Path.Split(new[] { Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar }, StringSplitOptions.RemoveEmptyEntries);
            for (int i = pathPieces.Length; i > 0; i--)
            {
                try
                {
                    string request = string.Format("{0}:/{1}", requestBase, string.Join("/", pathPieces.Take(i)));
                    return await Utility.Utility.WithTimeout(m_timeouts.ShortTimeout, cancelToken, ct => this.GetAsync<SharePointSite>(request, ct)).ConfigureAwait(false);
                }
                catch (MicrosoftGraphException)
                {
                    // This isn't the right path
                }
            }

            // Couldn't find the site
            return null;
        }
    }
}