Connections

A connection is a definition of inbound and outbound file integrations. The Connections page is available from the main menu ( mceclip3.png ) and selecting the submenu items Connections or if already within the Resources pages via the connections icon (mceclip0.png).

The defined connections will be available for users to utilize when building an app. A connection can be used to pull files in using Synthesizer or push files out using Orchestrator.

mceclip0.png

Adding a New Connection

  1. Click to open the Connections screen.
  2. Click the plus icon (mceclip0.png) to add a new connection.
  3. A "Create Connection" box will appear.
  4. Name - Provide a unique name for the connection. This value is uneditable once the connection is created.
  5. Connection Type - Select the 'Connection Type' from the dropdown list.
  6. Provide values for detailed fields; these fields vary based on the connection type selection.
  7. Click 'Create'.

The new connection will appear on the 'Connections' screen and will be available for use within an app.

mceclip4.png

Connection Type Configurations

Adobe API

Defines the credentials the Syntasa application will need to establish a connection with the Adobe API providing the ability to pull eVar, sProp, Event definitions and turn on the automated auditing feature of Syntasa. There are two options to choose from, Company and Environment. For customers, it is recommended to use Company; for dev or testing environments it is recommended to use Environment. Please contact a Syntasa services professional for any guidance in creating Adobe Analytics API credentials.

  • Company
    • Company - Customer's company name registered with Adobe Analytics.
    • Username - Adobe API username.
    • Password - Adobe API password.
  • Environment
    • Environment - Select from a dropdown menu of available Adobe environments.
    • Username - Adobe API username.
    • Password - Adobe API password.

mceclip5.png

Azure Storage

Microsoft's cloud warehouse solution:

mceclip6.png

Big Query

Google's cloud warehouse solution that provides for very fast querying.

  • ProjectID - Name of the project where the BQ instance is located.
  • Use Instance Profile
    • On (green) - No further information needed.
    • Off (grey)
      • Key File Upload - JSON file with project private key.

mceclip7.png

mceclip13.png

Database

mceclip8.png

FTP

Defines host and credentials for creating FTP connector.

  • Host - FTP server location
  • Port - for FTP this is typically set to 21
  • Username - customer provided username
  • Password - customer provided password

mceclip9.png

GCS

Google Cloud Storage, is also referred to as "GCS bucket". 

  • Use Instance Profile selection - provides the option of using the credentials in the GCP instance profile or to upload a JSON with the private key information.
    • On (green)
      • Bucket - GCS location
      • Project ID - project the GCS bucket is associated with
    • Off (grey)
      • Bucket - GCS location
      • Project ID - project the GCS bucket is associated with
      • Key File Upload - field to upload the private key JSON format file

mceclip10.png

S3

Simple Storage Service - this is an Amazon cloud storage service also referred to as "S3 bucket"

  • Use Instance Profile
    • On (green)
      • AWS End Point - this is the AWS web address for accessing the storage bucket
    • Off (grey) 
      • Access Key ID - S3 access key
      • Secret Access Key - S3 secret key
      • Bucket - name of the bucket to be used for the connector
  • Enable V4 - leave off, Syntasa services professionals will advise if this should be turned on.

mceclip11.png

SFTP

Defines host and credentials for creating SFTP connector

  • Host - SFTP server location
  • Port - for SFTP this is typically set to 22
  • Auth Type
    • Password - uses a username/password combination for authentication
    • Key - ability to upload key file for authentication

mceclip12.png