Connections – SYNTASA™

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

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.

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

Matomo API

To streamline the ingestion of Matomo data, there's a new connection type ‘ Matomo API’ connection.

Name - Should be a unique Connection name. This value is noneditable once the connection is created.

Connection Type - Should select Matomo API from the dropdown list. This value is noneditable once the connection is created.

Tags - Custom free text field to help segment jobs in the job logs. Users can create a new tag or can select from the existing dropdown list

Url - Provide valid URL, should be a mandatory field

Protocol - Should select either Http or Https from the dropdown list

SSL Cert - Matomo connections are able to authenticate using SSL. User is able to upload SSL Cert File once SSL cert is checked

Auth Type - The Syntasa platform supports multiple types of authentication mechanisms to securely allow the users to access the platform. User can either select Auth Type as Token or PKI. If the user selects Auth Type as Token then should provide Auth Token. PKI authentication mode that allows the users to use the digital PKI certificate that can be imported into the user browser to authenticate with the Syntasa platform.

Test Connection - When creating a new connection you can now test it right away, even before saving, to ensure it's in working order before trying to use it in an app.

Pick a sharing option- When creating a new Connection the sharing option selection will be available to make the runtime available as Private, Public, or Group. Regardless of the selection, a user with the role of System Admin will always have access to all connections. The sharing option selected at the time of creating the connection can be changed by the owner or a system administrator.

Private- Private can be set by the owner (or the system administrator) to limit access to the Connection only to the owner. System administrators can also access the Connection set to private.

Public- Public is the default setting. All users have access to the Connection

Group- Group can be set by the owner (or the system administrator) to limit the access to the user group(s) assigned to the Connection. As with private, the system administrator can view components with the sharing option set to group regardless if they are a group member.

Owner- The owner of the Connection is by default the user that is creating the Connection. This can be changed, if needed, by the owner or the system administrator, after the Connection is created.

{[{category.name}]}