pangea-sdk 3.8.0__py3-none-any.whl → 3.8.0b2__py3-none-any.whl

pangea/services/authz.py

@@ -1,377 +0,0 @@
-# Copyright 2022 Pangea Cyber Corporation
-# Author: Pangea Cyber Corporation
-
-import enum
-from typing import Any, Dict, List, Optional, Union
-
-from pangea.response import APIRequestModel, APIResponseModel, PangeaResponse, PangeaResponseResult
-from pangea.services.base import ServiceBase
-
-
-class ItemOrder(str, enum.Enum):
-    ASC = "asc"
-    DESC = "desc"
-
-    def __str__(self):
-        return str(self.value)
-
-    def __repr__(self):
-        return str(self.value)
-
-
-class TupleOrderBy(str, enum.Enum):
-    RESOURCE_TYPE = "resource_type"
-    RESOURCE_ID = "resource_id"
-    RELATION = "relation"
-    SUBJECT_TYPE = "subject_type"
-    SUBJECT_ID = "subject_id"
-    SUBJECT_ACTION = "subject_action"
-
-    def __str__(self):
-        return str(self.value)
-
-    def __repr__(self):
-        return str(self.value)
-
-
-class Resource(PangeaResponseResult):
-    type: str
-    id: Optional[str] = None
-
-
-class Subject(PangeaResponseResult):
-    type: str
-    id: Optional[str] = None
-    action: Optional[str] = None
-
-
-class Tuple(PangeaResponseResult):
-    resource: Resource
-    relation: str
-    subject: Subject
-
-
-class TupleCreateRequest(APIRequestModel):
-    tuples: List[Tuple]
-
-
-class TupleCreateResult(PangeaResponseResult):
-    pass
-
-
-class TupleListFilter(APIRequestModel):
-    resource_type: Optional[str] = None
-    resource_type__contains: Optional[List[str]] = None
-    resource_type__in: Optional[List[str]] = None
-    resource_id: Optional[str] = None
-    resource_id__contains: Optional[List[str]] = None
-    resource_id__in: Optional[List[str]] = None
-    relation: Optional[str] = None
-    relation__contains: Optional[List[str]] = None
-    relation__in: Optional[List[str]] = None
-    subject_type: Optional[str] = None
-    subject_type__contains: Optional[List[str]] = None
-    subject_type__in: Optional[List[str]] = None
-    subject_id: Optional[str] = None
-    subject_id__contains: Optional[List[str]] = None
-    subject_id__in: Optional[List[str]] = None
-    subject_action: Optional[str] = None
-    subject_action__contains: Optional[List[str]] = None
-    subject_action__in: Optional[List[str]] = None
-
-
-class TupleListRequest(APIRequestModel):
-    filter: Optional[Union[Dict, TupleListFilter]] = None
-    size: Optional[int] = None
-    last: Optional[str] = None
-    order: Optional[ItemOrder] = None
-    order_by: Optional[TupleOrderBy] = None
-
-
-class TupleListResult(PangeaResponseResult):
-    tuples: List[Tuple]
-    last: str
-    count: int
-
-
-class TupleDeleteRequest(APIRequestModel):
-    tuples: List[Tuple]
-
-
-class TupleDeleteResult(PangeaResponseResult):
-    pass
-
-
-class CheckRequest(APIRequestModel):
-    resource: Resource
-    action: str
-    subject: Subject
-    debug: Optional[bool] = None
-    attributes: Optional[Dict[str, Any]] = None
-
-
-class DebugPath(APIResponseModel):
-    type: str
-    id: str
-    action: Optional[str]
-
-
-class Debug(APIResponseModel):
-    path: List[DebugPath]
-
-
-class CheckResult(PangeaResponseResult):
-    schema_id: str
-    schema_version: int
-    depth: int
-    allowed: bool
-    debug: Optional[Debug] = None
-
-
-class ListResourcesRequest(APIRequestModel):
-    type: str
-    action: str
-    subject: Subject
-
-
-class ListResourcesResult(PangeaResponseResult):
-    ids: List[str]
-
-
-class ListSubjectsRequest(APIRequestModel):
-    resource: Resource
-    action: str
-
-
-class ListSubjectsResult(PangeaResponseResult):
-    subjects: List[Subject]
-
-
-class AuthZ(ServiceBase):
-    """AuthZ service client. (Beta)
-
-    Provides methods to interact with the Pangea AuthZ Service.
-    Documentation for the AuthZ Service API can be found at
-    <https://pangea.cloud/docs/api/authz>. Note that this service is in Beta and
-    is subject to change.
-
-    Examples:
-        import os
-        from pangea.config import PangeaConfig
-        from pangea.services import AuthZ
-
-        PANGEA_TOKEN = os.getenv("PANGEA_AUTHZ_TOKEN")
-
-        authz_config = PangeaConfig(domain="aws.us.pangea.cloud")
-
-        # Setup Pangea AuthZ service client
-        authz = AuthZ(token=PANGEA_TOKEN, config=authz_config)
-    """
-
-    service_name = "authz"
-
-    def __init__(self, token: str, config=None, logger_name="pangea", config_id: Optional[str] = None):
-        super().__init__(token, config, logger_name, config_id=config_id)
-
-    def tuple_create(self, tuples: List[Tuple]) -> PangeaResponse[TupleCreateResult]:
-        """Create tuples. (Beta)
-
-        Create tuples in the AuthZ Service. The request will fail if there is no schema
-        or the tuples do not validate against the schema.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            tuples (List[Tuple]): List of tuples to be created.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with empty result.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/create).
-
-        Examples:
-            response = authz.tuple_create(
-                tuples=[
-                    Tuple(
-                        resource=Resource(type="file", id="file_1"),
-                        relation="owner",
-                        subject=Subject(type="user", id="user_1"),
-                    )
-                ]
-            )
-        """
-
-        input_data = TupleCreateRequest(tuples=tuples)
-        return self.request.post("v1/tuple/create", TupleCreateResult, data=input_data.dict(exclude_none=True))
-
-    def tuple_list(
-        self,
-        filter: TupleListFilter,
-        size: Optional[int] = None,
-        last: Optional[str] = None,
-        order: Optional[ItemOrder] = None,
-        order_by: Optional[TupleOrderBy] = None,
-    ) -> PangeaResponse[TupleListResult]:
-        """List tuples. (Beta)
-
-        Return a paginated list of filtered tuples. The filter is given in terms
-        of a tuple. Fill out the fields that you want to filter. If the filter
-        is empty it will return all the tuples.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            filter (TupleListFilter): The filter for listing tuples.
-            size (Optional[int]): The size of the result set. Default is None.
-            last (Optional[str]): The last token from a previous response. Default is None.
-            order (Optional[ItemOrder]): Order results asc(ending) or desc(ending).
-            order_by (Optional[TupleOrderBy]): Which field to order results by.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with a list of tuples and the last token.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/list).
-
-        Examples:
-            authz.tuple_list(TupleListFilter(subject_type="user", subject_id="user_1"))
-        """
-        input_data = TupleListRequest(
-            filter=filter.dict(exclude_none=True), size=size, last=last, order=order, order_by=order_by
-        )
-        return self.request.post("v1/tuple/list", TupleListResult, data=input_data.dict(exclude_none=True))
-
-    def tuple_delete(self, tuples: List[Tuple]) -> PangeaResponse[TupleDeleteResult]:
-        """Delete tuples. (Beta)
-
-        Delete tuples in the AuthZ Service.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            tuples (List[Tuple]): List of tuples to be deleted.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with empty result.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/delete).
-
-        Examples:
-            response = authz.tuple_delete(
-                tuples=[
-                    Tuple(
-                        resource=Resource(type="file", id="file_1"),
-                        relation="owner",
-                        subject=Subject(type="user", id="user_1"),
-                    )
-                ]
-            )
-        """
-
-        input_data = TupleDeleteRequest(tuples=tuples)
-        return self.request.post("v1/tuple/delete", TupleDeleteResult, data=input_data.dict(exclude_none=True))
-
-    def check(
-        self,
-        resource: Resource,
-        action: str,
-        subject: Subject,
-        debug: Optional[bool] = None,
-        attributes: Optional[Dict[str, Union[int, str]]] = None,
-    ) -> PangeaResponse[CheckResult]:
-        """Perform a check request. (Beta)
-
-        Check if a subject has permission to perform an action on the resource.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            resource (Resource): The resource to check.
-            action (str): The action to check.
-            subject (Subject): The subject to check.
-            debug (Optional[bool]): Setting this value to True will provide a detailed analysis of the check.
-            attributes (Optional[Dict[str, Union[int, str]]]): Additional attributes for the check.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with the result of the check.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/check).
-
-        Examples:
-            response = authz.check(
-                resource=Resource(type="file", id="file_1"),
-                action="update",
-                subject=Subject(type="user", id="user_1"),
-                debug=True,
-            )
-        """
-
-        input_data = CheckRequest(resource=resource, action=action, subject=subject, debug=debug, attributes=attributes)
-        return self.request.post("v1/check", CheckResult, data=input_data.dict(exclude_none=True))
-
-    def list_resources(self, type: str, action: str, subject: Subject) -> PangeaResponse[ListResourcesResult]:
-        """List resources. (Beta)
-
-        Given a type, action, and subject, list all the resources in the
-        type that the subject has access to the action with.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            type (str): The type to filter resources.
-            action (str): The action to filter resources.
-            subject (Subject): The subject to filter resources.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with a list of resource IDs.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/list-resources).
-
-        Examples:
-            authz.list_resources(
-                type="file",
-                action="update",
-                subject=Subject(type="user", id="user_1"),
-            )
-        """
-
-        input_data = ListResourcesRequest(type=type, action=action, subject=subject)
-        return self.request.post("v1/list-resources", ListResourcesResult, data=input_data.dict(exclude_none=True))
-
-    def list_subjects(self, resource: Resource, action: str) -> PangeaResponse[ListSubjectsResult]:
-        """List subjects. (Beta)
-
-        Given a resource and an action, return the list of subjects who have
-        access to the action for the given resource.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
-
-        Args:
-            resource (Resource): The resource to filter subjects.
-            action (str): The action to filter subjects.
-
-        Raises:
-            PangeaAPIException: If an API Error happens.
-
-        Returns:
-            Pangea Response with a list of subjects.
-            Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/list-subjects).
-
-        Examples:
-            response = authz.list_subjects(
-                resource=Resource(type="file", id="file_1"),
-                action="update",
-            )
-        """
-
-        input_data = ListSubjectsRequest(resource=resource, action=action)
-        return self.request.post("v1/list-subjects", ListSubjectsResult, data=input_data.dict(exclude_none=True))

pangea_sdk-3.8.0.dist-info/RECORD

@@ -1,46 +0,0 @@
-pangea/__init__.py,sha256=Nq9RV-L96OLvLWJH-nk0U5j6zZHQQSfqGSn6nkvmzWM,200
-pangea/asyncio/request.py,sha256=uvx9d1hmYhGKvbI4ecj6kIagGhPn_4bKmHN062Zz35c,17089
-pangea/asyncio/services/__init__.py,sha256=hmySN2LoXYpHzSKLVSdVjMbpGXi5Z5iNx-fJ2Fc8W6I,320
-pangea/asyncio/services/audit.py,sha256=laWnkT9WHBmwiaoGhNxJcdDBuqZ6Ce3wz8ujdavZgfM,24866
-pangea/asyncio/services/authn.py,sha256=ubxpxCwv6ON9JWYVPCX3FYp-YzHqIuLvE9IsYPQS3-8,44760
-pangea/asyncio/services/authz.py,sha256=z4HrcxjPGZ1X5akXo-nUQ3MWge6reirwdi7d8HHAMyQ,9745
-pangea/asyncio/services/base.py,sha256=4FtKtlq74NmE9myrgIt9HMA6JDnP4mPZ6krafWr286o,2663
-pangea/asyncio/services/embargo.py,sha256=8WguyWZUaGVwGpNzic5h8QzLueirA9WpBBik4mpCTeA,3056
-pangea/asyncio/services/file_scan.py,sha256=WIKYjUNCIx6jF0vQ-KnsKYBcZh53Q5rmccTlsTPP_rY,6301
-pangea/asyncio/services/intel.py,sha256=-0xAfnlAgNH774XRHX1-zIv2nr1Xra7X8tLhuCArQhE,37647
-pangea/asyncio/services/redact.py,sha256=3yuLD-TBiaqDa3OA0PRjvG3kXAifLyrENw8j2Na64-c,5665
-pangea/asyncio/services/vault.py,sha256=m851lZLN9DHp3_r_-1onmecZoFxNHCRCi4N_j288HUY,47836
-pangea/audit_logger.py,sha256=gRkCfUUT5LDNaycwxkhZUySgY47jDfn1ZeKOul4XCQI,3842
-pangea/config.py,sha256=mQUu8GX_6weIuv3vjNdG5plppXskXYASmxMWtFQh-hc,1662
-pangea/deep_verify.py,sha256=mocaGbC6XLbMTVWxTpMv4oJtXGPWpT-SbFqT3obpiZs,8443
-pangea/deprecated.py,sha256=IjFYEVvY1E0ld0SMkEYC1o62MAleX3nnT1If2dFVbHo,608
-pangea/dump_audit.py,sha256=8KrTOP64D28RFv1mvOOxe0fxlRZi8PtwnEZfvabglNA,7019
-pangea/exceptions.py,sha256=OBtzUECpNa6vNp8ySkHC-tm4QjFRCOAHBkMHqzAlOu8,5656
-pangea/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pangea/request.py,sha256=ZcK49SgCPvGwPGrY63UmiTo-xELu2ryPvALmPxPXkGI,24298
-pangea/response.py,sha256=egyLcl0FxEDmTrbRjHuB_DvxipfTXG0ExUS1yLBss-M,6828
-pangea/services/__init__.py,sha256=iAIa1kk_C0EHBsSn2XP3QT-bOZNGwMBPUcO2JoI-9cE,278
-pangea/services/audit/audit.py,sha256=TLGs4ALMEFpQSxC49SMVwRGRxUCslstHMBmSiDpC6mY,38006
-pangea/services/audit/exceptions.py,sha256=bhVuYe4ammacOVxwg98CChxvwZf5FKgR2DcgqILOcwc,471
-pangea/services/audit/models.py,sha256=IViO_WsDz_N8YjPD8pcAcPHWpf2aatd0-VJVl_o_8G4,13953
-pangea/services/audit/signing.py,sha256=pOjw60BIYDcg3_5YKDCMWZUaapsEZpCHaFhyFu7TEgc,5567
-pangea/services/audit/util.py,sha256=C6KAdu6qhValmNrIMUPLdAW0SCiLwcDd5euXti_63Og,7596
-pangea/services/authn/authn.py,sha256=C_u34ASbi3Ul3C6D6f4fqdajcGNPX2CfxKmcLjE016w,43750
-pangea/services/authn/models.py,sha256=FZ5kRBZQ-Pr2YD3jFZ4HvJI22ObbXaBb6HStjcN7-D0,18104
-pangea/services/authz.py,sha256=7bhTJFI4A2mnogLgBPETRabywPolgk1vI0qZJuIxoTw,12424
-pangea/services/base.py,sha256=lwhHoe5Juy28Ir3Mfj2lHdM58gxZRaxa2SRFi4_DBRw,3453
-pangea/services/embargo.py,sha256=WFqBreGU1FPgOSabIIkWCrXBvquYN958Un7h9P1aHSI,3885
-pangea/services/file_scan.py,sha256=tWR4D672Lxk_btSA1NcuUFkajbEhiCGMoTMm2bGtCj4,6942
-pangea/services/intel.py,sha256=t8SksNsh-r1JjLN3if4yNmx711hNjQ_1YzCX-96_xv0,51645
-pangea/services/redact.py,sha256=y_jZxUY4wmEQL2AbCOZLiV14GIweSJ1TUBnyHust80M,8298
-pangea/services/vault/models/asymmetric.py,sha256=ac2Exc66elXxO-HxBqtvLPQWNI7y_00kb6SVqBPKecA,1450
-pangea/services/vault/models/common.py,sha256=Ks6reIlWx3PU1lD0UlorcAlZV8U9T3j711iOsb6qp3o,11120
-pangea/services/vault/models/secret.py,sha256=cLgEj-_BeGkB4-pmSeTkWVyasFbaJwcEltIEcOyf1U8,481
-pangea/services/vault/models/symmetric.py,sha256=5N2n6FDStB1CLPfpd4p-6Ig__Nt-EyurhjCWfEyws2k,1330
-pangea/services/vault/vault.py,sha256=s_qGLDlk-LOSsODpnvo_VPtH_4HGgwCOprSCKCNaCfY,47619
-pangea/tools.py,sha256=sa2pSz-L8tB6GcZg6lghsmm8w0qMQAIkzqcv7dilU6Q,6429
-pangea/utils.py,sha256=nTrw0lcw4s0R2m_LFIoypFU4ilsBfjV1eCf_bTjJ-Lo,3489
-pangea/verify_audit.py,sha256=QthhKzFlIQwoEyjBLojcX4uHGaN3EEGomx-IC5e3L0E,10756
-pangea_sdk-3.8.0.dist-info/METADATA,sha256=Lc1OJgV2dQvDx9HmppMIjctCA4b2aKmFzFQ2r-pPPKQ,7464
-pangea_sdk-3.8.0.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-pangea_sdk-3.8.0.dist-info/RECORD,,