Commerce Services Connector
Sommige Adobe Commerce- en Magento Open Source-functies worden aangestuurd door Commerce Services en geïmplementeerd als SaaS (software als service). Om deze diensten te gebruiken, moet u uw Commerce instantie verbinden gebruikend productie en zandbak API sleutels, en de gegevensruimte in de configuratie specificeren. U hoeft de verbinding slechts één keer voor elke instantie te configureren.
Alleen de eigenaar van de Commerce -licentie kan deze API-sleutels genereren. Als u niet de eigenaar van de licentie bent, vraagt u de sleutels aan bij de persoon of het team die de Commerce-licentie voor uw winkel heeft.
Beschikbare services availableservices
In het volgende voorbeeld worden de Commerce -functies weergegeven waartoe u toegang hebt via Commerce Services Connector :
Architectuur
Op hoog niveau bestaat de Commerce Services Connector uit de volgende kernelementen:
In de volgende secties wordt elk van deze elementen nader besproken.
Credentials apikey
De productie en zandbak API sleutels worden geproduceerd van de Commerce rekening van de vergunningseigenaar . Het Commerce-account wordt geïdentificeerd door een unieke Commerce ID (MageID). De eigenaar van de licentie voor de organisatie van de handelaar kan API-sleutels genereren voor services zoals productaanbevelingen of Live Search, zolang de account zich in goede staat bevindt.
De sleutels kunnen op een "behoefte-aan-weet"basis met het systeemintegrator of ontwikkelingsteam worden gedeeld dat projecten en milieu's namens de vergunninghouder beheert. Ontwikkelaars die Shared Access door de eigenaar van de licentie hebben gekregen, kunnen de sleutels niet namens de eigenaar van de licentie genereren, zelfs niet als de organisatie van de handelaar aanwezig is in het vervolgkeuzemenu van Switch Accounts voor hun account.
Daarnaast kunnen integrators van oplossingen Commerce Services gebruiken. Als u een integrator van de oplossing bent, zou de ondertekenaar van het Commerce partnercontract de API sleutels moeten produceren.
De belangrijkste herkenningstekens Productie en Sandbox verwijzen naar milieu's van het gegevensgebied SaaS waar Commerce Services gegevens (niet aan uw milieu's van Adobe Commerce) opslaat. U kunt dezelfde set API-sleutels gebruiken voor uw lokale, ontwikkelings-, staging- en productieomgeving. Het belangrijkste is dat u het juiste sleutelpaar plakt voor de gegevensruimte die u configureert.
De eigenaar van de licentie is doorgaans de primaire contactpersoon op de Adobe Commerce-account en is niet altijd dezelfde als de projecteigenaar van de Adobe Commerce voor het infrastructuurproject in de cloud.
De API-sleutels voor productie en sandbox genereren genapikey
-
Login aan uw Commerce rekening in https://account.magento.com .
-
Onder het Magento lusje, uitgezochte API Portaal op sidebar.
-
Van het Milieu menu, uitgezochte Productie of Sandbox.
-
Ga een naam in de API Sleutels sectie in, en klik voeg Nieuw toe om de dialoog te openen om de nieuwe sleutel te downloaden.
note warning WARNING U kunt de persoonlijke sleutel slechts eenmaal kopiëren of downloaden. Bewaar deze veilig. -
Klik Download om de privé sleutel te bewaren, dan de dialoog te sluiten.
-
Herhaal bovenstaande stappen voor elke omgeving (productie en sandbox).
De API Sleutels sectie toont nu uw (Openbare) API sleutels. U hebt alle vier sleutels (zowel de productie als zandbaksleutels, Public+Private) nodig wanneer u selecteert of een project SaaS in om het even welke milieu's of installaties verbonden aan de vergunning creeert.
SaaS-configuratie saasenv
Commerce -instanties moeten worden geconfigureerd met een SaaS-project en een SaaS-gegevensruimte, zodat Commerce Services gegevens naar de juiste locatie kan verzenden. Een SaaS-project groepeert alle SaaS-gegevensruimten. De SaaS gegevensruimten worden gebruikt om gegevens te verzamelen en op te slaan die Commerce Services toelaat om te werken. Sommige van deze gegevens kunnen worden geëxporteerd uit de Commerce -instantie en sommige kunnen worden verzameld op basis van winkelgedrag in de winkel. Die gegevens blijven vervolgens bewaard om de cloudopslag te beveiligen.
Voor Product Recommendations en Live Search bevat de SaaS-gegevensruimte catalogus- en gedragsgegevens. U kunt a Commerce instantie aan aSaaS gegevensruimte richten door het te selecteren in de Commerce configuratie.
Als u de configuratievelden van Live Search niet kunt vinden in de beheerfunctie, controleert u of u het juiste API-sleutelpaar hebt ingevoerd voor de gegevensruimte die u hebt geselecteerd (voor productiedesecties worden productietoetsen gebruikt; voor het testen van gegevensruimten worden sandboxsleutels gebruikt). Als u onjuiste toetsen configureert, zijn SaaS-services zoals Live Search niet beschikbaar in die Adobe Commerce-omgeving.
Een API-sleutel verwijderen delapikey
Voordat u een API-sleutel verwijdert, moet u een vervangende sleutel genereren en veilig opslaan. Werk alle integratie bij om de nieuwe sleutel te gebruiken, en bevestig dat de afhankelijke diensten zoals verwacht werken.
Als u de configuratievelden van Live Search niet ziet in het deelvenster Beheer, controleert u of u de juiste SaaS API-sleutel voor die omgeving hebt ingevoerd. Gebruik de productieSaaS sleutel voor de ruimte van productiegegevens en de het opvoeren sleutel voor de het opvoeren gegevensruimte. Als de verkeerde sleutel is geconfigureerd, zijn SaaS-services (inclusief Live Search) niet beschikbaar in uw Adobe Commerce-omgeving.
Klik op Delete op de API-sleutel die u wilt verwijderen. Bevestig bij de aanwijzing de bewerking om de toets permanent te verwijderen.
SaaS-gegevensruimteprovisioning
Alle Adobe Commerce-handelaren hebben per SaaS-project toegang tot één ruimte voor productiegegevens en twee ruimten voor testgegevens.
U kunt de testgegevensruimten gebruiken in niet-productieomgevingen, maar u kunt niet tegelijkertijd in meerdere omgevingen dezelfde gegevensruimte gebruiken. Als u een testgegevensruimte naar een andere omgeving wilt verplaatsen, moet u de gegevens opschonen voordat u deze in de nieuwe omgeving selecteert en configureert.
Voor de Pro projecten van de Wolk van de Handel van Adobe met veelvoudige het opvoeren milieu's, kunt u extra het testen gegevensruimten voor elk het opvoeren milieu verzoeken door een verzoek van de Steun voor te leggen. Als u echter maar één testomgeving hebt en extra testgegevenspaties nodig hebt, hebt u de volgende opties:
-
Neem contact op met het team voor succes van de klant of met de door u aangewezen manager voor succes van de klant om een extra testomgeving aan te vragen.
-
legt een verzoek van de Steun voor om de extra het testen gegevensruimte te verzoeken en op de bedrijfsrechtvaardiging voor de extra gegevensruimte te wijzen. Dit verzoek moet worden goedgekeurd.
Magento Open Source-klanten die Adobe Payment Services gebruiken, kunnen ook om een extra gegevensruimte vragen. Contacteer het team van Betalingen voor vroegere goedkeuring van de extra gegevensruimten alvorens het verzoek van de a Steun voor te leggen om de het testen gegevensruimte te verzoeken.
De klanten die veelvoudige projecten van de Wolk of op-gebouw (levend/productie) installaties bezitten kunnen extra productie en het testen gegevensruimten voor elk project of instantie ook verzoeken door een verzoek van de Steun voor te leggen.
Een SaaS-project selecteren of maken createsaasenv
Als u een SaaS-project wilt selecteren of maken, vraagt u de API-sleutels van Commerce aan bij de eigenaar van de Commerce -licentie voor uw winkel:
-
Op Admin sidebar, ga Systeem > de Diensten > Schakelaar van de Diensten van Commerce.
Als u niet de Commerce Services Connector sectie ziet, installeer de Commerce modules voor uw gewenste Commerce dienst en zorg ervoor dat het
magento/module-services-idpakket geïnstalleerd is. -
Plak de hoofdwaarden in de secties Sandbox API KeysenProduction API Keys .
- Persoonlijke sleutels moeten
-----BEGIN PRIVATE KEY-----aan het begin van de toets en-----END PRIVATE KEY-----aan het einde van de toets bevatten. - Als u geen exemplaar van de daadwerkelijke sleutels hebt, vraag de vergunningseigenaar voor hen, dan stop de waarden in de configuratie.
Plak geen sleutelwaarden die uit een gegevensbestandsteun of een momentopname worden gekopieerd. Wanneer de configuratie wordt opgeslagen, wordt een extra coderingslaag toegepast en werken de sleutels niet.
- Persoonlijke sleutels moeten
-
Klik sparen.
Om het even welke projecten SaaS die met uw sleutels worden geassocieerd verschijnen op het 1} gebied van het Project {in de sectie van het Herkenningsteken SaaS.
-
Als geen projecten SaaS bestaan, leidt de klik tot Project. Dan op het gebied van het Project, ga een naam voor uw project SaaS in.
Om verwarring te vermijden, gebruik geen specifieke dienst van Commerce als naam voor uw project (bijvoorbeeld, Levend Onderzoek, Aanbevelingen van het Product, of Verbinding van Gegevens). Tenzij uw vergunning voor veelvoudige projecten SaaS is provisioned, kunt u het zelfde project SaaS voor de veelvoudige diensten gebruiken.
-
Selecteer de Ruimte van Gegevens voor de huidige configuratie van uw Commerce opslag te gebruiken.
Als u afzonderlijke instanties hebt om met de Diensten van Commerce te integreren, een kaartje van de Steun voorleggen om een nieuw project SaaS voor elke extra instantie te verzoeken. Nadat de Steun tot het project SaaS leidt, vorm de integratie voor de instantie gebruikend de zelfde API sleutels en het selecteren van het nieuwe project SaaS voor de gegevensruimte.
Om de namen van uw project SaaS of gegevensruimte te veranderen, klik anders noemen naast één van beide. Het veranderen van de naam beïnvloedt niet uw dienst omdat de naam slechts een etiket is om u te helpen tussen projecten en gegevensruimten identificeren en onderscheiden.
IMS-organisatie (optioneel) organizationid
Als u uw Adobe Commerce-exemplaar wilt verbinden met de Adobe Experience Platform, meldt u zich aan bij uw Adobe-account met uw Adobe ID. Nadat u zich hebt aangemeld, wordt de IMS-organisatie die is gekoppeld aan uw Adobe-account in deze sectie weergegeven.
SaaS-gegevens exporteren
Wanneer uw Commerce -instantie verbinding heeft gemaakt met Commerce Services , exporteert het SaaS-gegevensexportproces Commerce-gegevens van uw Commerce -server naar Commerce SaaS Services , zodat deze kunnen worden gesynchroniseerd met verbonden Commerce Services. In Admin, kunt u synchronisatiestatus controleren gebruikend het dashboard van het Beheer van Gegevens . Voor details, zie de Gids van de Uitvoer van Gegevens SaaS .