Externe accounts external-accounts

Een extern account is een configuratie waarmee u de toegang tot een externe server voor Adobe Campaign kunt configureren en testen.

Deze externe accounts kunnen in Campaign-workflows worden gebruikt voor toegang tot en beheer van data.

U kunt de volgende typen externe accounts instellen:

  • SFTP. Zie deze sectie voor meer informatie.
  • Amazon Storage Service (S3). Zie deze sectie voor meer informatie.
  • Adobe Experience Manager. Zie deze sectie voor meer informatie.
  • Adobe Analytics. Zie deze sectie voor meer informatie.
  • Google reCAPTCHA. Zie deze sectie voor meer informatie.
  • Microsoft Azure Blob-opslag. Zie deze sectie voor meer informatie.
  • OAuth 2.0 Raadpleeg voor meer informatie hierover deze sectie.
NOTE
Andere typen externe accounts worden door Adobe gebruikt tijdens het proces van productprovisioning. Vanaf versie 17.9 van Campaign Standard kunnen externe FTP-accounts nog steeds worden gedefinieerd, maar ze zijn niet meer bruikbaar in nieuwe workflowactiviteiten. Als u al een verbinding had ingesteld, is deze nog steeds ingeschakeld.

Externe accounts kunnen door beheerders worden geconfigureerd via het menu Administration > Application settings > External accounts.

Een externe account maken creating-an-external-account

Adobe Campaign wordt geleverd met een set vooraf gedefinieerde externe accounts. Om verbindingen met externe systemen zoals FTP-servers voor bestandsoverdracht in te stellen, kunt u uw eigen externe accounts aanmaken.

Externe accounts worden gebruikt door technische processen, zoals technische workflows of workflows voor campagnes. Wanneer u een bestandsoverdracht instelt in een workflow of een data-uitwisseling met een andere applicatie (Adobe Target, Experience Manager, enz.), moet u een extern account selecteren.

  1. Klik op de knop Create.

  2. Voer een label in. Het label en de id worden gebruikt bij het selecteren van externe accounts in workflows.

  3. Selecteer het type account dat u wilt maken.

  4. Configureer de toegang tot het account door het opgeven van aanmeldingsgegevens, serveradres, poortnummer en sleutels indien relevant.

    De benodigde informatie wordt meestal verstrekt door de provider van de server waarmee u verbinding maakt.

  5. Sla uw account op.

Het externe account wordt gemaakt en toegevoegd aan de lijst met accounts. Het is nu beschikbaar voor uw data-/bestandsoverdrachten of routeringconfiguraties in workflowactiviteiten en leveringseigenschappen.

Externe SFTP-account sftp-external-account

Voor verschillende typen externe accounts moeten verschillende data worden opgegeven.

Geef voor een extern SFTP-account de volgende data op:

  • Serveradres. Bijvoorbeeld ftp.domain.com.
  • Poortnummer. Bijvoorbeeld 22.
  • Aanmeldingsgegevens SFTP-server: accountnaam en wachtwoord waarmee verbinding wordt gemaakt met de server.

Adobe gehoste aanbevelingen voor SFTP-servers adobe-hosted-sftp-server-recommendations

Als u bestanden en data beheert voor ETL-doeleinden, worden deze bestanden opgeslagen op een gehoste SFTP-server die door Adobe wordt geleverd. Deze SFTP is ontworpen als een tijdelijke opslagruimte waarop u het bewaren en verwijderen van bestanden kunt regelen.

Wanneer deze ruimte niet correct wordt gebruikt of gecontroleerd, kan deze snel de fysieke ruimte op de server vullen en ernstige problemen veroorzaken. Dit kan leiden tot verlies of beschadiging van de data op uw platform.

Om dergelijke problemen te voorkomen, wordt u aangeraden de onderstaande best practices op te volgen:

  • Beperk het aantal data tot een minimum.
  • Gebruik op sleutels gebaseerde verificatie om te voorkomen dat het wachtwoord vervalt. Ondersteunde indelingen zijn alleen OpenSSH en SSH2. U zult de publieke sleutel aan het Adobe-supportteam moeten verstrekken zodat deze naar de Campaign-server kan worden geüpload.
  • Bewaar de data slechts zolang als nodig is. 15 dagen is de maximale tijdslimiet.
  • Gebruik workflows om de data op de juiste manier te verwijderen (beheer de retentie van workflows die de data verbruiken).
  • Gebruik batchverwerking in SFTP-uploads en in workflows.
  • Verwerk fouten/uitzonderingen.
  • Meld u af en toe aan bij de SFTP om de content rechtstreeks te controleren.
  • Vergeet niet dat SFTP-schijfbeheer in de eerste plaats uw verantwoordelijkheid is.

Ook, merk op dat openbare IPs waarvan u probeert om de verbinding in werking te stellen SFTP aan de lijst van gewenste personen op de instantie van de Campagne moet worden toegevoegd. Het toevoegen van IP adressen aan de lijst van gewenste personen kan via worden gevraagd ondersteuningsticket, samen met het verstrekken van de openbare sleutel voor authentificatie te gebruiken.

SFTP-servers kunnen worden beheerd via het Configuratiescherm. Zie de Configuratiescherm-documentatie voor meer informatie.

NOTE
Het configuratiescherm is toegankelijk voor alle gebruikers met beheerdersrechten. De stappen om toegang met beheerdersrechten aan een gebruiker te verlenen worden gedetailleerd beschreven op deze pagina.

OAuth 2.0-account oauth-account

Geef voor een externe OAuth 2.0-rekening de volgende gegevens:

  • A Type subsidie alleen : clientgegevens wordt ondersteund.
  • A Secure API URL: voer het eindpunt van de autorisatie in.
  • OAuth 2.0 gevoelige geloofsbrieven: Deze sectie is bedoeld voor referenties die van nature gevoelig zijn. Referentiewaarden worden op het scherm gemaskeerd nadat ze zijn toegevoegd. Op dat punt kunnen ze niet worden gelezen en kunnen ze niet worden bewerkt. Als voor het eindpunt van de autorisatie een bepaalde referentie moet worden ingevoegd in de HTTP-autorisatieheader in plaats van in de hoofdtekst van de POST, kunt u de optie Opnemen in koptekst voor die referentie selecteren.
  • Niet-vertrouwelijke 2.0-gegevens: Deze sectie is bedoeld voor referenties die niet gevoelig van aard zijn. Referentiewaarden zijn op het scherm zichtbaar nadat ze zijn toegevoegd. Ze kunnen ook worden bewerkt. Als voor het eindpunt van de autorisatie een bepaalde referentie moet worden ingevoegd in de HTTP-autorisatieheader in plaats van in de hoofdtekst van de POST, kunt u de optie Opnemen in koptekst voor die referentie selecteren.

Nadat u de accountgegevens hebt ingevoerd, klikt u op Verbinding testen om te controleren of de externe account correct is geconfigureerd.

NOTE
De geloofsbrieven "Content-Type: application/x-www-form-urlencoded"en "gift_type=client_credentials"zullen automatisch aan de API vraag worden toegevoegd; daarom zult u niet hen in de geloofsbrieven sectie moeten toevoegen.

Amazon S3 externe account amazon-s3-external-account

Het Amazon S3-serverveld moet als volgt worden ingevuld:

<S3 bucket name>.s3.amazonaws.com/<s3 object path>

Om uw bestand in de gecodeerde S3-modus op te slaan, vinkt u het vakje Keep files in S3 encrypted aan.

De benodigde informatie wordt meestal verstrekt door de provider van de server waarmee u verbinding maakt.

Specificeer de AWS Region voor uw eindpunt. U kunt de ondersteunde regio's en handtekeningversies controleren in de officiële Amazon S3-documentatie.

NOTE
Uw Receiver server moet zonder uw AWS-regio worden ingevoerd. De data worden later automatisch aan uw URL toegevoegd.

Aanbevelingen voor Amazon S3-accounts amazon-s3-account-recommendations

We raden u aan de volgende aanbevelingen te volgen om u te helpen bij het instellen van uw Amazon S3-account:

  • Creëer een strikt bucketbeleid om de toegang tot S3-buckets te beperken. Het bucketbeleid kan worden geconfigureerd tijdens het maken van een bucket. Zie de Amazon S3-documentatie voor meer informatie.
  • Schakel tijdens het maken van een extern account codering in voor het opslaan van gevoelige data in het S3-bucket door het selectievakje Keep files in S3 encrypted aan te vinken.
  • Verleen bucketmachtigingen om aan te geven wie toegang heeft tot het object in een bucket. Zie de Amazon S3-documentatie voor meer informatie over bucketmachtigingen.

Externe Adobe Experience Manager-account adobe-experience-manager-external-account

De externe accounts van Adobe Experience Manager worden gebruikt bij de integratie van Campaign met Experience Manager.

De processen en vereisten met betrekking tot deze integratie zijn beschikbaar in dit document.

Wanneer u deze nieuwe externe account instelt, moet u de volgende gegevens opgeven:

  • Server: Voer de URL van de Adobe Experience Manager-server in. Bijvoorbeeld:

    code language-none
    http://aem.domain.com:4502
    
  • Aanmeldingsgegevens voor AEM-account: gebruik het account dat toegang nodig heeft tot de Adobe Experience Manager-instantie. Het zou een accountonderdeel moeten zijn van de groep campaign-remote in Experience Manager.

Google reCAPTCHA externe account google-recaptcha-external-account

NOTE
Voor de Google reCAPTCHA-configuratie is een Google-account vereist.

Met het Google reCAPTCHA-mechanisme kunt u uw landingspagina beschermen tegen spam en misbruik door bots. Dit is niet opdringerig voor uw klanten omdat het geen enkele interactie van hen vereist en gebaseerd is op interacties met uw site. Raadpleeg deze pagina om uw site te registreren. U moet het type V3 reCAPTCHA kiezen.

Als u de Google reCAPTCHA V3 aan u landingspagina wilt toevoegen, configureert u deze in uw externe account. Raadpleeg deze sectie voor meer informatie over het toevoegen van reCAPTCHA V3 aan de landingspagina.

Geef voor een extern Google reCAPTCHA V3-account de volgende data op:

  • Een Label en ID van uw externe account

  • Type: Google reCAPTCHA

  • Uw Site key en Site secret

  • Een Threshold tussen 0 en 1

    Een waarde van 0,0 bij Threshold betekent dat het waarschijnlijk een bot is en 1,0 geeft een waarschijnlijk goede interactie aan. Standaard kunt u een drempel van 0,5 gebruiken.

Microsoft Azure Blob-opslag, externe account microsoft-azure-external-account

NOTE
U vindt de informatie die nodig is om uw externe account in Adobe Campaign Standard te configureren in de Azure Portal door Settings > Access keys te selecteren.

De Azure Blob-opslagconnector kan worden gebruikt voor het importeren of exporteren van data naar Adobe Campaign via een Transfer file workflowactiviteit. Raadpleeg deze sectie voor meer informatie.

Geef de volgende data op voor een extern account voor Microsoft Azure Blob-opslag:

  • Een Label en ID van uw externe account
  • Type: Microsoft Azure Blob-opslag
  • Uw Account name en Account key. Als u wilt weten waar u de naam en sleutel van uw account vindt, raadpleeg dan deze pagina.
  • Uw Endpoint suffix. Deze staat in de Connection string van het menu Access keys in de Azure Portal. Raadpleeg deze pagina voor meer informatie.
  • Uw Container-naam. Als u meerdere containers wilt gebruiken, maakt u zoveel externe accounts als containers.
  • Met de optie Concurrency kunt u de snelheid van de bestandsoverdracht afstemmen.

Als de configuratie voltooid is, klikt u op Test connection om Adobe Campaign te koppelen aan Microsoft Azure Blob-opslag.

Microsoft Azure Blob-opslagaanbevelingen azure-blob-recommendations

Codering

Adobe Campaign gebruikt een beveiligde verbinding (HTTPS) om toegang te krijgen tot uw Microsoft Azure Blob-opslagaccount.

Accountsleutel

Bij het configureren van uw externe account moet u gebruik maken van een van de Account key die beschikbaar is in de Azure Portal. Raadpleeg deze pagina voor meer informatie over waar u uw accountsleutels kunt vinden.

De bestandsoverdrachtsnelheid optimaliseren

Met de optie Concurrency kunt u de snelheid van de bestandsoverdracht afstemmen.
Deze staat voor het aantal threads dat zal worden gebruikt om de bestandsoverdracht uit te voeren. Elk van deze threads zal een gedeelte van ongeveer 1 MB van de blob downloaden. Ze worden dan in de wachtrij gezet om naar schijf te worden geschreven. Door het aantal threads te verhogen, verhoogt u ook de belasting van de bronnen die door de applicatie worden gebruikt tijdens de bestandsoverdracht.

Na afronding van de bestandsoverdracht kunt u de statistische prestatiegegevens teruglezen in de workflowlogboeken.

Hernieuwde pogingen

Standaard beschikt de bestandsoverdracht voor Azure Blob over vier hernieuwde pogingen. Als de Azure Storage-service een foutcode retourneert zoals 503 (server bezet) of 500 (time-out van bewerking), kan dit erop wijzen dat u de schaalbaarheid van uw opslagaccount nadert of overschrijdt. Dit kan gebeuren als u een nieuw account gebruikt of tests uitvoert.

Als de fout zich blijft voordoen, kunt u het aantal hernieuwde pogingen verhogen door een optie te creëren onder het geavanceerde menu Administration > Application Settings > Options.

Als de optie wordt geïmplementeerd, dient deze als volgt te worden gemaakt:

ID:        AzureBlob_Max_Retries
Date type: Integer
Default:   <the number of retries needed>
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff