Confluence source connector: Also allow PATs for Ingest v2 authentication only (#434)

Author: Paul-Cornell

snippets/general-shared-text/confluence-cli-api.mdx

@@ -11,7 +11,11 @@ import AdditionalIngestDependencies from '/snippets/general-shared-text/ingest-d
 The following environment variables:
 
 - `CONFLUENCE_URL` - The URL of the Confluence instance, represented by `--url` (CLI) or `url` (Python).
-- `CONFLUENCE_API_TOKEN` - The value of the Confluence API token for authenticating with the Confluence instance, represented by `--api-token` (CLI) or `api_token` (Python).
+- One of the following:
+
+  - `CONFLUENCE_API_TOKEN` - The value of the Confluence API token for authenticating with the Confluence instance, represented by `--api-token` (CLI) or `api_token` (Python).
+  - `CONFLUENCE_ACCESS_TOKEN` - The value of the Confluence personal access token for authenticating with the Confluence instance, represented by `--access-token` (CLI) or `access_token` (Python).
+
 - `CONFLUENCE_USER_EMAIL` - The user's email address for authenticating with the Confluence instance, represented by `--user-email` (CLI) or `user_email` (Python).
 
 Additional settings include:

snippets/general-shared-text/confluence.mdx

@@ -13,5 +13,9 @@ allowfullscreen
 - A [Confluence user](https://confluence.atlassian.com/doc/add-and-invite-users-138313.html) with 
   the correct [permissions](https://support.atlassian.com/confluence-cloud/docs/what-are-confluence-cloud-permissions-and-restrictions/) to 
   access the target spaces and pages in the Confluence instance.
-- A [Confluence API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) for the target Confluence user.
+- One of the following:
+
+  - A [Confluence Cloud API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) for the target Confluence user.
+  - For Unstructured Ingest only, a [Confluence personal access token](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html) for the target Confluence user.
+
 - Optionally, the names of the specific [spaces](https://support.atlassian.com/confluence-cloud/docs/navigate-spaces/) in the Confluence instance to access.

snippets/source_connectors/confluence.sh.mdx

@@ -7,6 +7,8 @@ unstructured-ingest \
     --spaces luke,paul \
     --user-email $CONFLUENCE_USER_EMAIL \
     --api-token $CONFLUENCE_API_TOKEN \
+    # Or:
+    # --access-token $CONFLUENCE_ACCESS_TOKEN \
     --output-dir $LOCAL_FILE_OUTPUT_DIR \
     --partition-by-api \
     --api-key $UNSTRUCTURED_API_KEY \

snippets/source_connectors/confluence.v2.py.mdx

@@ -26,7 +26,11 @@ if __name__ == "__main__":
         ),
         downloader_config=ConfluenceDownloaderConfig(download_dir=os.getenv("LOCAL_FILE_DOWNLOAD_DIR")),
         source_connection_config=ConfluenceConnectionConfig(
-            access_config=ConfluenceAccessConfig(api_token=os.getenv("CONFLUENCE_API_TOKEN")),
+            access_config=ConfluenceAccessConfig(
+                api_token=os.getenv("CONFLUENCE_API_TOKEN")
+                # Or:
+                # access_token=os.getenv("CONFLUENCE_ACCESS_TOKEN")
+            ),
             url=os.getenv("CONFLUENCE_URL"),
             user_email=os.getenv("CONFLUENCE_USER_EMAIL")
         ),