update creds_manager.py

Author: greyshell

basic/play.py alpha_learning/play.pybasic/play.py renamed to alpha_learning/play.py

@@ -1,3 +1,5 @@
+# helper script to create the hashtable
+
 from math import sqrt
 
 MAX = 10 ** 6

basic/quxes_fb.py alpha_learning/quxes_fb.pybasic/quxes_fb.py renamed to alpha_learning/quxes_fb.py

@@ -20,6 +20,8 @@ def main():
         "carol": "it"
     }
 
+    print(f"{name_dept}")  # ordered structure
+
     # look up: method 1
     try:
         dept = name_dept["no_key"]  # throws exception when the key is not found
@@ -44,11 +46,11 @@ def main():
     print(f"{name_dept.items()}")  # returns a list, each entry is tuple
 
     # print the dict: method 1
-    for key, value in name_dept.items():
+    for key, value in name_dept.items():  # unpacks the tuples
         print(f"{key}: {value}")
 
     # print the dict: method 2
-    for key, value in name_dept:
+    for key in name_dept:  # __iter__() => iterates over the keys, similar to name_dept.keys()
         print(f"{key}: {name_dept[key]}")
 
 

ds_algo/dict/test/test_dict.py

@@ -0,0 +1,36 @@
+## Description
+`creds_manager.py` - a wrapper to the linux `keyring` that manages the credential in a secure way.
+
+
+### Usage
+```
+usage: creds_manager.py [-h] {set,get,del} ...
+
+a helper script / wrapper to perform all keyring operations
+
+optional arguments:
+  -h, --help     show this help message and exit
+
+commands:
+  {set,get,del}  See '[command] --help' for details
+    set          set up a keyring
+    get          get credentials from a keyring
+    del          delete a keyring
+
+```
+
+```
+usage: creds_manager.py set [-h] -n  -u  -p
+
+set up a keyring
+
+optional arguments:
+  -h, --help        show this help message and exit
+  -n , --name       provide the keyring name
+  -u , --username   provide the username
+  -p , --password   provide the password
+```
+
+ 
+
+

utility_scripts/creds_manager/README.md

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+
+# author: greyshell
+# description: a helper script / wrapper to perform all keyring operations
+
+
+import argparse
+import sys
+
+import keyring
+
+
+class UserInput:
+    def __init__(self):
+        self.parser = argparse.ArgumentParser(
+                description="a helper script / wrapper to perform all keyring operations")
+        self.subparsers = self.parser.add_subparsers(title="commands", help="See '[command] --help' for details")
+
+        # set a keyring
+        self.set_keyring_parser = self.subparsers.add_parser("set", description="set up a keyring",
+                                                             help="set up a keyring")
+        self.set_keyring_parser.add_argument("-n", "--name", metavar="",
+                                             help="provide the keyring name", required=True)
+        self.set_keyring_parser.add_argument("-u", "--username", metavar="",
+                                             help="provide the username", required=True)
+        self.set_keyring_parser.add_argument("-p", "--password", metavar="",
+                                             help="provide the password", required=True)
+        self.set_keyring_parser.set_defaults(cmd="set")
+
+        # get a keyring
+        self.get_keyring_parser = self.subparsers.add_parser("get", description="get credentials from a keyring",
+                                                             help="get credentials from a keyring")
+        self.get_keyring_parser.add_argument("-n", "--name", metavar="",
+                                             help="provide the keyring name", required=True)
+        self.get_keyring_parser.set_defaults(cmd="get")
+
+        # delete a keyring
+        self.del_keyring_parser = self.subparsers.add_parser("del", description="delete a keyring",
+                                                             help="delete a keyring")
+        self.del_keyring_parser.add_argument("-n", "--name", metavar="",
+                                             help="provide the keyring name", required=True)
+        self.del_keyring_parser.set_defaults(cmd="del")
+
+
+def set_keyring(keyring_name, username, password):
+    keyring.set_password(keyring_name, "username", username)
+    keyring.set_password(keyring_name, username, password)
+
+
+def get_keyring(keyring_name):
+    username = keyring.get_password(keyring_name, "username")
+    password = keyring.get_password(keyring_name, str(username))
+    return username, password
+
+
+def del_keyring(keyring_name):
+    username, password = get_keyring(keyring_name)
+    try:
+        keyring.delete_password(keyring_name, "username")
+        keyring.delete_password(keyring_name, username)
+    except keyring.errors.PasswordDeleteError as e:
+        print(e)
+        return False
+    return True
+
+
+if __name__ == "__main__":
+    my_input = UserInput()
+    args = my_input.parser.parse_args()
+
+    if len(sys.argv) == 1:
+        my_input.parser.print_help(sys.stderr)
+        sys.exit(0)
+
+    if args.cmd == "set":
+        set_keyring(args.name, args.username, args.password)
+        print(f"credential is set !!")
+    elif args.cmd == "get":
+        usr, passwd = get_keyring(args.name)
+        print(f"username: {usr}, password: {passwd}")
+    elif args.cmd == "del":
+        if del_keyring(args.name):
+            print(f"deleted -> {args.name}")
+    else:
+        my_input.parser.print_help(sys.stderr)

utility_scripts/creds_manager/creds_manager.py

@@ -1,7 +1,8 @@
 ## Description
-`lab-vpn.py` helps to automate the openvpn connection for the InfoSec labs (i.e. PWK / CTP / WAPTx / AWAE).
+`lab_vpn.py` helps to automate the openvpn connection for the InfoSec labs (i.e. PWK / CTP / WAPTx / AWAE).
 
-note: store your vpn and email password inside linux keyring.
+note:
+- you can use `creds_manager.py` helper script to store your vpn and email password in linux keyring.
 
 ### Usage
 ```
@@ -16,17 +17,16 @@ optional arguments:
 example:
 python lab_vpn.py -c asinha.json
 
-
 # set email creds into the keyring
 keyring set email username
 - provide the email_id
 keyring set email email_id
 - provide the password
 
 # set offsec vpn creds into the keyring
-keyring set offsec_asinha username
-- provide the offsecID
-keyring set offsec_asinha offsecID
+keyring set offsec username
+- provide the userid
+keyring set offsec user_id
 - provide the password
 ```