See more

User's Guide: Create Datasets

  • Last updated:
  • access_time Reading time:
Disclaimer: The Fortanix CCM Datasets feature will only be enabled for Customers with an "Enterprise" license.

Introduction

A dataset contains information on how to securely retrieve remote data.

This includes the following:

  • A location such as a URL to an external storage service.
  • Credentials such as username, password, auth-token, and so on, which are stored securely in a KMS (currently this is Fortanix Self-Defending KMS).
NOTE
  • A Credential is a fully user-provided object, for example: this can be a JSON string that contains the query param of the S3 pre-signed URL and the decryption key.
  • Credentials can be rotated through updates to datasets, all approved enclaves are allowed to refresh and get the latest credentials.

You can leverage these objects to provide data to enclaves securely.

Fortanix CCM’s EDP and EnclaveOS products can retrieve datasets and their credentials when run in an approved Workflow. For more details about workflows, refer to User's Guide: Workflows.

Create a Dataset

To create a dataset.

  1. Click the Datasets icon in the CCM left panel. CCM_dataset1.png
                                                                            Figure 1: Dataset
     
  2. On the Datasets page, click the CREATE DATASET button to create a dataset. CCM_dataset2.png
                                                                            Figure 2: Create Dataset
     
  3. In the Create new dataset form, enter the following details:
    • Name – the dataset name. For ex: Dataset1.
    • Description (optional) – the dataset description.
    • Labels (optional)– attach one or more key-value labels to the dataset.
    • Location – the URL where data can be accessed.
    • Credentials – the credentials needed to access the data.
       
    CCM_dataset3.png
                                                                            Figure 3: Create new Dataset
     
  4. Click the CREATE DATASET to create the dataset. CCM_dataset4.png
                                                                            Figure 4: Dataset created

Update a Dataset

To edit a dataset:

  1. In the dataset table view, select the dataset to edit.
  2. In the detailed view of the dataset, click EDIT DATASET to edit the dataset details. CCM_dataset5.png
                                                                            Figure 4: Edit Dataset
     
  3. You can edit the dataset Name, Description, Location, Labels, and Credentials.
  4. Click SAVE after you edited the dataset. CCM_dataset5.png
                                                                            Figure 5: Save Dataset
     
    NOTE
    You can also edit a dataset by clicking the overflow CCM_dataset10.png menu for a dataset table entry and select the EDIT DATASET option from the menu. CCM_dataset7.png
                                                                            Figure 6: Edit Dataset
     

Delete a Dataset

To delete a dataset:

  1. In the dataset table view, click on the dataset to delete.
  2. In the detailed view of the dataset, click DELETE DATASET to delete the dataset. CCM_dataset8.png
                                                                            Figure 7: Delete a Dataset
     
  3. In the confirmation window, click DELETE to delete the dataset.
     
    NOTE
    You can also delete a dataset by clicking the overflow CCM_dataset10.png menu for a dataset table entry and select the DELETE DATASET option from the menu. CCM_dataset9.png
                                                                            Figure 8: Delete a Dataset