tiCrypt 2.18.3

Connect Application

The Connect Application is the desktop client for tiCrypt. It runs the tiCrypt front end either in its own embedded browser or, for debugging, in an external browser.

One installation can hold several front-end versions and several deployments. A deployment is one institution's tiCrypt system; a front-end version is the build of the tiCrypt interface served against it. This page covers managing both. To install the application in the first place, see Get Started.

tip

New features reach the Connect Application before the browser version. External SFTP support and the local filesystem bridge to the Vault are both Connect-only, so use it rather than a browser where you have the choice.

Add a Front-End Version

1. Open the Connect Application.
2. Click the Manage versions button in the top right (macOS) or left (Windows) corner.
3. In the pop-up, click the Add version button in the top right.
4. Click Upload .szip file.
5. Select the version file and click Open.

info

You can paste a version link into the Paste a version URL and press Enter field instead of uploading a file.

Switch Front-End Versions

1. Open the Connect Application.
2. Click the Manage versions button in the top right (macOS) or left (Windows) corner.
3. Select the front-end version you want. The pop-up closes on its own.

note

Run the latest version, which is selected by default. Front-end versions update globally unless you override them here.

Delete a Front-End Version

1. Open the Connect Application.
2. Click the Manage versions button in the top right (macOS) or left (Windows) corner.
3. Click the Delete button next to the version.
4. Click outside the pop-up to exit.

Add a Deployment

1. Open the Connect Application.
2. Click the Add deployment button in the top right (macOS) or left (Windows) corner.
3. Click Upload .dep file.
4. Select the deployment file and click Open.

info

You can paste a deployment link into the Paste a deployment URL field instead of uploading a file.

Delete a Deployment

1. Open the Connect Application.
2. Click the Delete a deployment button in the top right (macOS) or left (Windows) corner. With only one deployment, the button is Delete followed by the deployment name; skip the next step.
3. Click the card of the deployment you want to delete.
4. Click Yes.

caution

You must re-add a deployment to regain access to it.

Switch Between Deployments

1. Open the Connect Application.
2. Select the first deployment card.
3. Click the Exit button below the login box. It carries your deployment's name, for example Exit tiCrypt Edge.
4. Select the second deployment card.

Deployment Files and Updates

Every version of the Connect Application uses the same database, so the same .dep file works for any new version. If the .dep file is already loaded, the Connect Application recognizes it automatically and you do not need to add it again after an update.

Check Which Versions You Are Running

Three separate version numbers matter, and the login page shows all three.

1. Open the Connect Application.
2. Select your deployment card.
3. Next to the Key symbol, read:

Prefix	Component
f	Front end
b	Back end
c	Connect Application

The c number appears only when you run tiCrypt in the Connect Application; in a web browser the line shows f and b only. Hover over the b number to see the address of the back end you are connected to. After you log in, the same numbers appear in the tiCrypt toolbar.

Quote all three when reporting a problem. They move independently, and a fault often belongs to only one of them.

Version Warnings on the Login Page

The login page warns you when the versions do not fit together. The following table describes the warnings.

Message	What to do
v<x> of this application is now available. Please restart the application in tiCrypt Connect to upgrade to the new version.	Exit and restart tiCrypt in the Connect Application to load the newer front end.
Your tiCrypt Connect is outdated. v<x> of tiCrypt Connect is the minimum required to run the application.	Install the Connect Application version shown, or a newer one. See Get Started.
The tiCrypt backend is outdated. v<x> is the minimum required to run the application. Please inform an administrator.	Tell your administrator. The server needs an upgrade before this front end can run.