Codeunit 9760 Dotnet SFTP Client

App
System Application
Namespace
System.SFTPClient
Versions
28

Procedures, 17

Versions171819202122232425262728

Source2829

Source in 29

src/System Application/App/SFTP Client/src/DotnetSFTPClient.Codeunit.al257 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------
// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License. See License.txt in the project root for license information.
// ------------------------------------------------------------------------------------------------

namespace System.SFTPClient;

using System;

codeunit 9760 "Dotnet SFTP Client" implements "ISFTP Client"
{
    Access = Internal;
    InherentEntitlements = X;
    InherentPermissions = X;

    var
        [WithEvents]
        RenciSFTPClient: DotNet RenciSftpClient;
        FingerprintsSHA256: List of [Text];
        ServerFingerprintSHA256: Text;
        LastOperationSuccessful: Boolean;
        TrustedServer: Boolean;

    procedure Disconnect()
    begin
        RenciSFTPClient.Disconnect();
    end;

    procedure IsConnected(): Boolean
    begin
        exit(RenciSFTPClient.IsConnected());
    end;

    procedure Exists(Path: Text; var ExistResult: Boolean): Boolean
    begin
        LastOperationSuccessful := TryExists(Path, ExistResult);
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure TryExists(Path: Text; var ExistResult: Boolean)
    begin
        ExistResult := RenciSFTPClient.Exists(Path);
    end;

    procedure Delete(Path: Text): Boolean
    begin
        LastOperationSuccessful := InternalDelete(Path);
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalDelete(Path: Text)
    begin
        RenciSFTPClient.Delete(Path);
    end;

    procedure WorkingDirectory(var Result: Text): Boolean
    begin
        LastOperationSuccessful := InternalWorkingDirectory(Result);
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalWorkingDirectory(var Result: Text)
    begin
        Result := RenciSFTPClient.WorkingDirectory;
    end;

    [NonDebuggable]
    procedure SftpClient(Host: Text; Port: Integer; UserName: Text; Password: SecretText): Boolean
    begin
        RenciSFTPClient := RenciSftpClient.SftpClient(Host, Port, UserName, Password.Unwrap());
        LastOperationSuccessful := InternalConnect();
        exit(LastOperationSuccessful);
    end;

    [NonDebuggable]
    procedure SftpClient(Host: Text; Port: Integer; UserName: Text; PrivateKey: InStream): Boolean
    var
        EmptyPassphrase: SecretText;
    begin
        exit(SftpClient(Host, Port, UserName, PrivateKey, EmptyPassphrase));
    end;

    [NonDebuggable]
    procedure SftpClient(HostName: Text; Port: Integer; Username: Text; PrivateKey: InStream; Passphrase: SecretText): Boolean
    var
        PrivateKeyFile: DotNet RenciPrivateKeyFile;
        Arr: DotNet Array;
    begin
        PrivateKeyFile := PrivateKeyFile.PrivateKeyFile(PrivateKey, Passphrase.Unwrap());
        Arr := Arr.CreateInstance(GetDotNetType(PrivateKeyFile), 1);
        Arr.SetValue(PrivateKeyFile, 0);
        RenciSftpClient := RenciSftpClient.SftpClient(HostName, Port, Username, Arr);
        LastOperationSuccessful := InternalConnect();
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalConnect()
    begin
        RenciSFTPClient.Connect();
    end;

    procedure ListDirectory(Path: Text; var Result: List of [Interface "ISFTP File"]): Boolean
    var
        IEnumerable: DotNet IEnumerable;
        RenciISftpFile: DotNet "RenciISftpFile";
    begin
        LastOperationSuccessful := InternalListDirectory(Path, IEnumerable);
        if not LastOperationSuccessful then
            exit(false);
        foreach RenciISftpFile in IEnumerable do
            Result.Add(GetAlISFTPFile(RenciISftpFile));
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalListDirectory(Path: Text; var IEnumerable: DotNet IEnumerable)
    begin
        IEnumerable := RenciSFTPClient.ListDirectory(Path);
    end;

    local procedure GetAlISFTPFile(RenciISftpFile: DotNet "RenciISftpFile"): Interface "ISFTP File"
    var
        Result: Codeunit "Dotnet SFTP File";
    begin
        Result.SetFile(RenciISftpFile);
        exit(Result);
    end;

    [NonDebuggable]
    procedure ReadAllBytes(Path: Text; var Bytes: Dotnet Array): Boolean
    begin
        LastOperationSuccessful := InternalReadAllBytes(Path, Bytes);
        exit(LastOperationSuccessful);
    end;

    [NonDebuggable]
    [TryFunction]
    local procedure InternalReadAllBytes(Path: Text; var Bytes: Dotnet Array)
    begin
        Bytes := RenciSFTPClient.ReadAllBytes(Path);
    end;

    [NonDebuggable]
    procedure WriteAllBytes(Path: Text; Bytes: Dotnet Array): Boolean
    begin
        LastOperationSuccessful := InternalWriteAllBytes(Path, Bytes);
        exit(LastOperationSuccessful);
    end;

    [NonDebuggable]
    [TryFunction]
    local procedure InternalWriteAllBytes(Path: Text; Bytes: Dotnet Array)
    begin
        RenciSFTPClient.WriteAllBytes(Path, Bytes);
    end;

    procedure Get(Path: Text; var Result: Interface "ISFTP File"): Boolean
    var
        DotnetImplementationResult: Codeunit "Dotnet SFTP File";
    begin
        LastOperationSuccessful := InternalGetFile(Path, DotnetImplementationResult);
        if not LastOperationSuccessful then
            exit(false);
        Result := DotnetImplementationResult;
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalGetFile(Path: Text; var Result: Codeunit "Dotnet SFTP File")
    begin
        Result.SetFile(RenciSFTPClient.Get(Path));
    end;

    procedure GetOperationException(var ExceptionType: Enum "SFTP Exception Type"; var ExceptionMessage: Text; var ServerFingerprintSHA256Param: Text)
    var
        SocketException: DotNet SocketException;
        InvalidOperationException: DotNet InvalidOperationException;
        SshConnectionException: DotNet SshConnectionException;
        SshAuthenticationException: DotNet SshAuthenticationException;
        SftpPathNotFoundException: DotNet SftpPathNotFoundException;
        OuterException: DotNet Exception;
        BaseException: Dotnet Exception;
        BaseExceptionType: DotNet Type;
    begin
        ExceptionType := ExceptionType::None;
        ServerFingerprintSHA256Param := '';
        if LastOperationSuccessful then
            exit;
        ServerFingerprintSHA256Param := ServerFingerprintSHA256;
        OuterException := GetLastErrorObject();
        BaseException := OuterException.GetBaseException();
        BaseExceptionType := BaseException.GetType();
        ExceptionMessage := BaseException.Message;
        case true of
            BaseExceptionType.Equals(GetDotNetType(SocketException)):
                ExceptionType := ExceptionType::"Socket Exception";
            BaseExceptionType.Equals(GetDotNetType(InvalidOperationException)):
                ExceptionType := ExceptionType::"Invalid Operation Exception";
            BaseExceptionType.Equals(GetDotNetType(SshConnectionException)):
                if not TrustedServer then
                    ExceptionType := ExceptionType::"Untrusted Server Exception"
                else
                    ExceptionType := ExceptionType::"SSH Connection Exception";
            BaseExceptionType.Equals(GetDotNetType(SshAuthenticationException)):
                ExceptionType := ExceptionType::"SSH Authentication Exception";
            BaseExceptionType.Equals(GetDotNetType(SftpPathNotFoundException)):
                ExceptionType := ExceptionType::"SFTP Path Not Found Exception";
            else
                ExceptionType := ExceptionType::"Generic Exception";
        end;
    end;

    procedure SetWorkingDirectory(Path: Text): Boolean
    begin
        LastOperationSuccessful := InternalSetWorkingDirectory(Path);
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalSetWorkingDirectory(Path: Text)
    begin
        RenciSFTPClient.ChangeDirectory(Path);
    end;

    procedure CreateDirectory(Path: Text): Boolean
    begin
        LastOperationSuccessful := InternalCreateDirectory(Path);
        exit(LastOperationSuccessful);
    end;

    [TryFunction]
    local procedure InternalCreateDirectory(Path: Text)
    begin
        RenciSFTPClient.CreateDirectory(Path);
    end;

    trigger RenciSFTPClient::HostKeyReceived(sender: Variant; e: DotNet RenciHostKeyEventArgs)
    begin
        TrustedServer := false;
        e.CanTrust := false;
        ServerFingerprintSHA256 := e.FingerPrintSHA256;
        if FingerprintsSHA256.Contains(ServerFingerprintSHA256) then begin
            e.CanTrust := true;
            TrustedServer := true;
            exit;
        end;
    end;

    procedure SetSHA256Fingerprints(Fingerprints: List of [Text])
    begin
        FingerprintsSHA256 := Fingerprints;
    end;
}