User's Guide: Inbound Connector

1.0 Introduction

Welcome to the Fortanix Confidential Computing Manager - Inbound Connectors user guide. This guide describes how to create and manage Inbound Connectors in Fortanix Confidential Computing Manager.

One of the elements within the realm of Fortanix Confidential Computing Manager is the Inbound Connector, the purpose of this connector is to enable workflows to import the input data from external sources during runtime into the confidential data collaboration environment. 

Using the Inbound Connector menu item in the Fortanix Confidential Computing Manager user interface (UI), you can add, review, and manage the inbound data connectors.

Currently, Fortanix Confidential Computing Manager supports the following inbound connector types:

  • Google BigQuery – It facilitates the retrieval and utilization of data stored in BigQuery for further processing, analysis, or integration into Fortanix Confidential Computing Manager workflows.
    NOTE
    Ensure that you have a BigQuery project set up and configured if you want to fetch the data from the Google BigQuery dashboard.
  • CSV – It enables the integration of data stored in CSV files. You can utilize this connector to import and process data from CSV files within Fortanix Confidential Computing Manager workflows.
    NOTE
    Ensure to obtain a valid and pre-signed URL for accessing the data if you want to fetch the data from a URL. This URL can be hosted on Amazon Web Services (AWS), Microsoft Azure, or the Google Cloud Platform (GCP).

2.0 Add the Inbound Connectors

Perform the following steps to seamlessly add the inbound connector as CSV files to the Fortanix Confidential Computing Manager:

  1. Click the DataverseInbound Connectors menu item in the Confidential Computing Manager left navigation bar and click the + ADD INBOUND CONNECTOR button to add an inbound connector.
    add-inbound-connector.png
    Figure 1: Add New Inbound Connector
  2. On the Create new inbound connector dialog box, select either of the following connecter types:
    • BigQuery: Select this option if you want to import data from BigQuery .
    • CSV: Select this option if your data is in CSV format and you want to import it using this connector.
  3. Click the NEXT button to proceed further.
  4. On the Create new inbound connector page:
    1. If you have selected the BigQuery option in Step 2, enter the following details:
      1. Connector name: Enter a required name for the inbound connector.
      2. Description (Optional): Add a brief description to provide additional context if needed.
      3. Labels: Assign one or more key-value labels to categorize or tag the connector.
      4. Group: Select the required group name from the drop down menu to associate this connector with that group.
      5. Project ID: Enter the ID of the BigQuery project .
        BigQuery-ID.png
        Figure 2: BigQuery Project ID
      6. Dataset name: Enter the name of the dataset from which you want to import data.
      7. Table name: Enter the name of the table within the specified dataset.
      8. API key: Enter the API key required for accessing the Big Query service in the text box provided. You can also upload the API key in Raw or Base64 format using the browse option. To know the steps for generating this API key, refer to the Google Cloud: Create an API Key documentation.
        NOTE
        The API key cannot be viewed again after submission.
    2. If you have selected the CSV option in Step 2, enter the following details:
      1. Connector name: Enter a required name for the inbound connector.
      2. Description (Optional): Add a brief description to provide additional context if needed.
      3. Labels: Assign one or more key-value labels to categorize or tag the connector.
      4. Group: Select the required group name from the drop down menu to associate this connector with that group.
      5. URL: Enter the URL where the CSV file is located for importing data .
        NOTE
        Predesigned URL is supported for Amazon Web Services (AWS), Azure, and Google Cloud Platform (GCP).
  5. Click the CREATE INBOUND CONNECTORS button to create the inbound connector.

The inbound data connector is now created successfully.

added-inbound-connector.png

Figure 3: Inbound Connector Added

3.0 Edit the Inbound Connector

Perform the following steps to modify the details of the inbound connector:

  1. Click the Inbound Connectors menu item in the Confidential Computing Manager left navigation bar.
  2. Locate and click the inbound connector that you wish to edit from the list of available inbound connectors. A new screen opens where you can review and edit the configuration.
  3. Click the EDIT INBOUND CONNECTOR button to initiate the editing process.
    NOTE
    Alternatively, you can click the three dots.pngoverflow menu (three dots) for an Inbound Connector row and select the EDIT INBOUND CONNECTOR option to modify the connector.
  4. Update the configuration as needed.
  5. After you have made the necessary edits, click the SAVE button to keep your changes.

The inbound data connector is updated successfully.

4.0 Inbound Connector Details Overview

This screen offers insights into general details, enabling effective management and understanding of your connectors.

The displayed fields on the screen will vary depending on the type of inbound connector created:

  • If a Big Query Inbound Connecter is created:
    • Connector type: Displays the type of connector, such as Google BigQuery .
    • Created by: Displays the name of the user who created the connector.
    • Group: Specifies the group to which the connector belongs.
    • Created at: Displays the timestamp when the connector was initially created.
    • Last updated at: Indicates the date and time of the last update made to the connector.
    • Project ID: Refers to the identifier associated with the project.
    • Dataset Name: Displays the name of the dataset.
    • Table Name: Displays the name of the table in the dataset associated with the connector.
    • Labels: Displays any applied labels for additional categorization or identification.
  • If a CSV Inbound Connecter is created:
    • Connector type: Displays the type of connector, such as CSV.
    • Created by: Displays the name of the user who created the connector.
    • Group: Specifies the group to which the connector belongs.
    • Created at: Displays the date and time when the connector was initially created.
    • Last updated at: Displays the date and time of the last update made to the connector.
    • URL: Displays the Uniform Resource Locator (URL) associated with the connector from where the CSV data file was imported.
    • Labels: Displays any applied labels for additional categorization or identification.

5.0 Delete the Inbound Connector

Perform the following steps to delete the inbound connector:

  1. Click the Inbound Connectors menu item in the Confidential Computing Manager left navigation bar.
  2. Locate and click the inbound connector that you wish to remove from the list of available inbound connectors.
  3. Click the DELETE INBOUND CONNECTOR button to remove the connector.
    NOTE
    Alternatively, you can click the three dots.png overflow menu (three dots) for an Inbound Connector row and select the INBOUND CONNECTOR option to modify the connector.
  4. Click the DELETE button to confirm the action.

The inbound data connector is deleted successfully.

Comments

Please sign in to leave a comment.

Was this article helpful?
0 out of 0 found this helpful