Data Landing Zone

Data Landing Zone är ett Azure Blob-lagringsgränssnitt som tillhandahålls av Adobe Experience Platform, vilket ger dig tillgång till en säker, molnbaserad fillagringsfunktion för att hämta filer till plattformen. Du har åtkomst till en Data Landing Zone-behållare per sandlåda, och den totala datavolymen för alla behållare är begränsad till den totala datamängden som tillhandahålls med plattformsprodukten och tjänstlicensen. Alla kunder i Experience Platform har etablerats med en Data Landing Zone-behållare per sandlåda. Du kan läsa och skriva filer till behållaren via Azure Storage Explorer eller kommandoradsgränssnittet.

Data Landing Zone har stöd för SAS-baserad autentisering och dess data skyddas med standardsäkerhetsmekanismer för lagring i Azure Blob vid vila och överföring. Med SAS-baserad autentisering kan du få säker åtkomst till din Data Landing Zone-behållare via en offentlig internetanslutning. Du behöver inte göra några nätverksändringar för att komma åt din Data Landing Zone-behållare, vilket innebär att du inte behöver konfigurera några tillåtelselista- eller korsregionsinställningar för ditt nätverk. Experience Platform tillämpar en strikt 7-dagars förfallotid för alla filer och mappar som överförts till en Data Landing Zone-behållare. Alla filer och mappar tas bort efter sju dagar.

Konfigurera din Data Landing Zone-källa för Experience Platform på Azure azure

Följ stegen nedan för att lära dig hur du kan konfigurera ditt Data Landing Zone-konto för Experience Platform på Azure.

Namnbegränsningar för filer och kataloger

Nedan följer en lista över begränsningar som du måste ta hänsyn till när du namnger molnlagringsfiler eller -kataloger.

Hantera innehållet i din Data Landing Zone manage-the-contents-of-your-data-landing-zone

Du kan använda Azure Storage Explorer för att hantera innehållet i Data Landing Zone-behållaren.

I användargränssnittet för Azure Storage Explorer väljer du anslutningsikonen i den vänstra navigeringen. Fönstret Välj resurs visas med alternativ att ansluta till. Välj Blob container om du vill ansluta till Data Landing Zone.

Välj sedan URL för delad åtkomstsignatur (SAS) som anslutningsmetod och välj sedan Nästa.

När du har valt anslutningsmetod måste du sedan ange visningsnamn och Blobbehållar-SAS-URL:en som motsvarar Data Landing Zone-behållaren.

Ange din Data Landing Zone SAS-URL och välj sedan Nästa

Fönstret Sammanfattning visas med en översikt över dina inställningar, inklusive information om din Blob-slutpunkt och behörigheter. Välj Anslut när du är klar.

En anslutning uppdaterar användargränssnittet för Azure Storage Explorer med behållaren för Data Landing Zone.

Med din Data Landing Zone-behållare ansluten till Azure Storage Explorer kan du nu börja överföra filer till Data Landing Zone-behållaren. Om du vill överföra väljer du Överför och sedan Överför filer.

När du har valt den fil som du vill överföra måste du sedan identifiera den Blob-typ som du vill överföra den som och den målkatalog som du vill använda. När du är klar väljer du Överför.

Överför filer till Data Landing Zone med kommandoradsgränssnittet

Du kan också använda kommandoradsgränssnittet för enheten och få åtkomst till överföringsfiler till Data Landing Zone.

Överföra en fil med Bash

I följande exempel används Bash och cURL för att överföra en fil till en Data Landing Zone med REST API:t Azure Blob Storage:

# Set Azure Blob-related settings
DATE_NOW=$(date -Ru | sed 's/\+0000/GMT/')
AZ_VERSION="2018-03-28"
AZ_BLOB_URL="<URL TO BLOB ACCOUNT>"
AZ_BLOB_CONTAINER="<BLOB CONTAINER NAME>"
AZ_BLOB_TARGET="${AZ_BLOB_URL}/${AZ_BLOB_CONTAINER}"
AZ_SAS_TOKEN="<SAS TOKEN, STARTING WITH ? AND ENDING WITH %3D>"

# Path to the file we wish to upload
FILE_PATH="</PATH/TO/FILE>"
FILE_NAME=$(basename "$FILE_PATH")

# Execute HTTP PUT to upload file (remove '-v' flag to suppress verbose output)
curl -v -X PUT \
   -H "Content-Type: application/octet-stream" \
   -H "x-ms-date: ${DATE_NOW}" \
   -H "x-ms-version: ${AZ_VERSION}" \
   -H "x-ms-blob-type: BlockBlob" \
   --data-binary "@${FILE_PATH}" "${AZ_BLOB_TARGET}/${FILE_NAME}${AZ_SAS_TOKEN}"

Överföra en fil med Python

I följande exempel används Microsoft’s Python v12 SDK för att överföra en fil till en Data Landing Zone:

import os
from azure.storage.blob import ContainerClient

try:
    # Set Azure Blob-related settings
    sasUri = "<SAS URI>"
    srcFilePath = "<FULL PATH TO FILE>"
    srcFileName = os.path.basename(srcFilePath)

    # Connect to container using SAS URI
    containerClient = ContainerClient.from_container_url(sasUri)

    # Upload file to Data Landing Zone with overwrite enabled
    with open(srcFilePath, "rb") as fileToUpload:
        containerClient.upload_blob(srcFileName, fileToUpload, overwrite=True)

except Exception as ex:
    print("Exception: " + ex.strerror)

Överför en fil med AzCopy

I följande exempel används verktyget Microsoft’s AzCopy för att överföra en fil till en Data Landing Zone:

set sasUri=<FULL SAS URI, PROPERLY ESCAPED>
set srcFilePath=<PATH TO LOCAL FILE(S); WORKS WITH WILDCARD PATTERNS>

azcopy copy "%srcFilePath%" "%sasUri%" --overwrite=true --recursive=true

Konfigurera din Data Landing Zone-källa för Experience Platform på Amazon Web Services aws

Följ stegen nedan för att lära dig hur du kan konfigurera ditt Data Landing Zone-konto för Experience Platform på Amazon Web Services (AWS).

Konfigurera AWS CLI och Utföra åtgärder

Konfigurera AWS CLI med temporära autentiseringsuppgifter

Använd AWS configure-kommandot för att konfigurera CLI-programmet med åtkomstnycklar och en sessionstoken.

aws configure

Ange följande värden när du uppmanas att göra det:

Ange sedan sessionstoken:

aws configure set aws_session_token your-session-token

Arbeta med filer på Amazon S3

aws s3 cp local-file-path s3://bucketName/dlzFolder/remote-file-Name

aws s3 cp example.txt s3://bucketName/dlzFolder/example.txt

aws s3 cp s3://bucketName/dlzFolder/remote-file local-file-path

aws s3 cp s3://bucketName/dlzFolder/example.txt example.txt

Använd dina Data Landing Zone-inloggningsuppgifter för att logga in på AWS Console

Extrahera dina autentiseringsuppgifter

Först måste du få följande:

Generera en inloggningstoken

Använd sedan de extraherade inloggningsuppgifterna för att skapa en session och generera en inloggningstoken med AWS Federation-slutpunkten:

import json
import requests

# Example DLZ response with credentials
response_json = '''{
    "credentials": {
        "awsAccessKeyId": "your-access-key",
        "awsSecretAccessKey": "your-secret-key",
        "awsSessionToken": "your-session-token"
    }
}'''

# Parse credentials
response_data = json.loads(response_json)
aws_access_key_id = response_data['credentials']['awsAccessKeyId']
aws_secret_access_key = response_data['credentials']['awsSecretAccessKey']
aws_session_token = response_data['credentials']['awsSessionToken']

# Create session dictionary
session = {
    'sessionId': aws_access_key_id,
    'sessionKey': aws_secret_access_key,
    'sessionToken': aws_session_token
}

# Generate the sign-in token
signin_token_url = "https://signin.aws.amazon.com/federation"
signin_token_payload = {
    "Action": "getSigninToken",
    "Session": json.dumps(session)
}
signin_token_response = requests.post(signin_token_url, data=signin_token_payload)
signin_token = signin_token_response.json()['SigninToken']

Skapa inloggnings-URL:en för AWS Console

När du har en inloggningstoken kan du skapa den URL som loggar dig i AWS Console och pekar direkt till önskad Amazon S3-bucket.

from urllib.parse import quote

# Define the S3 bucket and folder path you want to access
bucket_name = "your-bucket-name"
bucket_path = "your-bucket-folder"

# Construct the destination URL
destination_url = f"https://s3.console.aws.amazon.com/s3/buckets/{bucket_name}?prefix={bucket_path}/&tab=objects"

# Create the final sign-in URL
signin_url = f"https://signin.aws.amazon.com/federation?Action=login&Issuer=YourAppName&Destination={quote(destination_url)}&SigninToken={signin_token}"

print(f"Sign-in URL: {signin_url}")

Åtkomst till AWS Console

Navigera slutligen till den genererade URL:en för att logga in direkt på AWS Console med dina Data Landing Zone-inloggningsuppgifter, som ger åtkomst till en viss mapp i en Amazon S3-bucket. Inloggnings-URL:en tar dig direkt till den mappen och ser till att du bara ser och hanterar tillåtna data.

Anslut Data Landing Zone till Experience Platform

Dokumentationen nedan innehåller information om hur du hämtar data från din Data Landing Zone-behållare till Adobe Experience Platform med hjälp av API:er eller användargränssnittet.

Använda API:er

Använda gränssnittet