A connection is a definition of inbound and outbound file integrations. The Connections page is available from the main menu ( ) and selecting the submenu items Connections or if already within the Resources pages via the connections icon (
).
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.
Adding a New Connection
- Click to open the Connections screen.
- Click the plus icon (
) to add a new connection.
- A "Create Connection" box will appear.
- Name - Provide a unique name for the connection. This value is uneditable once the connection is created.
- Connection Type - Select the 'Connection Type' from the dropdown list.
- Provide values for detailed fields; these fields vary based on the connection type selection.
- Click 'Create'.
The new connection will appear on the 'Connections' screen and will be available for use within an app.
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.
Azure Storage
Microsoft's cloud warehouse solution:
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.
Database
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
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
- On (green)
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
- On (green)
- Enable V4 - leave off, Syntasa services professionals will advise if this should be turned on.
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