odoo_account_ebics/account_ebics/models/ebics_userid.py

489 lines
17 KiB
Python
Raw Normal View History

# Copyright 2009-2020 Noviat.
# License LGPL-3 or later (http://www.gnu.org/licenses/lpgl).
import base64
import logging
import os
from sys import exc_info
from traceback import format_exception
from urllib.error import URLError
from odoo import _, api, fields, models
from odoo.exceptions import UserError
_logger = logging.getLogger(__name__)
2022-05-10 19:40:54 +00:00
# logging.basicConfig(
# level=logging.DEBUG,
# format='[%(asctime)s] %(levelname)s - %(name)s: %(message)s')
try:
import fintech
2022-05-10 19:40:54 +00:00
from fintech.ebics import (
EbicsBank,
EbicsClient,
EbicsFunctionalError,
EbicsKeyRing,
EbicsTechnicalError,
EbicsUser,
)
fintech.cryptolib = "cryptography"
except ImportError:
2022-05-10 19:40:54 +00:00
_logger.warning("Failed to import fintech")
class EbicsBank(EbicsBank):
def _next_order_id(self, partnerid):
"""
EBICS protocol version H003 requires generation of the OrderID.
The OrderID must be a string between 'A000' and 'ZZZZ' and
unique for each partner id.
"""
2022-05-10 19:40:54 +00:00
return hasattr(self, "_order_number") and self._order_number or "A000"
class EbicsUserID(models.Model):
2022-05-10 19:40:54 +00:00
_name = "ebics.userid"
_description = "EBICS UserID"
_order = "name"
name = fields.Char(
2022-05-10 19:40:54 +00:00
string="EBICS UserID",
required=True,
readonly=True,
states={"draft": [("readonly", False)]},
help="Human users or a technical system that is/are "
2022-05-10 19:40:54 +00:00
"assigned to a customer. "
"\nOn the EBICS bank server it is identified "
"by the combination of UserID and PartnerID. "
"The technical subscriber serves only for the data exchange "
"between customer and financial institution. "
"The human user also can authorise orders.",
)
ebics_config_id = fields.Many2one(
2022-05-10 19:40:54 +00:00
comodel_name="ebics.config", string="EBICS Configuration", ondelete="cascade"
)
user_ids = fields.Many2many(
2022-05-10 19:40:54 +00:00
comodel_name="res.users",
string="Users",
required=True,
help="Users who are allowed to use this EBICS UserID for "
2022-05-10 19:40:54 +00:00
" bank transactions.",
)
# Currently only a singe signature class per user is supported
# Classes A and B are not yet supported.
signature_class = fields.Selection(
2022-05-10 19:40:54 +00:00
selection=[("E", "Single signature"), ("T", "Transport signature")],
string="Signature Class",
required=True,
default="T",
readonly=True,
states={"draft": [("readonly", False)]},
help="Default signature class."
2022-05-10 19:40:54 +00:00
"This default can be overriden for specific "
"EBICS transactions (cf. File Formats).",
)
ebics_keys_fn = fields.Char(compute="_compute_ebics_keys_fn")
ebics_keys_found = fields.Boolean(compute="_compute_ebics_keys_found")
ebics_passphrase = fields.Char(string="EBICS Passphrase")
ebics_ini_letter = fields.Binary(
2022-05-10 19:40:54 +00:00
string="EBICS INI Letter",
readonly=True,
help="INI-letter PDF document to be sent to your bank.",
)
ebics_ini_letter_fn = fields.Char(string="INI-letter Filename", readonly=True)
ebics_public_bank_keys = fields.Binary(
2022-05-10 19:40:54 +00:00
string="EBICS Public Bank Keys",
readonly=True,
help="EBICS Public Bank Keys to be checked for consistency.",
)
ebics_public_bank_keys_fn = fields.Char(
2022-05-10 19:40:54 +00:00
string="EBICS Public Bank Keys Filename", readonly=True
)
2020-08-07 15:12:02 +00:00
swift_3skey = fields.Boolean(
2022-05-10 19:40:54 +00:00
string="Enable 3SKey support",
2020-08-07 15:12:02 +00:00
help="Transactions for this user will be signed "
2022-05-10 19:40:54 +00:00
"by means of the SWIFT 3SKey token.",
)
swift_3skey_certificate = fields.Binary(string="3SKey Certficate")
swift_3skey_certificate_fn = fields.Char(string="EBICS Public Bank Keys Filename")
# X.509 Distinguished Name attributes used to
# create self-signed X.509 certificates
ebics_key_x509 = fields.Boolean(
2022-05-10 19:40:54 +00:00
string="X509 support",
help="Set this flag in order to work with " "self-signed X.509 certificates",
)
ebics_key_x509_dn_cn = fields.Char(
2022-05-10 19:40:54 +00:00
string="Common Name [CN]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_o = fields.Char(
2022-05-10 19:40:54 +00:00
string="Organization Name [O]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_ou = fields.Char(
2022-05-10 19:40:54 +00:00
string="Organizational Unit Name [OU]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_c = fields.Char(
2022-05-10 19:40:54 +00:00
string="Country Name [C]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_st = fields.Char(
2022-05-10 19:40:54 +00:00
string="State Or Province Name [ST]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_l = fields.Char(
2022-05-10 19:40:54 +00:00
string="Locality Name [L]",
readonly=True,
states={"draft": [("readonly", False)]},
)
ebics_key_x509_dn_e = fields.Char(
2022-05-10 19:40:54 +00:00
string="Email Address",
readonly=True,
states={"draft": [("readonly", False)]},
)
state = fields.Selection(
2022-05-10 19:40:54 +00:00
[
("draft", "Draft"),
("init", "Initialisation"),
("get_bank_keys", "Get Keys from Bank"),
("to_verify", "Verification"),
("active_keys", "Active Keys"),
],
string="State",
default="draft",
required=True,
readonly=True,
)
active = fields.Boolean(string="Active", default=True)
company_ids = fields.Many2many(
2022-05-10 19:40:54 +00:00
comodel_name="res.company",
string="Companies",
required=True,
2022-05-10 19:40:54 +00:00
help="Companies sharing this EBICS contract.",
)
2022-05-10 19:40:54 +00:00
@api.depends("name")
def _compute_ebics_keys_fn(self):
for rec in self:
keys_dir = rec.ebics_config_id.ebics_keys
rec.ebics_keys_fn = (
2022-05-10 19:40:54 +00:00
rec.name and keys_dir and (keys_dir + "/" + rec.name + "_keys")
)
2022-05-10 19:40:54 +00:00
@api.depends("ebics_keys_fn")
def _compute_ebics_keys_found(self):
for rec in self:
2022-05-10 19:40:54 +00:00
rec.ebics_keys_found = rec.ebics_keys_fn and os.path.isfile(
rec.ebics_keys_fn
)
2022-05-10 19:40:54 +00:00
@api.constrains("ebics_passphrase")
def _check_ebics_passphrase(self):
for rec in self:
if not rec.ebics_passphrase or len(rec.ebics_passphrase) < 8:
2022-05-10 19:40:54 +00:00
raise UserError(_("The passphrase must be at least 8 characters long"))
2022-05-10 19:40:54 +00:00
@api.onchange("signature_class")
2020-08-07 15:12:02 +00:00
def _onchange_signature_class(self):
2022-05-10 19:40:54 +00:00
if self.signature_class == "T":
2020-08-07 15:12:02 +00:00
self.swift_3skey = False
2022-05-10 19:40:54 +00:00
@api.onchange("swift_3skey")
2020-08-07 15:12:02 +00:00
def _onchange_swift_3skey(self):
if self.swift_3skey:
self.ebics_key_x509 = True
def set_to_draft(self):
2022-05-10 19:40:54 +00:00
return self.write({"state": "draft"})
2020-07-14 21:18:32 +00:00
def set_to_active_keys(self):
2022-05-10 19:40:54 +00:00
return self.write({"state": "active_keys"})
2020-07-14 21:18:32 +00:00
def set_to_get_bank_keys(self):
2022-05-10 19:40:54 +00:00
return self.write({"state": "get_bank_keys"})
2022-05-10 19:40:54 +00:00
def ebics_init_1(self): # noqa: C901
"""
Initialization of bank keys - Step 1:
Create new keys and certificates for this user
"""
self.ensure_one()
2020-07-14 21:18:32 +00:00
self.ebics_config_id._check_ebics_files()
2022-05-10 19:40:54 +00:00
if self.state != "draft":
raise UserError(
2022-05-10 19:40:54 +00:00
_("Set state to 'draft' before Bank Key (re)initialisation.")
)
if not self.ebics_passphrase:
2022-05-10 19:40:54 +00:00
raise UserError(_("Set a passphrase."))
2020-07-22 19:31:10 +00:00
2020-09-11 09:08:08 +00:00
if self.swift_3skey and not self.swift_3skey_certificate:
2022-05-10 19:40:54 +00:00
raise UserError(_("3SKey certificate missing."))
2020-08-07 15:12:02 +00:00
2020-07-22 19:31:10 +00:00
ebics_version = self.ebics_config_id.ebics_version
try:
keyring = EbicsKeyRing(
2022-05-10 19:40:54 +00:00
keys=self.ebics_keys_fn, passphrase=self.ebics_passphrase
)
bank = EbicsBank(
2020-07-14 21:18:32 +00:00
keyring=keyring,
hostid=self.ebics_config_id.ebics_host,
2022-05-10 19:40:54 +00:00
url=self.ebics_config_id.ebics_url,
)
user = EbicsUser(
2020-07-14 21:18:32 +00:00
keyring=keyring,
partnerid=self.ebics_config_id.ebics_partner,
2022-05-10 19:40:54 +00:00
userid=self.name,
)
except Exception:
exctype, value = exc_info()[:2]
error = _("EBICS Initialisation Error:")
2022-05-10 19:40:54 +00:00
error += "\n" + str(exctype) + "\n" + str(value)
raise UserError(error)
2020-07-14 21:18:32 +00:00
self.ebics_config_id._check_ebics_keys()
if not os.path.isfile(self.ebics_keys_fn):
try:
2020-08-07 15:12:02 +00:00
# TODO:
# enable import of all type of certicates: A00x, X002, E002
if self.swift_3skey:
kwargs = {
2022-05-10 19:40:54 +00:00
self.ebics_config_id.ebics_key_version: base64.decodestring(
self.swift_3skey_certificate
),
2020-08-07 15:12:02 +00:00
}
user.import_certificates(**kwargs)
user.create_keys(
2020-07-14 21:18:32 +00:00
keyversion=self.ebics_config_id.ebics_key_version,
2022-05-10 19:40:54 +00:00
bitlength=self.ebics_config_id.ebics_key_bitlength,
)
except Exception:
exctype, value = exc_info()[:2]
error = _("EBICS Initialisation Error:")
2022-05-10 19:40:54 +00:00
error += "\n" + str(exctype) + "\n" + str(value)
raise UserError(error)
2020-08-07 15:12:02 +00:00
if self.swift_3skey and not self.ebics_key_x509:
2022-05-10 19:40:54 +00:00
raise UserError(
_(
"The current version of this module "
"requires to X509 support when enabling 3SKey"
)
)
2020-08-07 15:12:02 +00:00
if self.ebics_key_x509:
dn_attrs = {
2022-05-10 19:40:54 +00:00
"commonName": self.ebics_key_x509_dn_cn,
"organizationName": self.ebics_key_x509_dn_o,
"organizationalUnitName": self.ebics_key_x509_dn_ou,
"countryName": self.ebics_key_x509_dn_c,
"stateOrProvinceName": self.ebics_key_x509_dn_st,
"localityName": self.ebics_key_x509_dn_l,
"emailAddress": self.ebics_key_x509_dn_e,
}
kwargs = {k: v for k, v in dn_attrs.items() if v}
user.create_certificates(**kwargs)
2022-05-10 19:40:54 +00:00
client = EbicsClient(bank, user, version=ebics_version)
# Send the public electronic signature key to the bank.
ebics_config_bank = self.ebics_config_id.journal_ids[0].bank_id
if not ebics_config_bank:
2022-05-10 19:40:54 +00:00
raise UserError(
_("No bank defined for the financial journal " "of the EBICS Config")
)
try:
2020-07-22 19:31:10 +00:00
supported_versions = client.HEV()
if ebics_version not in supported_versions:
err_msg = _("EBICS version mismatch.") + "\n"
err_msg += _("Versions supported by your bank:")
for k in supported_versions:
2022-05-10 19:40:54 +00:00
err_msg += "\n{}: {} ".format(k, supported_versions[k])
2020-07-22 19:31:10 +00:00
raise UserError(err_msg)
2022-05-10 19:40:54 +00:00
if ebics_version == "H003":
2020-07-14 21:18:32 +00:00
bank._order_number = self.ebics_config_id._get_order_number()
OrderID = client.INI()
2022-05-10 19:40:54 +00:00
_logger.info("%s, EBICS INI command, OrderID=%s", self._name, OrderID)
if ebics_version == "H003":
2020-07-14 21:18:32 +00:00
self.ebics_config_id._update_order_number(OrderID)
except URLError:
exctype, value = exc_info()[:2]
tb = "".join(format_exception(*exc_info()))
_logger.error(
"EBICS INI command error\nUserID: %s\n%s",
self.name,
tb,
)
2022-05-10 19:40:54 +00:00
raise UserError(
_("urlopen error:\n url '%s' - %s")
% (self.ebics_config_id.ebics_url, str(value))
)
except EbicsFunctionalError:
e = exc_info()
error = _("EBICS Functional Error:")
2022-05-10 19:40:54 +00:00
error += "\n"
error += "{} (code: {})".format(e[1].message, e[1].code)
raise UserError(error)
except EbicsTechnicalError:
e = exc_info()
error = _("EBICS Technical Error:")
2022-05-10 19:40:54 +00:00
error += "\n"
error += "{} (code: {})".format(e[1].message, e[1].code)
raise UserError(error)
# Send the public authentication and encryption keys to the bank.
2022-05-10 19:40:54 +00:00
if ebics_version == "H003":
2020-07-14 21:18:32 +00:00
bank._order_number = self.ebics_config_id._get_order_number()
OrderID = client.HIA()
2022-05-10 19:40:54 +00:00
_logger.info("%s, EBICS HIA command, OrderID=%s", self._name, OrderID)
if ebics_version == "H003":
2020-07-14 21:18:32 +00:00
self.ebics_config_id._update_order_number(OrderID)
# Create an INI-letter which must be printed and sent to the bank.
ebics_config_bank = self.ebics_config_id.journal_ids[0].bank_id
cc = ebics_config_bank.country.code
2022-05-10 19:40:54 +00:00
if cc in ["FR", "DE"]:
lang = cc
else:
2022-05-10 19:40:54 +00:00
lang = self.env.user.lang or self.env["res.lang"].search([])[0].code
lang = lang[:2]
2022-05-10 19:40:54 +00:00
tmp_dir = os.path.normpath(self.ebics_config_id.ebics_files + "/tmp")
if not os.path.isdir(tmp_dir):
os.makedirs(tmp_dir, mode=0o700)
fn_date = fields.Date.today().isoformat()
2022-05-10 19:40:54 +00:00
fn = "_".join([self.ebics_config_id.ebics_host, "ini_letter", fn_date]) + ".pdf"
full_tmp_fn = os.path.normpath(tmp_dir + "/" + fn)
user.create_ini_letter(
2022-05-10 19:40:54 +00:00
bankname=ebics_config_bank.name, path=full_tmp_fn, lang=lang
)
with open(full_tmp_fn, "rb") as f:
letter = f.read()
2022-05-10 19:40:54 +00:00
self.write(
{
"ebics_ini_letter": base64.encodebytes(letter),
"ebics_ini_letter_fn": fn,
}
)
2022-05-10 19:40:54 +00:00
return self.write({"state": "init"})
def ebics_init_2(self):
"""
Initialization of bank keys - Step 2:
Activation of the account by the bank.
"""
2022-05-10 19:40:54 +00:00
if self.state != "init":
raise UserError(_("Set state to 'Initialisation'."))
self.ensure_one()
2022-05-10 19:40:54 +00:00
return self.write({"state": "get_bank_keys"})
def ebics_init_3(self):
"""
Initialization of bank keys - Step 3:
After the account has been activated the public bank keys
must be downloaded and checked for consistency.
"""
self.ensure_one()
2020-07-14 21:18:32 +00:00
self.ebics_config_id._check_ebics_files()
2022-05-10 19:40:54 +00:00
if self.state != "get_bank_keys":
raise UserError(_("Set state to 'Get Keys from Bank'."))
2020-12-12 18:20:47 +00:00
try:
keyring = EbicsKeyRing(
2022-05-10 19:40:54 +00:00
keys=self.ebics_keys_fn, passphrase=self.ebics_passphrase
)
2020-12-12 18:20:47 +00:00
bank = EbicsBank(
keyring=keyring,
hostid=self.ebics_config_id.ebics_host,
2022-05-10 19:40:54 +00:00
url=self.ebics_config_id.ebics_url,
)
2020-12-12 18:20:47 +00:00
user = EbicsUser(
keyring=keyring,
partnerid=self.ebics_config_id.ebics_partner,
2022-05-10 19:40:54 +00:00
userid=self.name,
)
client = EbicsClient(bank, user, version=self.ebics_config_id.ebics_version)
2020-12-12 18:20:47 +00:00
except Exception:
exctype, value = exc_info()[:2]
error = _("EBICS Initialisation Error:")
2022-05-10 19:40:54 +00:00
error += "\n" + str(exctype) + "\n" + str(value)
2020-12-12 18:20:47 +00:00
raise UserError(error)
try:
public_bank_keys = client.HPB()
except EbicsFunctionalError:
e = exc_info()
error = _("EBICS Functional Error:")
2022-05-10 19:40:54 +00:00
error += "\n"
error += "{} (code: {})".format(e[1].message, e[1].code)
2020-12-12 18:20:47 +00:00
raise UserError(error)
except Exception:
exctype, value = exc_info()[:2]
error = _("EBICS Initialisation Error:")
2022-05-10 19:40:54 +00:00
error += "\n" + str(exctype) + "\n" + str(value)
2020-12-12 18:20:47 +00:00
raise UserError(error)
public_bank_keys = public_bank_keys.encode()
2022-05-10 19:40:54 +00:00
tmp_dir = os.path.normpath(self.ebics_config_id.ebics_files + "/tmp")
if not os.path.isdir(tmp_dir):
os.makedirs(tmp_dir, mode=0o700)
fn_date = fields.Date.today().isoformat()
2022-05-10 19:40:54 +00:00
fn = (
"_".join([self.ebics_config_id.ebics_host, "public_bank_keys", fn_date])
+ ".txt"
)
self.write(
{
"ebics_public_bank_keys": base64.encodestring(public_bank_keys),
"ebics_public_bank_keys_fn": fn,
"state": "to_verify",
}
)
return True
def ebics_init_4(self):
"""
Initialization of bank keys - Step 2:
Confirm Verification of the public bank keys
and activate the bank keyu.
"""
self.ensure_one()
2022-05-10 19:40:54 +00:00
if self.state != "to_verify":
raise UserError(_("Set state to 'Verification'."))
keyring = EbicsKeyRing(
2022-05-10 19:40:54 +00:00
keys=self.ebics_keys_fn, passphrase=self.ebics_passphrase
)
bank = EbicsBank(
2020-07-14 21:18:32 +00:00
keyring=keyring,
hostid=self.ebics_config_id.ebics_host,
2022-05-10 19:40:54 +00:00
url=self.ebics_config_id.ebics_url,
)
bank.activate_keys()
2022-05-10 19:40:54 +00:00
return self.write({"state": "active_keys"})
def change_passphrase(self):
self.ensure_one()
2020-07-14 21:18:32 +00:00
ctx = dict(self._context, default_ebics_userid_id=self.id)
2022-05-10 19:40:54 +00:00
module = __name__.split("addons.")[1].split(".")[0]
view = self.env.ref("%s.ebics_change_passphrase_view_form" % module)
return {
2022-05-10 19:40:54 +00:00
"name": _("EBICS keys change passphrase"),
"view_type": "form",
"view_mode": "form",
"res_model": "ebics.change.passphrase",
"view_id": view.id,
"target": "new",
"context": ctx,
"type": "ir.actions.act_window",
}