Versleutelde gegevensinvoer

U kunt gecodeerde gegevensbestanden via batchbronnen voor cloudopslag opnemen in Adobe Experience Platform. Met gecodeerde gegevensinvoer kunt u gebruikmaken van asymmetrische coderingsmechanismen om batchgegevens veilig over te brengen naar Experience Platform. Momenteel, zijn de gesteunde asymmetrische encryptiemechanismen PGP en GPG.

De gecodeerde gegevensinvoer verloopt als volgt:

Dit document bevat stappen voor het genereren van een sleutelpaar voor codering van uw gegevens en het invoeren van deze gecodeerde gegevens naar Experience Platform met behulp van bronnen voor cloudopslag.

Aan de slag get-started

Voor deze zelfstudie hebt u een goed inzicht nodig in de volgende onderdelen van Adobe Experience Platform:

Experience Platform API's gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op ​ begonnen wordt met Experience Platform APIs ​.

Ondersteunde bestandsextensies voor gecodeerde bestanden supported-file-extensions-for-encrypted-files

De lijst met ondersteunde bestandsextensies voor gecodeerde bestanden is:

Versleutelingssleutelpaar maken create-encryption-key-pair

De eerste stap bij het invoeren van gecodeerde gegevens naar Experience Platform is het maken van een sleutelpaar voor codering door een POST-aanvraag in te dienen bij het /encryption/keys -eindpunt van de Connectors API.

API formaat

POST /data/foundation/connectors/encryption/keys

Verzoek

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/encryption/keys' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \
  -H 'x-sandbox-name: {{SANDBOX_NAME}}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "acme-encryption",
      "encryptionAlgorithm": "PGP",
      "params": {
          "passPhrase": "{{PASSPHRASE}}"
      }
  }'

Reactie

{
    ​"publicKey": "{PUBLIC_KEY}",
    ​"publicKeyId": "{PUBLIC_KEY_ID}",
    ​"expiryTime": "1684843168"
}

Coderingssleutels ophalen retrieve-encryption-keys

Als u alle coderingssleutels in uw organisatie wilt ophalen, dient u een GET-aanvraag in bij /encryption/keys endpoit=nt.

API formaat

GET /data/foundation/connectors/encryption/keys

Verzoek

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/encryption/keys' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \

Reactie

{
    "encryptionAlgorithm": "{ENCRYPTION_ALGORITHM}",
    "name": "{NAME}",
    "publicKeyId": "{PUBLIC_KEY_ID}",
    "publicKey": "{PUBLIC_KEY}",
    "keyType": "{KEY_TYPE}",
    "expiryTime": "{EXPIRY_TIME}"
}

Coderingssleutels ophalen met id retrieve-encryption-keys-by-id

Als u een specifieke set coderingssleutels wilt ophalen, vraagt u GET het /encryption/keys -eindpunt aan en geeft u uw openbare-sleutel-id op als een headerparameter.

API formaat

GET /data/foundation/connectors/encryption/keys/{PUBLIC_KEY_ID}

Verzoek

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/encryption/keys/{publicKeyId}' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \

Reactie

{
    "encryptionAlgorithm": "{ENCRYPTION_ALGORITHM}",
    "name": "{NAME}",
    "publicKeyId": "{PUBLIC_KEY_ID}",
    "publicKey": "{PUBLIC_KEY}",
    "keyType": "{KEY_TYPE}",
    "expiryTime": "{EXPIRY_TIME}"
}

Door klant beheerd sleutelpaar maken create-customer-managed-key-pair

U kunt desgewenst een sleutelpaar voor handtekeningverificatie maken om uw gecodeerde gegevens te ondertekenen en in te voeren.

Tijdens dit stadium, moet u uw eigen privé sleutel en openbare zeer belangrijke combinatie produceren en dan uw privé sleutel gebruiken om uw gecodeerde gegevens te ondertekenen. Daarna, moet u uw openbare sleutel in Base64 coderen en dan het delen aan Experience Platform opdat Experience Platform uw handtekening verifieert.

Je openbare sleutel delen met Experience Platform

Om uw openbare sleutel te delen, doe een POST- verzoek aan het /customer-keys eindpunt terwijl het verstrekken van uw encryptiealgoritme en uw Base64-Gecodeerde openbare sleutel.

API formaat

POST /data/foundation/connectors/encryption/customer-keys

Verzoek

curl -X POST \
  'https://platform.adobe.io/data/foundation/connectors/encryption/customer-keys' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \
  -H 'x-sandbox-name: {{SANDBOX_NAME}}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "acme-sign-verification-keys"
      "encryptionAlgorithm": {{ENCRYPTION_ALGORITHM}},
      "publicKey": {{BASE_64_ENCODED_PUBLIC_KEY}},
      "params": {
          "passPhrase": {{PASS_PHRASE}}
      }
    }'

Reactie

{
  "publicKeyId": "e31ae895-7896-469a-8e06-eb9207ddf1c2"
}

Ontvang klant geleid zeer belangrijk paar

Als u de door de klant beheerde sleutels wilt ophalen, vraagt u GET het /customer-keys -eindpunt aan.

API formaat

GET /data/foundation/connectors/encryption/customer-keys

Verzoek

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/encryption/customer-keys' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \

Reactie

[
    {
        "encryptionAlgorithm": "{ENCRYPTION_ALGORITHM}",
        "name": "{NAME}",
        "publicKeyId": "{PUBLIC_KEY_ID}",
        "publicKey": "{PUBLIC_KEY}",
        "keyType": "{KEY_TYPE}",
    }
]

Sluit uw bron voor cloudopslag aan op Experience Platform met de API van Flow Service

Nadat u de coderingssleutel hebt opgehaald, kunt u nu doorgaan en een bronverbinding voor de bron van de cloudopslag maken en uw gecodeerde gegevens naar Experience Platform overbrengen.

Eerst moet u een basisverbinding maken om uw bron te verifiëren met Experience Platform. Als u een basisverbinding wilt maken en de bron wilt verifiëren, selecteert u de gewenste bron in de onderstaande lijst:

Na het creëren van een basisverbinding, moet u dan de stappen volgen die in het leerprogramma voor ​ worden geschetst creërend een bronverbinding voor een bron van de wolkenopslag ​ om een bronverbinding, een doelverbinding, en een afbeelding tot stand te brengen.

Een gegevensstroom maken voor gecodeerde gegevens create-a-dataflow-for-encrypted-data

Als u een gegevensstroom wilt maken, dient u een POST-aanvraag in bij het eindpunt /flows van de Flow Service API. Als u gecodeerde gegevens wilt invoeren, moet u een encryption -sectie toevoegen aan de eigenschap transformations en de publicKeyId opnemen die in een eerdere stap is gemaakt.

API formaat

POST /flows

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/flows' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \
  -H 'x-sandbox-name: {{SANDBOX_NAME}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "ACME Customer Data",
    "description": "ACME Customer Data (Encrypted)",
    "flowSpec": {
        "id": "9753525b-82c7-4dce-8a9b-5ccfce2b9876",
        "version": "1.0"
    },
    "sourceConnectionIds": [
        "655f7c1b-1977-49b3-a429-51379ecf0e15"
    ],
    "targetConnectionIds": [
        "de688225-d619-481c-ae3b-40c250fd7c79"
    ],
    "transformations": [
        {
            "name": "Mapping",
            "params": {
                "mappingId": "6b6e24213dbe4f57bd8207d21034ff03",
                "mappingVersion":"0"
            }
        },
        {
            "name": "Encryption",
            "params": {
                "publicKeyId":"311ef6f8-9bcd-48cf-a9e9-d12c45fb7a17"
            }
        }
    ],
    "scheduleParams": {
        "startTime": "1675793392",
        "frequency": "once"
    }
}'

{
    "id": "dbc5c132-bc2a-4625-85c1-32bc2a262558",
    "etag": "\"8e000533-0000-0200-0000-5f3c40fd0000\""
}

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/flows' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \
  -H 'x-sandbox-name: {{SANDBOX_NAME}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "ACME Customer Data (with Sign Verification)",
    "description": "ACME Customer Data (with Sign Verification)",
    "flowSpec": {
        "id": "9753525b-82c7-4dce-8a9b-5ccfce2b9876",
        "version": "1.0"
    },
    "sourceConnectionIds": [
        "655f7c1b-1977-49b3-a429-51379ecf0e15"
    ],
    "targetConnectionIds": [
        "de688225-d619-481c-ae3b-40c250fd7c79"
    ],
    "transformations": [
        {
            "name": "Mapping",
            "params": {
                "mappingId": "6b6e24213dbe4f57bd8207d21034ff03",
                "mappingVersion":"0"
            }
        },
        {
            "name": "Encryption",
            "params": {
                "publicKeyId":"311ef6f8-9bcd-48cf-a9e9-d12c45fb7a17",
                "signVerificationKeyId":"e31ae895-7896-469a-8e06-eb9207ddf1c2"
            }
        }
    ],
    "scheduleParams": {
        "startTime": "1675793392",
        "frequency": "once"
    }
}'

{
    "id": "dbc5c132-bc2a-4625-85c1-32bc2a262558",
    "etag": "\"8e000533-0000-0200-0000-5f3c40fd0000\""
}

Versleutelingssleutels verwijderen delete-encryption-keys

Als u de coderingssleutels wilt verwijderen, vraagt u DELETE het /encryption/keys -eindpunt aan en geeft u de id van de openbare sleutel op als een headerparameter.

API formaat

DELETE /data/foundation/connectors/encryption/keys/{PUBLIC_KEY_ID}

Verzoek

curl -X DELETE \
  'https://platform.adobe.io/data/foundation/connectors/encryption/keys/{publicKeyId}' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \

Reactie

Een geslaagde reactie retourneert HTTP-status 204 (Geen inhoud) en een lege hoofdtekst.

Coderingssleutels valideren validate-encryption-keys

Als u de coderingssleutels wilt valideren, vraagt u GET het /encryption/keys/validate/ -eindpunt aan en geeft u de id van de openbare sleutel op die u als headerparameter wilt valideren.

GET /data/foundation/connectors/encryption/keys/validate/{PUBLIC_KEY_ID}

Verzoek

curl -X GET \
  'https://platform.adobe.io/data/foundation/connectors/encryption/keys/validate/{publicKeyId}' \
  -H 'Authorization: Bearer {{ACCESS_TOKEN}}' \
  -H 'x-api-key: {{API_KEY}}' \
  -H 'x-gw-ims-org-id: {{ORG_ID}}' \

Reactie

Een succesvol antwoord geeft een bevestiging dat je id's geldig of ongeldig zijn.

{
    "publicKeyId": "{PUBLIC_KEY_ID}",
    "status": "Active"
}

{
    "publicKeyId": "{PUBLIC_KEY_ID}",
    "status": "Expired"
}

Beperkingen op terugkerende inname restrictions-on-recurring-ingestion

Inname van gecodeerde gegevens ondersteunt geen inname van terugkerende of meervoudige mappen in bronnen. Alle gecodeerde bestanden moeten in één map staan. Jokertekens met meerdere mappen in één bronpad worden ook niet ondersteund.

Hieronder ziet u een voorbeeld van een ondersteunde mapstructuur, waarbij het bronpad /ACME-customers/*.csv.gpg is.

In dit scenario worden de vette bestanden opgenomen in Experience Platform.

Hieronder ziet u een voorbeeld van een niet-ondersteunde mapstructuur waarbij het bronpad /ACME-customers/* is.

In dit scenario, zal de stroomlooppas ontbreken en een foutenmelding terugkeren erop wijzend dat de gegevens niet uit de bron kunnen worden gekopieerd.

Volgende stappen

Aan de hand van deze zelfstudie hebt u een sleutelpaar voor codering van uw gegevens voor cloudopslag gemaakt en een gegevensstroom voor het opnemen van gecodeerde gegevens via de Flow Service API . Voor statusupdates op de volledigheid van uw gegevensstroom, fouten, en metriek, lees de gids op ​ controle uw gegevensstroom gebruikend Flow Service API ​.