Dokumentation AEM Självstudiekurser om AEM Självstudiekurser om AEM as a Cloud Service

Konfigurera OpenAPI-baserade AEM API:er

Last update: Wed Jun 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gäller:
Experience Manager as a Cloud Service

Ämnen:
Utveckling

Skapat för:

Nybörjare
Utvecklare
Ledare

Lär dig hur du konfigurerar AEM as a Cloud Service-miljön för att ge åtkomst till OpenAPI-baserade AEM API:er.

I det här exemplet används AEM Assets-API:t som använder autentiseringsmetoden Server-till-server för att demonstrera konfigurationsprocessen. Samma steg kan följas för andra OpenAPI-baserade AEM-API:er.

https://video.tv.adobe.com/v/3457510?quality=12&learn=on

Konfigurationsprocessen på hög nivå omfattar följande steg:

Modernisering av AEM as a Cloud Service-miljön.
Aktivera åtkomst till AEM API:er.
Skapa Adobe Developer Console-projekt (ADC).
Konfigurera ADC-projekt.
Konfigurera AEM-instansen för att aktivera ADC-projektkommunikation.

Modernisering av AEM as a Cloud Service miljö modernization-of-aem-as-a-cloud-service-environment

Moderniseringen av AEM as a Cloud Service-miljön är en engångsåtgärd per miljö som omfattar följande steg:

Uppdatera till AEM-utgåvan 2024.10.18459.20241031T210302Z eller senare.
Lägg till nya produktprofiler i den om miljön skapades före utgåvan 2024.10.18459.20241031T210302Z.

Uppdatera AEM-instans update-aem-instance

Om du vill uppdatera AEM-instansen väljer du ellipsikonen bredvid miljönamnet i Adobe Cloud Managers Environment och sedan alternativet Update .

Uppdatera AEM-instans

Klicka sedan på knappen Skicka och kör den föreslagna kompletta stackpipeline.

Välj den senaste versionen av AEM

I det här fallet heter Pipeline i helhög Dev :: Fullstack-Deploy och AEM-miljön kallas wknd-program-dev. Dina namn kan vara olika.

Lägg till nya produktprofiler add-new-product-profiles

Om du vill lägga till nya produktprofiler i AEM-instansen går du till avsnittet Miljö för Adobe Cloud Manager och markerar ikonen ellips bredvid miljönamnet. Välj sedan alternativet Lägg till produktprofiler .

Lägg till nya produktprofiler

Du kan granska de nya produktprofilerna genom att klicka på ikonen ellips bredvid miljönamnet och välja Hantera åtkomst > Författarprofiler.

Fönstret Admin Console visar de nya produktprofilerna.

Granska nya produktprofiler

Ovanstående steg avslutar moderniseringen av AEM as a Cloud Service-miljön.

Aktivera åtkomst till AEM API:er enable-aem-apis-access

Förekomsten av de nya produktprofilerna aktiverar OpenAPI-baserad AEM API-åtkomst i Adobe Developer Console (ADC). Kom ihåg att Adobe Developer Console (ADC) är utvecklarnavet för åtkomst till Adobe API:er, SDK:er, realtidshändelser, serverlösa funktioner med mera.

De nya produktprofilerna är kopplade till tjänsterna som representerar AEM-användargrupper med fördefinierade åtkomstkontrollistor. Tjänsterna används för att styra åtkomstnivån för AEM API:er.

Du kan också markera eller avmarkera de tjänster som är kopplade till produktprofilen för att minska eller öka åtkomstnivån.

Granska associationen genom att klicka på ikonen Visa detaljer bredvid produktprofilens namn.

Granska tjänster som är kopplade till produktprofilen

Aktivera åtkomst till AEM Assets API:er enable-aem-assets-apis-access

Som standard är AEM Assets API-användartjänsten inte kopplad till någon produktprofil. Låt oss associera det med den nya produktprofilen AEM Assets Collaborator Users - författare - Program XXX - Miljö XXX eller någon annan produktprofil som du vill använda för AEM Assets API-åtkomst.

Koppla AEM Assets API-användartjänst till produktprofil

Aktivera autentisering från server till server

Om du vill aktivera autentisering från server till server för de AEM-API:er du vill använda måste användaren som konfigurerar integrering med Adobe Developer Console (ADC) läggas till som utvecklare i den produktprofil där tjänsten är kopplad.

Om du till exempel vill aktivera autentisering från server till server för AEM Assets API måste användaren läggas till som utvecklare i produktprofilen för AEM Assets Collaborator Users - författare - Program XXX - Miljö XXX.

Koppla utvecklare till produktprofil

Efter den här associationen kan ADC-projektets API för tillgångsförfattare ställa in önskad server-till-server-autentisering och associera autentiseringskontot från ADC-projektet (som skapades i nästa steg) med produktprofilen.

IMPORTANT

Ovanstående steg är viktigt för att aktivera autentisering från server till server för önskat AEM API. Utan den här associationen kan AEM API inte användas med autentiseringsmetoden Server-till-server.

Skapa Adobe Developer Console-projekt (ADC) adc-project

ADC-projektet används för att lägga till önskade API:er, konfigurera autentiseringen och associera autentiseringskontot med produktprofilen.

Så här skapar du ett ADC-projekt:

Logga in på Adobe Developer Console med din Adobe ID.
I avsnittet Snabbstart klickar du på knappen Skapa nytt projekt .
Ett nytt projekt med standardnamnet skapas.
Redigera projektnamnet genom att klicka på knappen Redigera projekt i det övre högra hörnet. Ange ett beskrivande namn och klicka på Spara.

Konfigurera ADC-projekt configure-adc-project

När du har skapat ADC-projektet måste du lägga till de AEM-API:er du vill använda, konfigurera autentiseringen och associera autentiseringskontot med produktprofilen.

Om du vill lägga till AEM API:er klickar du på knappen Lägg till API .

I dialogrutan Lägg till API filtrerar du efter Experience Cloud och väljer önskat AEM-API. I det här fallet har till exempel API:t för resursförfattare valts.

Lägg till AEM API

note tip
TIP
Om AEM API-kortet är inaktiverat och Varför är det inaktiverat? information visar meddelandet Licens krävs. En av orsakerna kan vara att du INTE har moderniserat din AEM as a Cloud Service-miljö. Mer information finns i Modernisering av AEM as a Cloud Service-miljön.

I dialogrutan Konfigurera API väljer du sedan önskat autentiseringsalternativ. I det här fallet är autentiseringsalternativet Server-till-server markerat.

Välj autentisering

Server-till-server-autentiseringen är idealisk för backend-tjänster som behöver API-åtkomst utan användarinteraktion. Autentiseringsalternativen Web App och Single Page App är lämpliga för program som behöver API-åtkomst åt användarna. Mer information finns i Skillnaden mellan autentiseringsuppgifter för OAuth Server-to-Server och Web App respektive Single Page App.

note tip
TIP
Om du inte ser autentiseringsalternativet Server-till-server betyder det att användaren som ställer in integreringen inte läggs till som utvecklare i den produktprofil där tjänsten är kopplad. Mer information finns i Aktivera autentisering från server till server.

Om det behövs kan du byta namn på API:t för enklare identifiering. I demosyfte används standardnamnet.
I det här fallet är autentiseringsmetoden OAuth Server-to-Server så du måste associera autentiseringskontot med produktprofilen. Välj AEM Assets Collaborator Users - författare - Program XXX - Miljö XXX Produktprofil och klicka på Spara.
Granska AEM API och autentiseringskonfigurationen.

Om du väljer autentiseringsmetoden OAuth Web App eller OAuth Single Page App uppmanas inte associationen för produktprofilen, men en omdirigerings-URI krävs. Omdirigerings-URI för programmet används för att dirigera om användaren till programmet efter autentisering med en auktoriseringskod. De relevanta självstudiekurserna för användningsfall beskriver sådana autentiseringsspecifika konfigurationer.

Konfigurera AEM-instansen för att aktivera ADC-projektkommunikation configure-aem-instance

Om du vill att ADC-projektets ClientID ska kunna kommunicera med AEM-instansen måste du konfigurera AEM-instansen.

Detta görs genom att definiera API-konfigurationen i en YAML-fil och distribuera den med Config Pipeline i Cloud Manager. YAML-filen definierar de tillåtna klient-ID:n från ADC-projektet som kan kommunicera med AEM-instansen.

Leta reda på eller skapa filen api.yaml från mappen config i AEM Project.

{width="500"}

Lägg till följande konfiguration i filen api.yaml.

code language-yaml
`kind: "API" version: "1.0" metadata: envTypes: ["dev", "stage", "prod"] data: allowedClientIDs: author: - "<ADC Project's Credentials ClientID>"`

Ersätt <ADC Project's Credentials ClientID> med det faktiska klient-ID:t för ADC-projektets autentiseringsuppgifter-värde. API-slutpunkten som används i den här självstudiekursen är bara tillgänglig på författarnivån, men för andra API:er kan yaml-konfigurationen också ha en publish - eller preview -nod.

note caution
CAUTION
För demoändamål används samma ClientID för alla miljöer. Vi rekommenderar att du använder ett separat ClientID per miljö (dev, stage, prod) för bättre säkerhet och kontroll.

Bekräfta konfigurationsändringarna och skicka ändringarna till Git-fjärrdatabasen som Cloud Manager pipeline är ansluten till.
Distribuera ovanstående ändringar med Config Pipeline i Cloud Manager. Observera att filen api.yaml också kan installeras i en RDE med kommandoradsverktyg.

Nästa steg

När AEM-instansen har konfigurerats för att aktivera ADC-projektkommunikation kan du börja använda de OpenAPI-baserade AEM-API:erna. Lär dig hur du använder OpenAPI-baserade AEM API:er med olika OAuth-autentiseringsmetoder: