Bing Ads Integration

CHANGELOG.md

@@ -21,7 +21,7 @@ The types of changes are:
 - Added Gzip Middleware for responses [#5225](https://github.com/ethyca/fides/pull/5225)
 - Adding source and submitted_by fields to privacy requests (Fidesplus) [#5206](https://github.com/ethyca/fides/pull/5206)
 - Added Action Required / Monitored / Unmonitored tabs to Data Detection & Discovery page [#5236](https://github.com/ethyca/fides/pull/5236)
-
+- Adding erasure support for Microsoft Advertising [#5197](https://github.com/ethyca/fides/pull/5197)
 
 ### Changed
 - Removed unused `username` parameter from the Delighted integration configuration [#5220](https://github.com/ethyca/fides/pull/5220)

data/saas/config/microsoft_advertising_config.yml

@@ -0,0 +1,88 @@
+saas_config:
+  fides_key: <instance_fides_key>
+  name: Microsoft Advertising
+  type: microsoft_advertising
+  description: A sample schema representing the Microsoft Advertising integration for Fides
+  user_guide: https://docs.ethyca.com/user-guides/integrations/saas-integrations/microsoft-advertising
+  version: 0.1.0
+
+  connector_params:
+    - name: domain
+      default_value: login.microsoftonline.com 
+      description: The base URL for Microsoft Advertising Login Authentication
+    - name: client_id
+      label: Client ID
+      description: Your Microsoft Advertising application's client ID
+    - name: client_secret
+      label: Client secret
+      description: Your Microsoft Advertising application's client secret
+      sensitive: True
+    - name: dev_token
+      label: Developer token
+      description: Your Microsoft Advertising application's developer token
+      sensitive: True
+    - name: redirect_uri
+      label: Redirect URL
+      description: The Fides URL to which users will be redirected upon successful authentication
+
+  client_config:
+    protocol: https
+    host: <domain>
+    authentication:
+      strategy: oauth2_authorization_code
+      configuration:
+        expires_in: 3600
+        authorization_request:
+          method: GET
+          path: /consumers/oauth2/v2.0/authorize
+          query_params:
+            - name: client_id
+              value: <client_id>
+            - name: redirect_uri
+              value: <redirect_uri>
+            - name: response_type
+              value: code
+            - name: scope
+              value: openid profile offline_access https://ads.microsoft.com/msads.manage
+            - name: state
+              value: <state>
+        token_request:
+          method: POST
+          path: /consumers/oauth2/v2.0/token
+          headers:
+            - name: Content-Type
+              value: application/x-www-form-urlencoded
+          body: |
+            {
+              "client_id": "<client_id>",
+              "client_secret": "<client_secret>",
+              "grant_type": "authorization_code",
+              "code": "<code>",
+              "redirect_uri": "<redirect_uri>"
+            }
+        refresh_request:
+          method: POST
+          path: /consumers/oauth2/v2.0/token
+          headers:
+            - name: Content-Type
+              value: application/x-www-form-urlencoded
+          body: |
+            {
+              "client_id": "<client_id>",
+              "client_secret": "<client_secret>",
+              "grant_type": "refresh_token",
+              "refresh_token": "<refresh_token>",
+              "redirect_uri": "<redirect_uri>"
+            }
+
+  test_request:
+    request_override: microsoft_advertising_test_connection
+
+  endpoints:
+    - name: user
+      requests:
+        delete:
+          request_override: microsoft_advertising_user_delete
+          param_values:
+            - name: email
+              identity: email

data/saas/dataset/microsoft_advertising_dataset.yml

@@ -0,0 +1,5 @@
+dataset:
+  - fides_key: <instance_fides_key>
+    name: Microsoft Advertising Dataset
+    description: A sample dataset representing the Microsoft Advertising integration for Fides
+    collections: []

requirements.txt

@@ -11,6 +11,7 @@ cryptography==42.0.0
 dask==2022.9.2
 deepdiff==6.3.0
 defusedxml==0.7.1
+types-defusedxml==0.7.0.20240218
 expandvars==0.9.0
 fastapi[all]==0.111.0
 fastapi-pagination[sqlalchemy]==0.12.25

src/fides/api/schemas/saas/shared_schemas.py

@@ -1,8 +1,11 @@
 from enum import Enum
-from typing import Any, Dict, Optional
+from io import BufferedReader
+from typing import Any, Dict, List, Optional, Tuple
 
 from pydantic import BaseModel, ConfigDict
 
+RequestFile = Tuple[str, Tuple[str, BufferedReader, str]]
+
 
 class HTTPMethod(Enum):
     """Enum to represent HTTP Methods"""
@@ -26,7 +29,8 @@ class SaaSRequestParams(BaseModel):
     headers: Dict[str, Any] = {}
     query_params: Dict[str, Any] = {}
     body: Optional[str] = None
-    model_config = ConfigDict(use_enum_values=True)
+    files: Optional[List[RequestFile]] = None
+    model_config = ConfigDict(use_enum_values=True, arbitrary_types_allowed=True)
 
 
 class ConnectorParamRef(BaseModel):

src/fides/api/service/connectors/saas/authenticated_client.py

@@ -72,6 +72,7 @@ def get_authenticated_request(
             headers=request_params.headers,
             params=request_params.query_params,
             data=request_params.body,
+            files=request_params.files,
         ).prepare()
 
         # add authentication if provided