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 ;
}