Help
  • Explore Community
  • Get Started
  • Ask the Community
  • How-To & Best Practices
  • Contact Support
Notifications
Login / Register
Community
Community
Notifications
close
  • Forums
  • Knowledge Center
  • Events & Webinars
  • Ideas
  • Blogs
Help
Help
  • Explore Community
  • Get Started
  • Ask the Community
  • How-To & Best Practices
  • Contact Support
Login / Register
Sustainability
Sustainability

Join our "Ask Me About" community webinar on May 20th at 9 AM CET and 5 PM CET to explore cybersecurity and monitoring for Data Center and edge IT. Learn about market trends, cutting-edge technologies, and best practices from industry experts.
Register and secure your Critical IT infrastructure

Building Advisor Authentication and other data related information

Building Automation Knowledge Base

Schneider Electric Building Automation Knowledge Base is a self-service resource to answer all your questions about EcoStruxure Building suite, Andover Continuum, Satchwell, TAC…

cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Show  only  | Search instead for 
Did you mean: 
  • Home
  • Schneider Electric Community
  • Knowledge Center
  • Building Automation Knowledge Base
  • Building Advisor Authentication and other data related information
Options
  • Bookmark
  • Subscribe
  • Email to a Friend
  • Printer Friendly Page
  • Report Inappropriate Content
Invite a Co-worker
Send a co-worker an invite to the portal.Just enter their email address and we'll connect them to register. After joining, they will belong to the same company.
You have entered an invalid email address. Please re-enter the email address.
This co-worker has already been invited to the Exchange portal. Please invite another co-worker.
Please enter email address
Send Invite Cancel
Invitation Sent
Your invitation was sent.Thanks for sharing Exchange with your co-worker.
Send New Invite Close

Related Forums

  • Intelligent Devices Forum

Previous Next
Contributors
  • DavidChild
    DavidChild
  • Gary
    Gary

Invite a Colleague

Found this content useful? Share it with a Colleague!

Invite a Colleague Invite
Back to Building Automation Knowledge Base
Options
  • Bookmark
  • Subscribe
  • Email to a Friend
  • Printer Friendly Page
  • Report Inappropriate Content
0 Likes
1012 Views

Link copied. Please paste this link to share this article on your social media post.

Trying to translate this page to your language?
Select your language from the translate dropdown in the upper right. arrow
Translate to: English
  • (Français) French
  • (Deutsche) German
  • (Italiano) Italian
  • (Português) Portuguese
  • (Русский) Russian
  • (Español) Spanish

Building Advisor Authentication and other data related information

Gary Schneider Alumni (Retired)
‎2021-12-16 04:07 AM

Last Updated: Sisko DavidChild Sisko ‎2021-12-16 04:07 AM


Issue

Cyber security and other concerns regarding data transfer to Building Advisor Portal.

Product Line

EcoStruxure Building Operation

Environment

Building Advisor 

Cause

Limited available documentation.

Resolution

 

1. What are the details around the authentication towards AU? Where the certificate can be used for DTSERVICES and INTREPRETER server?


The Data Transfer Windows service that is installed on our client's supplied server (normally within client's
firewall). In order to support Clockworks Connect functionality, the private key of a private/public key pair is installed on same server that the windows service is installed on. The Data Transfer windows service currently supports TLS 1.2.
The Clockworks Authentication web service provides ability to determine the identity of a request's caller. Validate Request with cryptographic challenge - Validate Request by creating cryptographic challenge for Data Transfer Service to sign with private key to confirm identity. Create Session Key - On successful validation, create and store Session key and send back to Data Transfer Service.
Files are named with a date and time stamp to make them unique.
When the DTS transfers the file successfully, it auto deletes the file from the folder. Saving the need to manage the file directory.
It is expected the DTS will create the file, export and the handle transmission of the data.

 

2. How often will the pointslist file be updated (can this be replaced by a manual task)?


Points list file would only be updated if configuration of BMS points has changed (i.e. from a retro fit or additional sensor etc.) – this would be a manual exercise post completion of BMS works.


3. What is the file-format and extension of the pointslist file?


The Clockworks Data Transfer web service provides the following data to the Data Transfer windows services:
• Data Transfer Service application configuration
• Point configuration
• BMS credentials
It works in concert with the Clockworks Authentication web service to ensure a valid a session has been created and is not expired.

 

Interpreter 2
The Clockworks Interpreter web service provides the ability to send data from our client's Building Management System (BMS) to our Cloud environment to allow for visualization of that data in raw (primary) or as analyzed after calculations are performed on the raw data. The Interpreter web services receives data in HTTP GET or POST requests and parses and validated the request before storing in a serialized and compressed binary format. If needed, factors are applied to resolve known data issues from the source. The interpreter supports the following features:
• Support TLS 1.0 and up for Transport Security. SSL is disabled.
• Supports Triple DES (deprecated) and Rijndael algorithms for message level encryption.
• Reserved IP address to ensure the same IP address is maintained which support organizations that: 1) Subscribe to default deny policy and do not trust DNS retrieval for security concerns 2) Not able to configure firewall rules by DNS and IP address if required.
• Optional security to lock down requests by IP address

4. What is the estimated use of resources on the ES server, when polling through this instead of polling the automation server directly?


EWS is used therefore the impact in very minimal.

5. What is the file-format and extension of the data file?


The List method describes a CSV file which is organized such that each row contains a unique sample for
a single point. Each row will typically contain a timestamp, value, data source reference, and point reference. This parsing method has the following features:
Features:
• All CSV files large and small are streamed creating a smaller memory footprint while parsing.
• Only valid point reference IDs configured (i.e. from CW Connect or through local config) and found in the CSV file are pushed to Interpreter.
• The Data Source Reference ID may be obtained from the following sources: Parent directory name being
monitored, a static configuration value, or a user configurable column ID found in the CSV file.
• The Point Reference ID may be obtained from the following source: A user configurable column ID found in the CSV file.
• Date and Time may be in separate columns.
• Date and Time may be in the same column.
Universal Parser: Table Method 3
The Table method describes a CSV file which is organized such that a row exists which contains all point names, often called the "point info row", and below this row all point values and timestamps will be located. This parsing method has the following features:
Features:
• All CSV files large and small are streamed creating a smaller memory footprint while parsing.
• Only valid point reference IDs configured (i.e. from CW Connect or through local config) and found in the CSV file are pushed to Interpreter.
• The Data Source Reference ID may be obtained from the following sources: Parent directory name being
monitored, a static configuration value, the as-is file name being parsed, a particular CSV cell above the
point info row, or a location in a CSV column which is below the point info row.
• The Point Reference IDs: The point info row is dynamically found by the DTS by matching criteria set by the
user. This allows a single DTS install the flexibility to parse multiple Table style CSV files where the point info row may exist in varying locations.
• Date and Time may be in separate columns below the point info row.
• Date and Time may be in the same column below the point info row.#
Example
Site Information:
Officeworks - Highett
Officeworks - Highett
Controller: AC1
Controller description: Retail - Rear
Parent Pack:
Parent Pack Description:
Status: Online
Time,Date,Control Temp {Deg. C},Zone Temp {Deg. C},Return Air Temp {Deg.
C},Outside Air Temp {Deg. C},Cooling Setpoint {Deg. C},Heating Setpoint {Deg.
C},TPI Target {Deg. C},OA Probe {Deg. C},GP Timer {},Supply Fan {},Cooling
{},Heating {},Stage 1 {},Stage 2 {},Economy Damper {%},Fault Relay {},Fire Relay
{},OA Temp {},Cool Reset {},Heat Reset {},Econ Reset {},RA Temp {},Control State
{},TPI {}
00:00:00,22/02/18,22.3,22.3,21.6,25.7,22.0,19.0,22.0,?????,On,On,On,Off,On,Off,0 .0,Off,Off,25.7,Off,Off,Off,21.6,Cooling,?????
00:15:00,22/02/18,22.7,22.7,22.0,26.0,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,26.0,Off,Off,Off,22.0,Off,?????
00:30:00,22/02/18,22.9,22.9,22.5,26.0,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,26.0,Off,Off,Off,22.5,Off,?????
00:45:00,22/02/18,23.0,23.0,22.7,25.7,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,25.7,Off,Off,Off,22.7,Off,?????
01:00:00,22/02/18,23.1,23.1,22.7,26.0,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,26.0,Off,Off,Off,22.7,Off,?????
01:15:00,22/02/18,23.3,23.3,22.6,26.2,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,26.2,Off,Off,Off,22.6,Off,?????
01:30:00,22/02/18,23.4,23.4,22.5,26.0,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,26.0,Off,Off,Off,22.5,Off,?????
01:45:00,22/02/18,23.4,23.4,22.2,25.7,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,25.7,Off,Off,Off,22.2,Off,?????
02:00:00,22/02/18,23.4,23.4,22.2,25.7,22.0,19.0,22.0,?????,Off,Off,Off,Off,Off,O ff,0.0,Off,Off,25.7,Off,Off,Off,22.2,Off,?????
The KGS parser provides a simple way to upload data.
By design, this method has a minimum number of configuration keys and a simplified CSV format.
• This method is intended to be uploaded once a day.

KGS driver expects lines in the CSV in the following format:
Demo_AHU-2,CoolingCoilValve,0.366034,12/1/2020 0:00
Demo_AHU-2,CoolingCoilValve,0.352827,12/1/2020 0:05
Demo_AHU-2,CoolingCoilValve,0.338367,12/1/2020 0:05
Demo_AHU-2,CoolingCoilValve,0.32544,12/1/2020 0:05
Demo_AHU-2,CoolingCoilValve,0.310596,12/1/2020 0:05
...
Data Source Reference ID[0], Point Reference Id[1], Point Value[2], DateTime stamp[3]
Row and Column data are zero (0) based.

 

Labels (1)
Labels:
  • EcoStruxure Building Operation
Tags (1)
  • Find more articles tagged with:
  • GaryMontague21
Was this article helpful? Yes No
No ratings

Link copied. Please paste this link to share this article on your social media post.

To The Top!

Forums

  • APC UPS Data Center Backup Solutions
  • EcoStruxure IT
  • EcoStruxure Geo SCADA Expert
  • Metering & Power Quality
  • Schneider Electric Wiser

Knowledge Center

Events & webinars

Ideas

Blogs

Get Started

  • Ask the Community
  • Community Guidelines
  • Community User Guide
  • How-To & Best Practice
  • Experts Leaderboard
  • Contact Support
Brand-Logo
Subscribing is a smart move!
You can subscribe to this board after you log in or create your free account.
Forum-Icon

Create your free account or log in to subscribe to the board - and gain access to more than 10,000+ support articles along with insights from experts and peers.

Register today for FREE

Register Now

Already have an account? Login

Terms & Conditions Privacy Notice Change your Cookie Settings © 2025 Schneider Electric

This is a heading

With achievable small steps, users progress and continually feel satisfaction in task accomplishment.

Usetiful Onboarding Checklist remembers the progress of every user, allowing them to take bite-sized journeys and continue where they left.

of