Metadata-Version: 2.1
Name: robotframework-crypto
Version: 0.2.3
Summary: A library for secure password handling.
Home-page: https://github.com/Snooz82/robotframework-crypto
Author: René Rohner(Snooz82)
Author-email: snooz@posteo.de
License: UNKNOWN
Description: ===================================================
        robotframework-crypto
        ===================================================
        
        CryptoLibrary is a library for secure password handling.
        `project page <https://github.com/Snooz82/robotframework-crypto>`_
        
        For more information about Robot Framework, see http://robotframework.org.
        
        `Keyword Documentation <https://snooz82.github.io/robotframework-crypto/CryptoLibrary.html>`_
        
        |
        
        Installation
        ------------
        
        If you already have Python >= 3.6 with pip installed, you can simply
        run:
        
        ``pip install --upgrade robotframework-crypto``
        
        or if you have Python 2 and 3 installed in parallel you may use
        
        ``pip3 install --upgrade robotframework-crypto``
        
        If you have Python 2 ... i am very sorry! Please update!
        
        |
        
        How it works
        ------------
        
        CryptoLibrary uses asymmetric crypto with elliptic curve cryptography to store confidential data securely.
        
        With ``python -m CryptoLibrary`` you can generate a key pair (private and public key) for your test env.
        You will get the public key after generating.
        
        this public key can now be used to encrypt every data you do not want to be public.
        Passwords, personal data, etc.
        
        you can use ``python -m CryptoClient`` on you computer where you want to encrypt data.
        Encrypted Data will look like this:
        
        ``crypt:tIdr5s65+ggfJZl46pJgljioCUePUdZLozgiwquznw+xSlmzT3dcvfrTL9wIdRwmNOJuONT7FBW5``
        
        this encrypted data can now be decrypted with CryptoLibrary within RobotFramework.
        
        CryptoLibrary need the private_key_store.json for this.
        This is what is generated as key pair.
        Private key can be imported in test env with ``python -m CryptoLibrary`` .
        
        |
        
        Suppressing encrypted Text from Logs
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        All Data that is decrypted by CryptoLibrary is replaced in the log by ``***``
        This works always and can not be disabled.
        No need to use special keywords for this.
        
        |
        
        Usage in Test
        ~~~~~~~~~~~~~
        
        .. code :: robotframework
        
            *** Settings ***
            Resource    imports.resource
            Library     CryptoLibrary    %{private_key_password}    variable_decryption=False
            #private key which should be secret, should also be protected by a password
        
            *** Variables ***
            ${secret}=     KILL ALL HUMANS!!!
            ${enc_user}=   crypt:nkpEPOVKfOko3t04XxOupA+F/ANTEuR9aQuPaPeMBGBQenwYf6UNESEl9MWRKGuj60ZWd10=
            ${enc_pwd}=    crypt:TVpamLXCtrzRsl8UAgD0YuoY+lSJNV73+bTYhOP51zM1GQihgyCvSZ2CoGoKsUHLFjokyJLHxFzPEB4=
        
            *** Test Cases ***
            Valid Login
                Open Browser    ${BASE-URL}
                Suppress Logging                                  #disable Robot Framework logging
                ${var}=    set Variable   ${secret}
                Log    ${var}
                Unsuppress Logging                                #enable Robot Framework logging
                ${user}=    Get Decrypted Text    ${enc_user}     #decrypts cipher text and returns plain text
                Input Text      id:input_username    ${user}
                ${password}=    Get Decrypted Text    ${enc_pwd}  #decrypts cipher text and returns plain text
                Input Password    id:input_password    ${password}
                Click Button    id:button_login
                Page Should Contain Element    //a[text()='Logout']
                [Teardown]   Close Browser
        
        in this case the decryption password for the private key.
        It can also be saved on test env persistently as a hash.
        
        The parameter **variable_decryption** in the Library call, if set to true it will automatically decode ALL passwords defined in the variables section
        and then ``"Get Decrypted Text"`` isn't needed.
        
        |
        
        Menu walkthrough
        ----------------
        
        |
        
        CryptoLibrary Command Line Tool
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        This Command Line tool has to be used to create a key pair.
        It can also show the public key and encrypt or decrypt data.
        
        ``python -m CryptoLibrary``::
        
         ? What do you want to do?  (Use arrow keys)
           Encrypt
           Decrypt
           Open config --->  ? What do you want to do?  (Use arrow keys)
           Quit                 Configure key pair    ----------------------------------------------------------------------------------------->  ? What do you want to do?  (Use arrow keys)
                                Configure public key  --->  ? What do you want to do?  (Use arrow keys)                                             Generate key pair
                                Back                          Set public key from string  --->   ? Input public_key as Base64:  ThePublicKey        Set key pair from file
                                                              Get public key from string  --->   Public Key: ThePublicKey                           Set key pair from string
                                                              Delete public key           --->   ? Do you really want to delete public key?         Delete key pair
                                                              Back                                                                                  Save private key password
                                                                                                                                                    Delete saved password
                                                                                                                                                    Back
         ? What do you want to do?  (Use arrow keys)
           Encrypt     ------------------------------------------------------------------->   ? Enter the password to encrypt  YourPassword
           Decrypt     -----> ? Input encrypted cipher text:  crypt:TheEncryptedPassword      Encrypted password: (use inlc. "crypt:")
           Open config        ? Enter the password to decrypt  **********
           Quit               Your password is: YourPassword                                  crypt:TheEncryptedPassword=
        
        To start using the CryptoLibrary, start ``python -m CryptoLibrary`` and choose ``Open config`` -> ``Configure key pair``-> ``Generate key pair``.
        
        This generates the private and public keys in the ``private_key.json`` and ``public_key.key`` files.
        The ``private_key.json`` is needed to decrypt the values on your test server and has to be copied manually or added through the CLI interface.
        See ``Set key pair from...`` above.
        
        Next you can encrypt the values needed on your test server, looking something like ``crypt:nkpEPOVKfOko3t04XxOupA+F/ANTEuR9aQuPaPeMBGBQenwYf6UNESEl9MWRKGuj60ZWd10=``
        
        There are two options to decrypt your values in the robot file. When CryptoLibrary is loaded with ``variable_decryption=True``,
        ALL variables defined in that section, will automatically get decrypted.
        When the option is turned off (the default) the keyword ``Get Decrypted Text`` explicitly decrypts specific values.
        
        |
        
        CryptoClient Command Line Tool
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        This CryptoClient command line tool is the tool for all test designers that want to encrypt data.
        I can only import and show the public key and encrypt data.
        
        ``python -m CryptoClient``::
        
         ? What do you want to do?  (Use arrow keys)
           Encrypt     --------------------------------------------------------------------------------------->   ? Enter the password to encrypt  YourPassword
           Open config -----> ? What do you want to do?  (Use arrow keys)                                           Encrypted password: (use inlc. "crypt:")
           Quit                 Set public key from string  --->   ? Input public_key as Base64:  ThePublicKey
                                Get public key from string  --->   Public Key: ThePublicKey                         crypt:TheEncryptedPassword
                                Delete public key           --->   ? Do you really want to delete public key?
                                Back
        
        |
        
        SeleniumLibrary Plugin
        ----------------------
        
        CryptoLibrary.Plugin is a SeleniumLibrary Plugin.
        When taken into usage, the ``Input Password`` Keyword can now handle decrypted cipher texts as well.
        
        Example:
        
        .. code :: robotframework
        
            *** Settings ***
            Library    SeleniumLibrary    plugins=CryptoLibrary.Plugin
        
        
            *** Variables ***
            ${Admins-Password}=    crypt:fQ5Iqn/j2lN8rXwimyz0JXlYzD0gTsPRwb0YJ3YSvDchkvDpfwYDmhHxsZ2i7bIQDlsWKJVhBb+Dz4w=
        
        
            *** Test Cases ***
            Decrypt as Plugin
                Open Browser      http://www.keyword-driven.de
                Input Text        input_username    admin
                Input Password    input_password    ${Admins-Password}
        
        |
        
        This is still a Proof of Concept !!11!!1 ;-)
        --------------------------------------------
        
        It may happen that keywords changes.
        i try not to do, but it can happen.
        Feel free to make a pull Request to improve docs or write some tests for it.
        
            
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Acceptance
Classifier: Framework :: Robot Framework
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
