.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs
   * for H5
   + for H6

.. _external_system_integration_management:

External System Integration Management
--------------------------------------
The External Systems Integration page allows administrators to configure
connections to external systems.
Some features in EDG require a connection to an Amazon S3 bucket.
This page is used to maintain the configured buckets. These buckets can then
be used in the :ref:`attachments_panel`, to :ref:`export_to_s3` from the Basket,
Corpora, and :ref:`edg_backup_and_restore`.

.. figure:: _images/edg_s3_bucket_config.jpeg
  :alt: TopBraid EDG S3 Bucket Configuration Page
  :align: center
  :class: edg-figure
  
  **TopBraid EDG S3 Bucket Configuration Page**

* **Bucket** - the name of the Amazon S3 bucket
* **Region** - the bucket's region
* **Authentication type** - Credentials or environment
* **Folder** - optional, for when using folders

.. seealso::
   See AWS for more details on creating access keys:
   https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey

Once the required information has been entered and saved, the
**Test Connection** button is enabled, allowing the settings to be verified.
If there any issues connecting to the configured bucket, detailed information
can be found in the workspace logs.