Installing Connections
1. Overview
The Connections Experience is designed to facilitate the creation of data syncs through an easy to use Cinchy UI. Once installed, you can access Connections directly through your Cinchy platform using the applet (Image 1).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FQJZytNDDLSbwXssGeqJe%252Fimage.png%3Falt%3Dmedia%26token%3D2d53bcee-0a60-42ae-9c6d-19cb963ee730&width=768&dpr=4&quality=100&sign=a71b7c19&sv=1)
In a Kubernetes deployment of the Cinchy Platform, Connections is automatically installed. The below steps refer only to an IIS deployment of the Cinchy Platform.
Before proceeding, ensure that you have read the Prerequisites section.
2. Downloading the Resources
Navigate to the Cinchy Releases table and download the latest Cinchy Connections.zip file from the Release Artifacts column.
The Connections.zip file contains: Worker.zip, WebApi.zip, and CLI.zip.
2. Extract the WebApi.zip to the folder where you want to host the applet.
We suggest to create the following path and extract it there: C:\Connections\
3. Deploying Connections
On a Windows Server machine, launch an instance of PowerShell as the Administrator.
Run the below commands to create the IIS application pool and set its properties.
Steps 4 and 5 are only needed if you deployed your Cinchy instance along a base path.
Within the Cinchy platform, navigate to the [Cinchy].[Integrated Clients] table (Image 2).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FDhMIQ06DMLWKfdI7zwWN%252Fimage.png%3Falt%3Dmedia%26token%3Dd345a3ef-a6ac-4aa7-8829-0740b9d3054d&width=768&dpr=4&quality=100&sign=ad386a88&sv=1)
Navigate to the row where the Client ID column is "cinchy_connections_experience" (Image 3).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FsVyAbObq0aHzyF6IEqTx%252Fimage.png%3Falt%3Dmedia%26token%3D0a3e2b60-4c4e-413a-9c3d-9c8768f8127f&width=768&dpr=4&quality=100&sign=74f48456&sv=1)
In that same row, update the columns “Permitted Login Redirect URLs” and “Permitted Logout Redirect URLs” to “<url>/connections” (Image 4).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FptEiSDoYx6oyClDOpO1I%252Fimage.png%3Falt%3Dmedia%26token%3D1d6aefe8-f821-423c-b094-352fe981fe91&width=768&dpr=4&quality=100&sign=5eb149e6&sv=1)
Within the Cinchy platform, navigate to the [Cinchy].[Applets] table (Image 5).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FDNGKHkpuq6pP4K5Stg7j%252Fimage.png%3Falt%3Dmedia%26token%3D95642495-a8f7-4dea-b0d1-1f89920ec32a&width=768&dpr=4&quality=100&sign=72742294&sv=1)
Navigate to the row where the Name column is "Connections" (Image 6).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FoOrSYruc8UvuenJAavcD%252Fimage.png%3Falt%3Dmedia%26token%3De5f59f72-bc2f-4382-a0cc-ba98c41c3622&width=768&dpr=4&quality=100&sign=f29724ca&sv=1)
Update the column “Application URL” to “<baseurl>/connections” (Image 7).
![](https://platform.docs.cinchy.com/~gitbook/image?url=https%3A%2F%2F3611129205-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsBUEts4xHX25SWyQ7UxU%252Fuploads%252FQ5J4lNgKldh6enwa5brD%252Fimage.png%3Falt%3Dmedia%26token%3D2a4120c4-60cb-4cc7-bdb1-4d99070641c4&width=768&dpr=4&quality=100&sign=590bccf3&sv=1)
Navigate to C:\Connections\appsettings.json and update the below properties to match your environment:
Parameter | Description |
---|---|
"URL" | This is the private URL of your Cinchy environment. |
“TempDirectory” | This should be a path pointing to an existing folder that will hold all of your log and error files. |
"StorageType" | Select either Local, S3, or AzureBlobStorage. |
"BasePathOverride" | (Optional) Connections should be hosted on "/connections". In the case that this is hosted on another url path, this property must be populated with the relative path (eg. "/dev-aurora-2/connections" or "/" if deployed to the root) |
Navigate to C:\Connections\ClientApp\dist\assets\config.json update the below properties to match your environment:
Parameter | Description |
“authority” | Your public CinchySSO URL in lowercase (ex: <base-url>/cinchysso) |
“cinchyRootUrl” | Your public Cinchy URL (ex: <base-url>/Cinchy) |
“redirectUrl” | The applet’s public URL (ex: <base-url>/connections) |
silentRefreshRedirectUri | The applet’s public URL plus the silent refresh path. |
“model” | The model where your data sync configs are. Keep this as “Cinchy” if you don’t know. |
“domain” | The model where your data sync configs are. Keep this as “Cinchy” if you don’t know. |
“useHttps” | Should be true if your Cinchy platform is hosted on a secure environment |
“server” | Your private Cinchy URL without “http://” or “https://” |
Create the IIS Application by running the following command in an instance of Powershell:
Last updated