Fix an issue with pydantic 2.11 schema changes, and add additional documentation (#29)

Author: ofiriluz

ark_sdk_python/args/ark_pydantic_argparse.py

@@ -514,6 +514,7 @@ def schema_to_argparse(
                     'properties' not in schema['properties'][prop_name]
                     and (
                         'additionalProperties' in schema['properties'][prop_name]
+                        and isinstance(schema['properties'][prop_name]['additionalProperties'], dict)
                         and 'type' in schema['properties'][prop_name]['additionalProperties']
                         and len(schema['properties'][prop_name]['additionalProperties']) == 1
                     )

docs/howto/enduser_rdp_workflow.md

@@ -0,0 +1,27 @@
+---
+title: End-user rdp workflow
+description: End-user rdp Workflow
+---
+
+# End-user rdp Workflow
+Here is an example workflow for connecting to a windows box using rdp:
+
+1. Install Ark SDK: `pip3 install ark-sdk-python`
+1. Create a profile:  
+    * Interactively:
+        ```shell linenums="0"
+        ark configure
+        ```
+    * Silently:
+        ```shell linenums="0"
+        ark configure --silent --work-with-isp --isp-username myuser
+        ```
+1. Log in to Ark:
+    ```shell linenums="0"
+    ark login --silent --isp-secret <my-ark-secret>
+    ```
+1. Get a short-lived SSO RDP file for a windows box from the SIA service:
+    ```shell linenums="0"
+    ark exec dpa sso short-lived-rdp-file -ta targetaddress -td targetdomain -tu targetuser
+    ```
+1. Use the RDP file with mstsc or any other RDP client to connect

docs/howto/enduser_ssh_workflow.md

@@ -0,0 +1,30 @@
+---
+title: End-user ssh workflow
+description: End-user ssh Workflow
+---
+
+# End-user ssh Workflow
+Here is an example workflow for connecting to a linux box using ssh:
+
+1. Install Ark SDK: `pip3 install ark-sdk-python`
+1. Create a profile:  
+    * Interactively:
+        ```shell linenums="0"
+        ark configure
+        ```
+    * Silently:
+        ```shell linenums="0"
+        ark configure --silent --work-with-isp --isp-username myuser
+        ```
+1. Log in to Ark:
+    ```shell linenums="0"
+    ark login --silent --isp-secret <my-ark-secret>
+    ```
+1. Get a short-lived SSH private key for a linux box from the SIA service:
+    ```shell linenums="0"
+    ark exec sia sso short-lived-ssh-key
+    ```
+1. Log in directly to the linux box:
+    ```shell linenums="0"
+    ssh -i ~/.ssh/sia_ssh_key.pem myuser@suffix@targetuser@targetaddress@sia_proxy
+    ```

mkdocs.yml

@@ -14,6 +14,8 @@ nav:
       - Work with Ark cache: howto/working_with_ark_cache.md
       - End-user database workflow: howto/enduser_databases_workflow.md  
       - End-user Kubernetes workflow: howto/enduser_kubernetes_workflow.md
+      - End-user SSH workflow: howto/enduser_ssh_workflow.md
+      - End-user RDP workflow: howto/enduser_rdp_workflow.md
       - Simple commands workflow: howto/simple_commands_workflow.md
       - Simple SDK workflow: howto/simple_sdk_workflow.md
       - Refresh authentication: howto/refreshing_authentication.md