Workstation Configuration
To connect your computer (workstation) to the eConnect server securely, you need to make two small changes: install a security certificate and add a host entry. These steps allow your computer to trust and communicate with the eConnect server over a secure connection (HTTPS). Don’t worry—this guide explains everything in simple terms!
Step 1: Install the Security Certificate
The ec-docker-ca.crt
certificate tells your computer to trust the eConnect server. Follow these steps to install it:
-
Open the Certificate Manager:
- Press
Windows Key + R
on your keyboard (this opens a "Run" box). - Type
certmgr.msc
and press Enter.
- Press
-
Find the Right Folder:
- In the window that opens, look at the left side.
- Click the arrow next to "Certificates - Local Computer" to expand it.
- Find and click on "Trusted Root Certification Authorities."
- Then click "Certificates" under it.
-
Install the Certificate:
- At the top, click "Action" in the menu bar.
- Choose "All Tasks" → "Import."
- Click "Next" in the wizard that pops up.
- Click "Browse," find the
ec-docker-ca.crt
file (you’ll need this file provided to you), and select it. - Click "Open," then "Next."
- Make sure "Trusted Root Certification Authorities" is selected, then click "Next" again.
- Click "Finish." You’ll see a message saying the import was successful—click "OK."
-
Check It Worked:
- Look in the list of certificates. You should see a new entry
eConnect Docker Container CA
.
- Look in the list of certificates. You should see a new entry
Step 2: Add the Host Entry
This step gives your computer a "name" to find the eConnect servers. You’ll edit a file called hosts
.
-
Open the Hosts File:
- Press
Windows Key + S
to open the search bar. - Type "Notepad," right-click it, and select "Run as Administrator." Click "Yes" if prompted.
- In Notepad, click "File" → "Open."
- Navigate to:
C:\Windows\System32\drivers\etc\
. - Change the dropdown from "Text Documents (.txt)" to "All Files (.*)".
- Select the
hosts
file and click "Open."
- Press
-
Add the Entry:
-
Add these lines at the bottom of the file
# eConnect Windows Server
10.1.50.51 dataevents.ec.docker
# eConnect FaceRec Server
10.1.50.52 identities.ec.dockerNotes:
- Replace
10.1.50.51
with the actual server IP address of the eConnect Windows Server - Replace
10.1.50.52
with the actual server IP address of the eConnect Primary FaceRec Server
- Replace
-
Press
Ctrl + S
to save, then close Notepad.
-
-
Test It:
- Open your web browser (like Edge or Chrome) and type
https://dataevents.ec.docker
. If everything’s set up right, it should connect without warnings and a Date/Time will show each time you refresh it (indicating its working). Do the same forhttps://identities.ec.docker
- Open your web browser (like Edge or Chrome) and type
Why These Steps Matter
Here’s a simple explanation of why you’re doing this:
- Certificate: Think of it like a digital ID card. Installing
ec-docker-ca.crt
proves to your computer that the eConnect server is safe to talk to. - Host Entry: This is like adding an address to your phone’s contacts. It helps your computer find the eConnect server using the name
dataevents.ec.docker
and the fr serveridentities.ec.docker
. - HTTPS: Dallmeier uses secure web communication (HTTPS), and browsers like Edge or Chrome block untrusted connections for safety. These steps make sure everything works smoothly.
If you run into trouble, ask your IT support for help—they’ll know what to do!