Version 2.0.0

Author: ofiriluz

README.md

@@ -31,7 +31,9 @@ CyberArk's Official SDK and CLI for different services operations
 - [x] Services API
     - [x] SIA VM / Databases Policies and Policies Interactive Editor Service
     - [x] SIA Databases Onboarding
+    - [x] SIA Target Sets Onboarding
     - [x] SIA Databases Secrets
+    - [x] SIA VM Secrets
     - [x] SIA Certificates Service
     - [x] SIA SSO Service
     - [x] SIA K8S Service
@@ -41,9 +43,11 @@ CyberArk's Official SDK and CLI for different services operations
     - [x] Identity Roles Service
     - [x] Identity Policies Service
     - [x] Identity Directories Service
+    - [x] Identity Connectors Service
     - [x] PCloud Accounts Service
     - [x] PCloud Safes Service
     - [x] PCloud Platforms Service
+    - [x] PCloud Applications Service
 - [x] All services contains CRUD and Statistics per respective service
 - [x] Ready to use SDK in Python
 - [x] CLI and SDK Examples
@@ -230,6 +234,7 @@ The following services and commands are supported:
     - <b>accounts</b> - PCloud Accounts Management
     - <b>safes</b> - PCloud Safes Management
     - <b>platforms</b> - PCloud Platforms Management
+    - <b>applications</b> - PCloud Applications Management
 
 Any command has its own subcommands, with respective arguments
 

ark_sdk_python/ark_api.py

@@ -307,3 +307,15 @@ def pcloud_platforms(self) -> "ArkPCloudPlatformsService":
         from ark_sdk_python.services.pcloud.platforms import ArkPCloudPlatformsService
 
         return cast(ArkPCloudPlatformsService, self.service(ArkPCloudPlatformsService))
+
+    @property
+    def pcloud_applications(self) -> "ArkPCloudApplicationsService":
+        """
+        Returns the PCloud Applications service if the appropriate authenticators were given
+
+        Returns:
+            ArkPCloudApplicationsService: _description_
+        """
+        from ark_sdk_python.services.pcloud.applications import ArkPCloudApplicationsService
+
+        return cast(ArkPCloudApplicationsService, self.service(ArkPCloudApplicationsService))

ark_sdk_python/models/actions/services/ark_pcloud_exec_action_consts.py

@@ -19,6 +19,17 @@
     ArkPCloudUpdateAccountCredentialsInVault,
     ArkPCloudVerifyAccountCredentials,
 )
+from ark_sdk_python.models.services.pcloud.applications import (
+    ArkPCloudAddApplication,
+    ArkPCloudAddApplicationAuthMethod,
+    ArkPCloudApplicationAuthMethodsFilter,
+    ArkPCloudApplicationsFilter,
+    ArkPCloudDeleteApplication,
+    ArkPCloudDeleteApplicationAuthMethod,
+    ArkPCloudGetApplication,
+    ArkPCloudGetApplicationAuthMethod,
+    ArkPCloudListApplicationAuthMethods,
+)
 from ark_sdk_python.models.services.pcloud.platforms import (
     ArkPCloudActivateTargetPlatform,
     ArkPCloudDeactivateTargetPlatform,
@@ -120,12 +131,32 @@
     schemas=PCLOUD_PLATFORMS_ACTION_TO_SCHEMA_MAP,
 )
 
+# PCloud Applications Definitions
+PCLOUD_APPLICATIONS_ACTION_TO_SCHEMA_MAP: Final[Dict[str, Optional[Type[ArkModel]]]] = {
+    'add-application': ArkPCloudAddApplication,
+    'delete-application': ArkPCloudDeleteApplication,
+    'list-applications': None,
+    'list-applications-by': ArkPCloudApplicationsFilter,
+    'application': ArkPCloudGetApplication,
+    'applications-stats': None,
+    'add-application-auth-method': ArkPCloudAddApplicationAuthMethod,
+    'delete-application-auth-method': ArkPCloudDeleteApplicationAuthMethod,
+    'list-application-auth-methods': ArkPCloudListApplicationAuthMethods,
+    'list-application-auth-methods-by': ArkPCloudApplicationAuthMethodsFilter,
+    'application-auth-method': ArkPCloudGetApplicationAuthMethod,
+}
+PCLOUD_APPLICATIONS_ACTION: Final[ArkServiceActionDefinition] = ArkServiceActionDefinition(
+    action_name='applications',
+    schemas=PCLOUD_APPLICATIONS_ACTION_TO_SCHEMA_MAP,
+)
+
 # Service Actions Definition
 PCLOUD_ACTIONS: Final[ArkServiceActionDefinition] = ArkServiceActionDefinition(
     action_name='pcloud',
     subactions=[
         PCLOUD_ACCOUNTS_ACTION,
         PCLOUD_PLATFORMS_ACTION,
         PCLOUD_SAFES_ACTION,
+        PCLOUD_APPLICATIONS_ACTION,
     ],
 )

ark_sdk_python/models/services/pcloud/applications/__init__.py

@@ -0,0 +1,37 @@
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_add_application import ArkPCloudAddApplication
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_add_application_auth_method import ArkPCloudAddApplicationAuthMethod
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application import ArkPCloudApplication
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application_auth_method import (
+    ArkPCloudApplicationAuthMethod,
+    ArkPCloudApplicationAuthMethodCertKeyVal,
+    ArkPCloudApplicationAuthMethodType,
+)
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application_auth_methods_filter import (
+    ArkPCloudApplicationAuthMethodsFilter,
+)
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_applications_filter import ArkPCloudApplicationsFilter
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_applications_stats import ArkPCloudAppicationsStats
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_delete_application import ArkPCloudDeleteApplication
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_delete_application_auth_method import (
+    ArkPCloudDeleteApplicationAuthMethod,
+)
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_get_application import ArkPCloudGetApplication
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_get_application_auth_method import ArkPCloudGetApplicationAuthMethod
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_list_application_auth_methods import ArkPCloudListApplicationAuthMethods
+
+__all__ = [
+    'ArkPCloudAddApplication',
+    'ArkPCloudAddApplicationAuthMethod',
+    'ArkPCloudApplication',
+    'ArkPCloudApplicationAuthMethod',
+    'ArkPCloudApplicationAuthMethodCertKeyVal',
+    'ArkPCloudApplicationAuthMethodType',
+    'ArkPCloudApplicationAuthMethodsFilter',
+    'ArkPCloudApplicationsFilter',
+    'ArkPCloudAppicationsStats',
+    'ArkPCloudDeleteApplication',
+    'ArkPCloudDeleteApplicationAuthMethod',
+    'ArkPCloudGetApplication',
+    'ArkPCloudGetApplicationAuthMethod',
+    'ArkPCloudListApplicationAuthMethods',
+]

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_add_application.py

@@ -0,0 +1,22 @@
+from datetime import date, timedelta
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkTitleizedModel
+
+
+class ArkPCloudAddApplication(ArkTitleizedModel):
+    app_id: str = Field(description='ID of the application')
+    description: str = Field(description='Description of the application', default='')
+    location: str = Field(description='Location of the application in the vault', default='\\')
+    access_permitted_from: int = Field(description='Start time the access is permitted in hours', default=0)
+    access_permitted_to: int = Field(description='End time the access is permitted in hours', default=24)
+    expiration_date: str = Field(
+        description='Expiratin date of the application in format mm/dd/yyyy',
+        default=(date.today() + timedelta(days=30)).strftime('%m/%d/%Y'),
+    )
+    disabled: bool = Field(description='Whether application is disabled or not', default=False)
+    business_owner_first_name: str = Field(description='First name of the owner', default='', alias='BusinessOwnerFName')
+    business_owner_last_name: str = Field(description='Last name of the owner', default='', alias='BusinessOwnerLName')
+    business_owner_email: str = Field(description='Email of the owner', default='', alias='BusinessOwnerEmail')
+    business_owner_phone: str = Field(description='Phone of the owner', default='', alias='BusinessOwnerPhone')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_add_application_auth_method.py

@@ -0,0 +1,37 @@
+from typing import List, Optional
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkTitleizedModel
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application_auth_method import (
+    ArkPCloudApplicationAuthMethodCertKeyVal,
+    ArkPCloudApplicationAuthMethodType,
+)
+
+
+class ArkPCloudAddApplicationAuthMethod(ArkTitleizedModel):
+    app_id: str = Field(description='ID of the app to add the auth method for')
+    auth_type: ArkPCloudApplicationAuthMethodType = Field(description='Type of the authentication')
+
+    # Applied for Certificate serial number, ip, os user, hash, path
+    auth_value: Optional[str] = Field(default=None, description='Value of the authentication')
+
+    # Path type extras
+    is_folder: Optional[bool] = Field(default=None, description='For path in the machine, whether its a folder or not')
+    allow_internal_scripts: Optional[bool] = Field(default=None, description='Whether internal scripts are allowed on the folder or not')
+
+    # Hash, certificate serial number, certificate type extras
+    comment: Optional[str] = Field(default=None, description='Comment for the hash')
+
+    # Kubernetes type extras, only one of them should exist
+    namespace: Optional[str] = Field(default=None, description='Kube namespace')
+    image: Optional[str] = Field(default=None, description='Kube container image')
+    env_var_name: Optional[str] = Field(default=None, description='Kube env var name')
+    env_var_value: Optional[str] = Field(default=None, description='Kube env var value')
+
+    # Certificate type extras
+    subject: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(default=None, description='Subject of the certificate')
+    issuer: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(default=None, description='Issuer of the certificate')
+    subject_alternative_name: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(
+        default=None, description='SAN of the certificate'
+    )

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_application.py

@@ -0,0 +1,17 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkTitleizedModel
+
+
+class ArkPCloudApplication(ArkTitleizedModel):
+    app_id: str = Field(description='ID of the application', alias='AppID')
+    description: str = Field(description='Description of the application')
+    location: str = Field(description='Location of the application in the vault')
+    access_permitted_from: int = Field(description='Start time the access is permitted in hours')
+    access_permitted_to: int = Field(description='End time the access is permitted in hours')
+    expiration_date: str = Field(description='Expiratin date of the application in format mm-dd-yyyy')
+    disabled: bool = Field(description='Whether application is disabled or not')
+    business_owner_first_name: str = Field(description='First name of the owner', alias='BusinessOwnerFName')
+    business_owner_last_name: str = Field(description='Last name of the owner', alias='BusinessOwnerLName')
+    business_owner_email: str = Field(description='Email of the owner', alias='BusinessOwnerEmail')
+    business_owner_phone: str = Field(description='Phone of the owner', alias='BusinessOwnerPhone')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_application_auth_method.py

@@ -0,0 +1,49 @@
+from enum import Enum
+from typing import List, Optional
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel, ArkTitleizedModel
+
+
+class ArkPCloudApplicationAuthMethodType(str, Enum):
+    Hash = 'hash'
+    OsUser = 'osUser'
+    IP = 'machineAddress'
+    Path = 'path'
+    CertificateSerialNumber = 'certificateSerialNumber'
+    Kubernetes = 'Kubernetes'
+    Certificate = 'certificateattr'
+
+
+class ArkPCloudApplicationAuthMethodCertKeyVal(ArkModel):
+    key: str = Field(description='Key of the field')
+    value: str = Field(description='Value of the field')
+
+
+class ArkPCloudApplicationAuthMethod(ArkTitleizedModel):
+    auth_id: str = Field(description='ID of the auth method', alias='authID')
+    auth_type: ArkPCloudApplicationAuthMethodType = Field(description='Type of the authentication')
+
+    # Applied for Certificate serial number, ip, os user, hash, path
+    auth_value: Optional[str] = Field(default=None, description='Value of the authentication')
+
+    # Path type extras
+    is_folder: Optional[bool] = Field(default=None, description='For path in the machine, whether its a folder or not')
+    allow_internal_scripts: Optional[bool] = Field(default=None, description='Whether internal scripts are allowed on the folder or not')
+
+    # Hash, certificate serial number, certificate type extras
+    comment: Optional[str] = Field(default=None, description='Comment for the hash')
+
+    # Kubernetes type extras, only one of them should exist
+    namespace: Optional[str] = Field(default=None, description='Kube namespace')
+    image: Optional[str] = Field(default=None, description='Kube container image')
+    env_var_name: Optional[str] = Field(default=None, description='Kube env var name')
+    env_var_value: Optional[str] = Field(default=None, description='Kube env var value')
+
+    # Certificate type extras
+    subject: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(default=None, description='Subject of the certificate')
+    issuer: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(default=None, description='Issuer of the certificate')
+    subject_alternative_name: Optional[List[ArkPCloudApplicationAuthMethodCertKeyVal]] = Field(
+        default=None, description='SAN of the certificate'
+    )

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_application_auth_methods_filter.py

@@ -0,0 +1,11 @@
+from typing import List, Optional
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application_auth_method import ArkPCloudApplicationAuthMethodType
+
+
+class ArkPCloudApplicationAuthMethodsFilter(ArkModel):
+    app_id: str = Field(description='App id to filter on')
+    auth_types: Optional[List[ArkPCloudApplicationAuthMethodType]] = Field(default=None, description='Auth types to filter with')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_applications_filter.py

@@ -0,0 +1,12 @@
+from typing import Optional
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudApplicationsFilter(ArkModel):
+    location: Optional[str] = Field(default=None, description='Filter by location of the app')
+    only_enabled: Optional[bool] = Field(default=None, description='Filter only enabled apps')
+    business_owner_name: Optional[str] = Field(default=None, description='Filter by name, first or last')
+    business_owner_email: Optional[str] = Field(default=None, description='Filter by email')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_applications_stats.py

@@ -0,0 +1,15 @@
+from typing import Dict, List
+
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+from ark_sdk_python.models.services.pcloud.applications.ark_pcloud_application_auth_method import ArkPCloudApplicationAuthMethodType
+
+
+class ArkPCloudAppicationsStats(ArkModel):
+    count: int = Field(description='Overall application count')
+    disabled_apps: List[str] = Field(description='Disabled applications')
+    auth_types_count: Dict[ArkPCloudApplicationAuthMethodType, int] = Field(description='Auth types count for all applications')
+    applications_auth_method_types: Dict[str, List[ArkPCloudApplicationAuthMethodType]] = Field(
+        description='Applicastions auth methods types'
+    )

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_delete_application.py

@@ -0,0 +1,7 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudDeleteApplication(ArkModel):
+    app_id: str = Field(description='ID of the app to delete')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_delete_application_auth_method.py

@@ -0,0 +1,8 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudDeleteApplicationAuthMethod(ArkModel):
+    app_id: str = Field(description='ID of the app to delete the auth method from')
+    auth_id: str = Field(description='ID of the auth method to delete')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_get_application.py

@@ -0,0 +1,7 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudGetApplication(ArkModel):
+    app_id: str = Field(description='ID of the app to get')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_get_application_auth_method.py

@@ -0,0 +1,8 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudGetApplicationAuthMethod(ArkModel):
+    app_id: str = Field(description='ID of the app to get the auth method from')
+    auth_id: str = Field(description='ID of the auth method to get')

ark_sdk_python/models/services/pcloud/applications/ark_pcloud_list_application_auth_methods.py

@@ -0,0 +1,7 @@
+from pydantic import Field
+
+from ark_sdk_python.models import ArkModel
+
+
+class ArkPCloudListApplicationAuthMethods(ArkModel):
+    app_id: str = Field(description='ID of the app to list the auth methods from')

ark_sdk_python/services/pcloud/accounts/ark_pcloud_accounts_service.py

@@ -35,7 +35,7 @@
 from ark_sdk_python.services.pcloud.common import ArkPCloudBaseService
 
 SERVICE_CONFIG: Final[ArkServiceConfig] = ArkServiceConfig(
-    service_name='pcloud-accounts', required_authenticator_names=[], optional_authenticator_names=['isp', 'pvwa', 'pcloud_im']
+    service_name='pcloud-accounts', required_authenticator_names=[], optional_authenticator_names=['isp']
 )
 ACCOUNTS_URL: Final[str] = 'accounts'
 ACCOUNT_URL: Final[str] = 'accounts/{account_id}'

ark_sdk_python/services/pcloud/applications/__init__.py

@@ -0,0 +1,3 @@
+from ark_sdk_python.services.pcloud.applications.ark_pcloud_applications_service import ArkPCloudApplicationsService
+
+__all__ = ['ArkPCloudApplicationsService']