NetEbics下載 - NetEbics源代碼下載

重要的

該存儲庫已移至https://codeberg.org/hohlerde/netebics

網絡 - .NET核心EBICS客戶端庫

這是一個客戶庫，用於實施EBICS協議用於業務在線銀行業務。

該庫是使用.NET Core 2.X用C＃（7.2）編寫的，並在Linux/Windows上使用私有/公共密鑰（PEM文件）進行了測試。

Netebics是Alpha軟件，不應用於生產。 API/破壞變化很可能。

限制

使用證書的使用已準備好但尚未完全實施。 Netebics與私人/公共鑰匙合作。
只能使用A005版本的A005。 A006使用PSS填充，目前.NET Core 2.x不支持。有彈性城堡僅用於PEM文件和證書管理。
只能使用E002版本的E002版本。
只能使用用於身份驗證的版本X002。
Netebics是使用EBICS版本H004開發的，但H005應該起作用。
當前已實施的命令/請求：INI，HIA，HPB，PTK，SPR，SP，STA，CCT，CDD

依賴性

Netebics在以下庫中是不屬於的：

Bouncycastle（用於PEM文件和X509證書管理）
Zlib（用於取消/壓縮EBICS訂單數據）
Microsoft擴展記錄
Microsoft XML加密（用於基本XML安全）
StatePrinter（用於調試日誌）

Netebics不使用依賴注入。有關更多信息，請參見CSPROJ文件。

安裝

目前，沒有官方的Nuget軟件包可用，因此您必須通過克隆此存儲庫來自行構建庫。

確保已安裝了.NET Core SDK版本2或更高版本。

克隆存儲庫。

 git clone https://github.com/hohlerde/NetEbics.git

構建庫。

 cd NetEbics
dotnet pack -c Release

您會在bin/Release下找到Nuget軟件包。

用法

為了使用庫，您應該對EBICS協議有一個合理的良好理解。

初始化（INI/HIA）

作為新的EBICs用戶，您要做的第一件事是向銀行宣布您的公共RSA鑰匙。您需要為此創建三個公共/私鑰對（身份驗證，簽名和加密密鑰）。

使用Bouncycastle創建鑰匙很容易。

 var gen = GeneratorUtilities . GetKeyPairGenerator ( "RSA" ) ;
gen . Init ( new KeyGenerationParameters ( new SecureRandom ( ) , 4096 ) ) ;
var signKeyPair = gen . GenerateKeyPair ( ) ;   

using ( TextWriter sw = new StreamWriter ( "sign.key" ) )
{
    var pw = new PemWriter ( sw ) ;
    pw . WriteObject ( signKeyPair ) ;
    sw . Flush ( ) ;
}

調整上述代碼，並創建身份驗證（“ auth.key”）和加密（“ enc.key”）鍵。

向銀行宣布您的公共簽名密鑰。請注意，先前生成的密鑰以PEM格式存儲，並包含私鑰和公鑰。

 AsymmetricCipherKeyPair signKey ;

using ( var sr = new StringReader ( File . ReadAllText ( "sign.key" ) . Trim ( ) ) )
{
    var pr = new PemReader ( sr ) ;
    signKey = pr . ReadObject ( ) ;
}

var signCert = KeyUtils . CreateX509Certificate2 ( signKey ) ;

var client = EbicsClient . Factory ( ) . Create ( new EbicsConfig
{
    Address = "The EBICS URL you got from your bank, i.e. https://ebics-server.com/" ,
    Insecure = true ,
    TLS = true ,
    User = new UserParams
    {
        HostId = "The host ID of your bank" ,
        PartnerId = "Your partner ID you got from your bank" ,
        UserId = "Your user ID you got from your bank" ,
        SignKeys = new SignKeyPair
        {
            Version = SignVersion . A005 , // only A005 is supported right now
            TimeStamp = DateTime . Now ,
            Certificate = signCert // internally we work with keys
        }
    }
} ) ;

var resp = c . INI ( new IniParams ( ) ) ;

之後，我們需要宣佈公共身份驗證和加密密鑰。

 // loading of keys "auth.key" and "enc.key" omitted

var authCert = KeyUtils . CreateX509Certificate2 ( authKey ) ;
var encCert = KeyUtils . CreateX509Certificate2 ( encKey ) ;

var client = EbicsClient . Factory ( ) . Create ( new EbicsConfig
{
    Address = "The EBICS URL you got from your bank, i.e. https://ebics-server.com/" ,
    Insecure = true ,
    TLS = true ,
    User = new UserParams
    {
        HostId = "The host ID of your bank" ,
        PartnerId = "Your partner ID" ,
        UserId = "Your user ID" ,
        AuthKeys = new AuthKeyPair
        {
            Version = AuthVersion . X002 ,
            TimeStamp = DateTime . Now ,
            Certificate = authCert
        } ,
        CryptKeys = new CryptKeyPair
        {
            Version = CryptVersion . E002 ,
            TimeStamp = DateTime . Now ,
            Certificate = encCert
        }
    }
} ) ;

var resp = c . HIA ( new HiaParams ( ) ) ;

宣布密鑰還不夠，因為銀行需要確保鑰匙確實屬於您。為了證明這一點，您需要將INI和HIA信件發送給您的銀行。它們包含您的公共鑰匙的哈希值和書面簽名。 EBICS規範詳細描述了這些字母的外觀。

檢索公共銀行鑰匙（HPB）

為了通過EBIC與銀行進行交流，您需要銀行的公共密鑰，因為交換的數據需要加密和認證。

 // loading of keys "auth.key" and "enc.key" omitted

var authCert = KeyUtils . CreateX509Certificate2 ( authKey ) ;
var encCert = KeyUtils . CreateX509Certificate2 ( encKey ) ;

var client = EbicsClient . Factory ( ) . Create ( new EbicsConfig
{
    Address = "The EBICS URL you got from your bank, i.e. https://ebics-server.com/" ,
    Insecure = true ,
    TLS = true ,
    User = new UserParams
    {
        HostId = "The host ID of your bank" ,
        PartnerId = "Your partner ID" ,
        UserId = "Your user ID" ,
        AuthKeys = new AuthKeyPair
        {
            Version = AuthVersion . X002 ,
            TimeStamp = DateTime . Now ,
            Certificate = authCert
        } ,
        CryptKeys = new CryptKeyPair
        {
            Version = CryptVersion . E002 ,
            TimeStamp = DateTime . Now ,
            Certificate = encCert
        }
    }
} ) ;

var hpbResp = c . HPB ( new HpbParams ( ) ) ;
if ( hpbResp . TechnicalReturnCode != 0 || hpbResp . BusinessReturnCode != 0 )
{
    // handle error
    return ;
}

c . Config . Bank = resp . Bank ; // set bank's public keys

// now issue other commands

直接信用轉移（CCT）

 // loading of keys "auth.key", "enc.key" and "sign.key" omitted

var authCert = KeyUtils . CreateX509Certificate2 ( authKey ) ;
var encCert = KeyUtils . CreateX509Certificate2 ( encKey ) ;
var signCert = KeyUtils . CreateX509Certificate2 ( signKey ) ;

var client = EbicsClient . Factory ( ) . Create ( new EbicsConfig
{
    Address = "The EBICS URL you got from your bank, i.e. https://ebics-server.com/" ,
    Insecure = true ,
    TLS = true ,
    User = new UserParams
    {
        HostId = "The host ID of your bank" ,
        PartnerId = "Your partner ID" ,
        UserId = "Your user ID" ,
        AuthKeys = new AuthKeyPair
        {
            Version = AuthVersion . X002 ,
            TimeStamp = DateTime . Now ,
            Certificate = authCert
        } ,
        CryptKeys = new CryptKeyPair
        {
            Version = CryptVersion . E002 ,
            TimeStamp = DateTime . Now ,
            Certificate = encCert
        } ,
        SignKeys = new SignKeyPair
        {
            Version = SignVersion . A005 ,
            TimeStamp = DateTime . Now ,
            Certificate = signCert
        }
    }
} ) ;

var hpbResp = c . HPB ( new HpbParams ( ) ) ;
if ( hpbResp . TechnicalReturnCode != 0 || hpbResp . BusinessReturnCode != 0 )
{
    // handle error
    return ;
}

c . Config . Bank = resp . Bank ; // set bank's public keys

// create credit transfer data structure

var cctParams = new CctParams
{
    InitiatingParty = "Your name" ,
    PaymentInfos = new [ ]
    {
        new CreditTransferPaymentInfo
        {
            DebtorName = "Sender's name" ,
            DebtorAccount = "Sender's IBAN" ,
            DebtorAgent = "Sender's BIC" ,
            ExecutionDate = "2018-05-15" ,
            CreditTransferTransactionInfos = new [ ]
            {
                new CreditTransferTransactionInfo
                {
                    Amount = "1.00" ,
                    CreditorName = "Receiver's name" ,
                    CreditorAccount = "Receiver's IBAN" ,
                    CreditorAgent = "Receiver's BIC" ,
                    CurrencyCode = "EUR" ,
                    EndToEndId = "something" ,
                    RemittanceInfo = "Unstructured information for receiver" ,
                }
            }
        }
    }
} ;

var cctResp = c . CCT ( cctParams ) ;

紀錄

如果您不在ASP.NET環境中，並且希望看到一些日誌輸出，則可以例如啟用Serilog以及Microsoft Extensions Logggging。

 Log . Logger = new LoggerConfiguration ( )
    . WriteTo . Console ( )
    . MinimumLevel . Debug ( )
    . CreateLogger ( ) ;

EbicsLogging . MethodLoggingEnabled = true ; // see entry/exit messages in log
EbicsLogging . LoggerFactory . AddSerilog ( ) ;

您需要在csproj文件中引用Serilog.Extensions.Logging and Serilog.Sinks.Console以使用Serilog。

< ItemGroup >
    < PackageReference Include = " Serilog.Extensions.Logging " Version = " 2.0.2 " />
    < PackageReference Include = " Serilog.Sinks.Console " Version = " 3.1.2-dev-00771 " />
</ ItemGroup >

在ASP.NET環境中，您只需要將LoggerFactory實例傳遞到量級註入容器到網絡的實例即可。

 public MyController ( ILoggerFactory loggerFactory )
{
    EbicsLogging . MethodLoggingEnabled = true ;
    EbicsLogging . LoggerFactory = loggerFactory ;
}