holado 0.13.22__py3-none-any.whl

holado_crypto/__init__.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+
+def dependencies():
+    """
+    Return None or the list of names of modules it depend on
+    """
+    return None
+
+def register():
+    """
+    Register the services of this module
+    """
+    # from holado.common.context.session_context import SessionContext
+    
+    # from holado_xxx.xxx import XXXManager
+    # SessionContext.instance().services.register_service_type("xxx_manager", XXXManager)
+    pass
+

holado_crypto/crypto/crypto.py

@@ -0,0 +1,108 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+import logging
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado.common.context.session_context import SessionContext
+from holado.common.handlers.undefined import default
+
+logger = logging.getLogger(__name__)
+
+
+class CryptoManager(object):
+    """
+    Helper for cryptography management.
+    """
+    
+    @classmethod
+    def __get_path_manager(cls):
+        return SessionContext.instance().path_manager
+    
+    @classmethod
+    def encrypt_data_with_key(cls, data, key, data_padding_char=b'\x00', padding=default):
+        """ Encrypt data with given asymmetric public key.
+        Note: default padding is OAEP with sha256. If it doesn't match the key, padding parameter must be specified.
+        """
+        return cls._crypt_data_with_key(data, key.key_size, key.encrypt, data_padding_char, padding)
+    
+    @classmethod
+    def decrypt_data_with_key(cls, data, key, data_padding_char=b'\x00', padding=default):
+        """ Decrypt data with given asymmetric private key.
+        Note: default padding is OAEP with sha256. If it doesn't match the key, padding parameter must be specified.
+        """
+        return cls._crypt_data_with_key(data, key.key_size, key.decrypt, data_padding_char, padding)
+
+    @classmethod
+    def _crypt_data_with_key(cls, data, key_size, key_method, data_padding_char=b'\x00', padding=default):
+        """ Decrypt data with given asymmetric private key.
+        Note: default padding is OAEP with sha256. If it doesn't match the key, padding parameter must be specified.
+        """
+        if padding is default:
+            from cryptography.hazmat.primitives.asymmetric import padding
+            from cryptography.hazmat.primitives import hashes
+            padding = padding.OAEP(mgf=padding.MGF1(algorithm=hashes.SHA256()), algorithm=hashes.SHA256(), label=None)
+        
+        # Decrypt data
+        res = b''
+        key_nb_bytes = key_size // 8
+        for i in range(0, len(data), key_nb_bytes):
+            cur_data = data[i*key_nb_bytes:(i+1)*key_nb_bytes]
+            cur_len = len(cur_data)
+            if cur_len < key_nb_bytes:
+                cur_data += data_padding_char * (key_nb_bytes - cur_len)
+            cur_res = key_method(cur_data, padding=padding)
+            if cur_len < key_nb_bytes:
+                cur_res = cur_res[:cur_len]
+            res += cur_res
+        
+        return res
+
+    @classmethod
+    def cipher_data(cls, data, cipher=None, **cipher_kwargs):
+        """ Cipher data with given symmetric cipher.
+        """
+        if cipher is None:
+            cipher = cls.new_cipher(**cipher_kwargs)
+        encryptor = cipher.encryptor()
+        res = encryptor.update(data) + encryptor.finalize()
+        return res
+
+    @classmethod
+    def decipher_data(cls, data, cipher=None, **cipher_kwargs):
+        """ Decipher data with given symmetric cipher.
+        """
+        if cipher is None:
+            cipher = cls.new_cipher(**cipher_kwargs)
+        decryptor = cipher.decryptor()
+        res = decryptor.update(data) + decryptor.finalize()
+        return res
+        
+
+    @classmethod
+    def new_cipher(cls, algorithm=None, mode=default, algorithm_name=None, algorithm_key=None, **kwargs):
+        """ Create cipher with given symmetric algorithm.
+        Note: default mode is CBC with initial vector composed of as many zeros as needed by algorithm.
+        """
+        from cryptography.hazmat.primitives.ciphers import Cipher, algorithms, modes
+        
+        if algorithm is None and algorithm_name is not None:
+            if hasattr(algorithms, algorithm_name):
+                algorithm = getattr(algorithms, algorithm_name)(algorithm_key)
+            else:
+                raise TechnicalException(f"Algorithm '{algorithm_name}' is not managed")
+        if mode is default:
+            mode = modes.CBC(b'\x00' * (algorithm.block_size // 8))
+        
+        return Cipher(algorithm, mode, **kwargs)
+        
+        

holado_crypto/crypto/key.py

@@ -0,0 +1,92 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+import logging
+from holado_core.common.exceptions.technical_exception import TechnicalException
+from holado_system.system.command.command import Command, CommandStates
+from holado.common.context.session_context import SessionContext
+from holado_system.system.filesystem.file import File
+import cryptography.x509
+from cryptography.hazmat.primitives import serialization
+from holado.common.handlers.undefined import default_value
+
+logger = logging.getLogger(__name__)
+
+
+class KeyManager(object):
+    """
+    Helper for key management.
+    """
+    
+    @classmethod
+    def __get_path_manager(cls):
+        return SessionContext.instance().path_manager
+    
+    @classmethod
+    def generate_new_self_signed_key_files(cls, public_key_path, private_key_path, openssl_args):
+        cls.__get_path_manager().makedirs(public_key_path)
+        cls.__get_path_manager().makedirs(private_key_path)
+        
+        cmd = f"openssl req -out '{public_key_path}' -keyout '{private_key_path}' {openssl_args}"
+        command = Command(cmd, do_log_output=True, do_raise_on_stderr=False, executable="/bin/bash")
+        command.start()
+        command.join()
+        
+        if command.state is not CommandStates.Success:
+            raise TechnicalException(f"Error while executing openssl command [{cmd}] : [{command.stderr}]")
+    
+    @classmethod
+    def generate_new_self_signed_key_files_for_localhost(cls, public_key_path, private_key_path, algorithm='rsa:2048'):
+        KeyManager.generate_new_self_signed_key_files(
+            public_key_path, private_key_path, 
+            f"-x509 -newkey {algorithm} -noenc -sha256 -subj '/CN=localhost' -extensions EXT \
+              -config <( printf \"[dn]\nCN=localhost\n[req]\ndistinguished_name = dn\n[EXT]\nsubjectAltName=DNS:localhost\nkeyUsage=digitalSignature\nextendedKeyUsage=serverAuth\")"
+            )
+    
+    @classmethod
+    def load_pem_public_key(cls, data=None, file_path=None, is_x509=False, **kwargs):
+        if file_path is not None:
+            data = File.read_file_content(file_path, mode='rb')
+        
+        if is_x509:
+            cert = cryptography.x509.load_pem_x509_certificate(data, **kwargs)
+            res = cert.public_key()
+        else:
+            res = serialization.load_pem_public_key(data, **kwargs)
+        
+        return res
+    
+    @classmethod
+    def load_pem_private_key(cls, data=None, file_path=None, **kwargs):
+        if file_path is not None:
+            data = File.read_file_content(file_path, mode='rb')
+        
+        password = kwargs.get('password', None)
+        res = serialization.load_pem_private_key(data, password, **kwargs)
+        
+        return res
+    
+    @classmethod
+    def convert_public_key_to_hex(cls, public_key, encoding=default_value, public_format=default_value):
+        """Convert public in a portable hexadecimal format.
+        Note: default encoding is DER, and default public_format is SubjectPublicKeyInfo. If they are not compatible with public_key, appropriate values must be specified.
+        """
+        if encoding is default_value:
+            encoding = serialization.Encoding.DER
+        if public_format is default_value:
+            public_format = serialization.PublicFormat.SubjectPublicKeyInfo
+        return public_key.public_bytes(encoding=encoding, format=public_format).hex()
+    
+    
+    
+

holado_crypto/crypto/tcpbin.py

@@ -0,0 +1,105 @@
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+import logging
+from holado_core.common.exceptions.technical_exception import TechnicalException
+import os
+from holado_system.system.command.command import Command, CommandStates
+from holado.common.context.session_context import SessionContext
+import json
+from holado_system.system.filesystem.file import File
+
+logger = logging.getLogger(__name__)
+
+
+class TcpbinManager(object):
+    """
+    Helper for tcpbin.com usage.
+    """
+    
+    @classmethod
+    def __get_path_manager(cls):
+        return SessionContext.instance().path_manager
+    
+    @classmethod
+    def get_client_certificates(cls):
+        base_path = cls.__get_path_manager().get_local_resources_path('certificates')
+        certfile_path = os.path.join(base_path, 'tcpbin.crt')
+        keyfile_path = os.path.join(base_path, 'tcpbin.key')
+        
+        cls.ensure_tcpbin_certificates_are_valid(certfile_path, keyfile_path)
+        
+        return (certfile_path, keyfile_path)
+    
+    @classmethod
+    def get_CAs(cls):
+        base_path = cls.__get_path_manager().get_local_resources_path('certificates')
+        ca_certfile_path = os.path.join(base_path, 'rootCACert.pem')
+        ca_keyfile_path = os.path.join(base_path, 'rootCAKey.pem')
+        
+        cls.extract_tcpbin_ca_files(ca_certfile_path, ca_keyfile_path)
+        
+        return (ca_certfile_path, ca_keyfile_path)
+    
+    @classmethod
+    def ensure_tcpbin_certificates_are_valid(cls, public_key_path, private_key_path, duration_seconds=600):
+        cls.__get_path_manager().makedirs(public_key_path)
+        cls.__get_path_manager().makedirs(private_key_path)
+        
+        # Verify if certificate has expired
+        do_generate_certificates = True
+        if os.path.exists(public_key_path):
+            cmd = f"openssl x509 -checkend {duration_seconds} -noout -in '{public_key_path}'"
+            command = Command(cmd, do_log_output=True, do_raise_on_stderr=False, executable="/bin/bash")
+            command.start()
+            command.join()
+            if command.state is CommandStates.Success:
+                do_generate_certificates = False
+            elif command.return_code == 1:
+                do_generate_certificates = True
+            else:
+                raise TechnicalException(f"Error while executing openssl command [{cmd}]: error code={command.return_code} ; stdout: [{command.stdout}] ; stderr: [{command.stderr}]")
+        
+        # Generate new certificates if needed
+        if do_generate_certificates:
+            cmd = f"curl -s https://tcpbin.com/api/client-cert"
+            command = Command(cmd, do_log_output=True, do_raise_on_stderr=False, executable="/bin/bash")
+            command.start()
+            command.join()
+            if command.state is not CommandStates.Success:
+                raise TechnicalException(f"Error while executing command [{cmd}] : [{command.stderr}]")
+            
+            data = json.loads(command.stdout)
+            File.write_file_with_content(public_key_path, data['cert'])
+            File.write_file_with_content(private_key_path, data['key'])
+    
+    @classmethod
+    def extract_tcpbin_ca_files(cls, ca_certfile_path, ca_keyfile_path):
+        if not cls.__get_path_manager().check_file_exists(ca_certfile_path, raise_exception=False):
+            cmd = f"curl -s https://tcpbin.com/rootCACert.pem"
+            command = Command(cmd, do_log_output=True, do_raise_on_stderr=True, executable="/bin/bash")
+            command.start()
+            command.join()
+            File.write_file_with_content(ca_certfile_path, command.stdout)
+        
+        if not cls.__get_path_manager().check_file_exists(ca_keyfile_path, raise_exception=False):
+            cmd = f"curl -s https://tcpbin.com/rootCAKey.pem"
+            command = Command(cmd, do_log_output=True, do_raise_on_stderr=True, executable="/bin/bash")
+            command.start()
+            command.join()
+            File.write_file_with_content(ca_keyfile_path, command.stdout)
+        
+
+
+
+

holado_crypto/crypto/transport/crc.py

@@ -0,0 +1,40 @@
+
+import logging
+from holado_core.common.tools.tools import Tools
+
+logger = logging.getLogger(__name__)
+
+
+class Crc(object):
+    
+    @staticmethod
+    def crc(msg_bytes, offset, nb_bits, crc_size, polynomial, init_val, xor_val, reverse=False):
+        if Tools.do_log(logger, logging.TRACE):  # @UndefinedVariable
+            logger.trace(f"Computing CRC for:\n  {msg_bytes=}\n  {offset=}\n  {nb_bits=}\n  {crc_size=}\n  {polynomial=}\n  {init_val=}\n  {xor_val=}")
+        res = init_val
+        
+        # For each data bit in the data, process bits from left to right (or from right to left if reverse=True)
+        if reverse:
+            bits_range = range(offset+nb_bits-1, offset-1, -1)
+        else:
+            bits_range = range(offset, offset+nb_bits)
+        for i in bits_range:
+            bit = (msg_bytes[i // 8] >> (7 - (i % 8))) & 0x1
+            out = (res >> (crc_size - 1)) & 0x1
+            res = (res << 1) & (0xFFFFFFFF >> (32 - crc_size))
+            # Apply polynomial if the bit about to be shifted out of the crc is different than the processed bit
+            if bit ^ out == 1:
+                res ^= polynomial
+            if Tools.do_log(logger, logging.TRACE):  # @UndefinedVariable
+                logger.trace(f"Computing CRC: {i=}, {bit=} => {res}")
+        
+        res ^= xor_val
+        
+        # Be careful, for a crc-32, we can't make <<32, this should result to <<0
+        res &= 0xFFFFFFFF >> (32 - crc_size)
+        
+        if Tools.do_log(logger, logging.DEBUG):
+            logger.debug(f"CRC for:\n  {msg_bytes=}\n  {offset=}\n  {nb_bits=}\n  {crc_size=}\n  {polynomial=}\n  {init_val=}\n  {xor_val=}\n => {res}")
+        return res
+        
+        

holado_crypto/tests/behave/steps/__init__.py

@@ -0,0 +1,18 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+
+from .crypto_steps import *
+from .key_steps import *
+from .tcpbin_steps import *

holado_crypto/tests/behave/steps/crypto_steps.py

@@ -0,0 +1,112 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+
+from holado.common.context.session_context import SessionContext
+from holado_test.behave.behave import *  # @UnusedWildImport
+import logging
+from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+from holado_value.common.tables.converters.value_table_converter import ValueTableConverter
+from holado_crypto.crypto.key import KeyManager
+from holado_test.scenario.step_tools import StepTools
+from holado_crypto.crypto.crypto import CryptoManager
+
+logger = logging.getLogger(__name__)
+
+
+def __get_scenario_context():
+    return SessionContext.instance().get_scenario_context()
+
+def __get_text_interpreter():
+    return __get_scenario_context().get_text_interpreter()
+
+def __get_variable_manager():
+    return __get_scenario_context().get_variable_manager()
+
+
+
+@Step(r"(?P<var_name>{Variable}) = encrypt (?P<data>{Str}) with public key (?P<public_key>{Str})")
+def step_impl(context, var_name, data, public_key):
+    """ Encrypt data with a public key.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    data = StepTools.evaluate_scenario_parameter(data)
+    public_key = StepTools.evaluate_scenario_parameter(public_key)
+    
+    res = CryptoManager.encrypt_data_with_key(data, public_key)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = decrypt (?P<data>{Bytes}) with private key (?P<private_key>{Str})")
+def step_impl(context, var_name, data, private_key):
+    """ Decrypt data with a private key.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    data = StepTools.evaluate_scenario_parameter(data)
+    private_key = StepTools.evaluate_scenario_parameter(private_key)
+    
+    res = CryptoManager.decrypt_data_with_key(data, private_key)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = encrypt (?P<data>{Bytes}) with public key (?P<public_key>{Str})")
+def step_impl(context, var_name, data, public_key):
+    """ Encrypt data with a public key.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    data = StepTools.evaluate_scenario_parameter(data)
+    public_key = StepTools.evaluate_scenario_parameter(public_key)
+    
+    res = CryptoManager.cipher_data(data, public_key)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = new cipher \(algorithm: (?P<algorithm>{Str}) ; key: (?P<key>{Bytes})\)")
+def step_impl(context, var_name, algorithm, key):
+    """ Create new cipher instance.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    algorithm = StepTools.evaluate_scenario_parameter(algorithm)
+    key = StepTools.evaluate_scenario_parameter(key)
+    
+    res = CryptoManager.new_cipher(algorithm_name=algorithm, algorithm_key=key)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = cipher (?P<data>{Bytes}) \(cipher: (?P<cipher>{Variable})\)")
+def step_impl(context, var_name, data, cipher):
+    """ Cipher data with a cipher instance.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    data = StepTools.evaluate_scenario_parameter(data)
+    cipher = StepTools.evaluate_scenario_parameter(cipher)
+    
+    res = CryptoManager.cipher_data(data, cipher)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Step(r"(?P<var_name>{Variable}) = decipher (?P<data>{Bytes}) \(cipher: (?P<cipher>{Variable})\)")
+def step_impl(context, var_name, data, cipher):
+    """ Decipher data with a cipher instance.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    data = StepTools.evaluate_scenario_parameter(data)
+    cipher = StepTools.evaluate_scenario_parameter(cipher)
+    
+    res = CryptoManager.decipher_data(data, cipher)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+
+

holado_crypto/tests/behave/steps/key_steps.py

@@ -0,0 +1,82 @@
+# -*- coding: utf-8 -*-
+
+#################################################
+# HolAdo (Holistic Automation do)
+#
+# (C) Copyright 2021-2025 by Eric Klumpp
+# 
+# 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.
+#################################################
+
+
+from holado.common.context.session_context import SessionContext
+from holado_test.behave.behave import *  # @UnusedWildImport
+import logging
+from holado_test.behave.scenario.behave_step_tools import BehaveStepTools
+from holado_value.common.tables.converters.value_table_converter import ValueTableConverter
+from holado_crypto.crypto.key import KeyManager
+from holado_test.scenario.step_tools import StepTools
+
+logger = logging.getLogger(__name__)
+
+
+def __get_scenario_context():
+    return SessionContext.instance().get_scenario_context()
+
+def __get_text_interpreter():
+    return __get_scenario_context().get_text_interpreter()
+
+def __get_variable_manager():
+    return __get_scenario_context().get_variable_manager()
+
+
+
+@Given(r"generate new self-signed key files for localhost")
+def step_impl(context):
+    """Generate public and private keys for a localhost use.
+    """
+    table = BehaveStepTools.convert_step_table_2_value_table_with_header(context.table)
+    kwargs = ValueTableConverter.convert_name_value_table_2_dict(table)
+
+    KeyManager.generate_new_self_signed_key_files_for_localhost(**kwargs)
+
+@Given(r"(?P<var_name>{Variable}) = public key for (?:(?P<is_x509_str>X509) )?PEM file (?P<file_path>{Str})")
+def step_impl(context, var_name, is_x509_str, file_path):
+    """Get public key instance.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    is_x509 = is_x509_str is not None
+    file_path = StepTools.evaluate_scenario_parameter(file_path)
+    
+    res = KeyManager.load_pem_public_key(file_path=file_path, is_x509=is_x509)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Given(r"(?P<var_name>{Variable}) = private key for PEM file (?P<file_path>{Str})")
+def step_impl(context, var_name, file_path):
+    """Get private key instance.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    file_path = StepTools.evaluate_scenario_parameter(file_path)
+    
+    res = KeyManager.load_pem_private_key(file_path=file_path)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+@Given(r"(?P<var_name>{Variable}) = convert public key (?P<pub_key>{Variable}) to hexadecimal")
+def step_impl(context, var_name, pub_key):
+    """Return path to default cert file.
+    Note: It uses ssl.get_default_verify_paths method.
+    """
+    var_name = StepTools.evaluate_variable_name(var_name)
+    key = StepTools.evaluate_variable_value(pub_key)
+    
+    res = KeyManager.convert_public_key_to_hex(key)
+    
+    __get_variable_manager().register_variable(var_name, res)
+
+