Where the Care App and Care Portal are mentioned, the articles in the Support Center refer to both the professional Plan (Care Lab App and Care Lab Portal) and the enterprise Plan (Care App and Care Portal), unless indicated otherwise.
The availability of Care Portal access on enterprise is defined by the study configuration. For further information on your study configuration, talk to your Study team or account manager.
After collecting data using EmbracePlus, the data are uploaded to the Empatica Cloud. The Empatica Cloud is an AWS S3 bucket, where the collected high-frequency raw data and digital biomarkers are stored. To access the S3 bucket, you will need to generate your Data Access Keys. These keys are your ‘password’ to access the S3 bucket data associated with your Care Portal account.
Access Keys are Confidential: Always treat access keys as a secret. Never publish or expose them in any public medium.
If you use a versioning system (i.e. Git), ensure that access keys are never saved in plain text or committed. Consider using environment variables or secrets management tools.
Exposing keys can lead to data breaches and unauthorized access.
Viewing your Data Access Keys:
In the Side Navigation Menu of the Care Portal, locate the ‘Data Access Key’ sub-section under ‘Data’. In this space, you can generate, download, and revoke your Data Access Keys to access the data stored on the AWS S3 Bucket.
Generating your Data Access Keys:
You can have up to two (2) active sets of Data Access Keys at a time. If you need to generate a new set of Data Access Keys, one of the existing sets must be revoked. Generate your Data Access Keys in four simple steps:
-
Open the ‘Data Access Keys’ section of the Care Portal - Open the Side Navigation Menu and click on ‘Data Access Keys’
-
Generate your Data Access Keys - Press on ‘Generate Access Key’ to get the credentials needed to access your data from the AWS S3 Bucket
-
Download your credentials - After having generated your Data Access Keys, download and save the credentials in a secure location
For security reasons, this is the only time the key will be available to view, copy, or download. We recommend downloading these credentials only if you are using a secure connection, and if you can store them in a secure location.
-
Open the Data Access Documentation - Click on ‘LEARN MORE ABOUT DATA ACCESS KEYS’ to open the Data Access Documentation. Our step-by-step guide gives an overview of how to download the data, which types of data are available, how the data is structured, which data formats are used, and how to open them. Please also refer to: Accessing Data on the S3 Bucket
Revoking your Data Access Keys:
You can revoke Data Access Keys at a time. Once the action of revoking the Data Access Keys is completed, one of the Data Access Key slots will re-open and become available for a new set of Data Access Keys to be generated. Revoke your Data Access Keys in three simple steps:
-
Open the ‘Data Access Keys’ section of the Care Portal - Open the Side Navigation Menu and click on ‘Data Access Keys’
-
Open the prompt to revoke your Data Access Keys - Press on ‘Revoke Access Key’ for the Access Keys you want to revoke
Revoking this key will affect all the applications using it. All previously validated tokens will no longer be valid. This is an irreversible process, and you cannot undo a deleted Access Key.
-
Revoke your Data Access Keys - Select ‘Revoke’ to confirm the action