DocumentatieAEMTutorials voor AEMTutorials voor AEM as a Cloud Service

AEM API's instellen die zijn gebaseerd op OpenAPI

Last update: Thu Apr 17 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beginner
  • Ontwikkelaar
  • Leider

Leer hoe u uw AEM as a Cloud Service-omgeving instelt om toegang tot de op OpenAPI gebaseerde AEM API's mogelijk te maken.

video poster

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

Het installatieproces op hoog niveau omvat de volgende stappen:

  1. Modernisering van de AEM as a Cloud Service-omgeving.
  2. Toegang tot AEM API's inschakelen.
  3. Maak een Adobe Developer Console-project (ADC).
  4. ADC-project configureren.
  5. Vorm de instantie van AEM om de mededeling van het Project van ADC toe te laten.

Modernisering van de AEM as a Cloud Service-omgeving modernization-of-aem-as-a-cloud-service-environment

De modernisering van het milieu van AEM as a Cloud Service is een eenmalige milieuactiviteit die de volgende stappen omvat:

  • Update aan de Versie van AEM 2024.10.18459.20241031T210302Z of later.
  • Voeg er nieuwe productprofielen aan toe als de omgeving is gemaakt vóór de release 2024.10.18459.20241031T210302Z.

AEM-instantie bijwerken update-aem-instance

Om de instantie van AEM bij te werken, in de Adobe Cloud Manager van de Milieu sectie van 1} {, selecteer het ellips pictogram naast de milieunaam en selecteer optie van de Update.

Update AEM instantie

Dan klik voorleggen knoop en stel gesuggereerde FullstackPipeline in werking.

Uitgezochte recentste versie van de versie van AEM

In mijn geval, wordt de FullstackPipeline genoemd Dev:: Fullstack-Deploy, en het milieu van AEM wordt genoemd wknd-programma-dev. Uw namen kunnen verschillen.

Nieuwe productprofielen toevoegen add-new-product-profiles

Om nieuwe Profielen van het Product aan de instantie van AEM toe te voegen, in de 2} sectie van de Milieu's 🔗 van Adobe __, selecteer het ellips pictogram naast de milieunaam en selecteer toevoegen de optie van de Profielen van het Product.

voeg nieuwe Profielen van het Product toe

U kunt de onlangs toegevoegde Profielen van het Product herzien door op het ellips pictogram naast de milieunaam te klikken en te selecteren beheert Toegang > Profielen van de Auteur.

Het Admin Console venster toont de onlangs toegevoegde Profielen van het Product.

Herzie nieuwe Profielen van het Product

Met de bovenstaande stappen wordt de modernisering van de AEM as a Cloud Service-omgeving voltooid.

Toegang tot AEM API's inschakelen enable-aem-apis-access

De aanwezigheid van de nieuwe Profielen van het Product laat op OpenAPI-Gebaseerde toegang van AEM API in Adobe Developer Console (ADC) toe. Rappel dat Adobe Developer Console (ADC)de ontwikkelaarshub voor de toegang tot van Adobe APIs, SDKs, gebeurtenissen in real time, serverless functies, en meer is.

De onlangs toegevoegde Profielen van het Product worden geassocieerd met de Diensten die gebruikersgroepen van AEM met vooraf bepaalde Lijsten van het Toegangsbeheer (ACLs) vertegenwoordigen. De Diensten worden gebruikt om het niveau van toegang tot AEM APIs te controleren.

U kunt de Diensten ook selecteren of schrappen verbonden aan het Profiel van het Product om het niveau van toegang te verminderen of te verhogen.

Herzie de vereniging door op het pictogram van de Details van de Mening naast de naam van het Profiel van het Product te klikken.

{de diensten van het 0} Overzicht verbonden aan het Profiel van het Product

Door gebrek, wordt de AEM Assets API Gebruikers Dienst niet geassocieerd met om het even welk Profiel van het Product. Laat ons het met de onlangs toegevoegde Gebruikers van de Medewerker van AEM Assets associëren - auteur - Programma XXX - Milieu XXX Profiel van het Product. Na deze vereniging, kan de 20} ActivaAuteur API van het Project ADC opstelling de gewenste Server-aan-Server authentificatie en de authentificatierekening van het project associëren ADC (die in volgende stap) met het Profiel van het Product wordt gecreeerd.

associeerde de Dienst van de Gebruikers van AEM Assets API met het Profiel van het Product

IMPORTANT
De bovenstaande stap is van essentieel belang om de Server-to-Server-verificatie voor de AEM Assets API in te schakelen. Zonder deze koppeling kan de AEM Assets API niet worden gebruikt met de Server-to-Server verificatiemethode.

Adobe Developer Console-project (ADC) maken adc-project

Het ADC-project wordt gebruikt om de gewenste API's toe te voegen, de verificatie ervan in te stellen en de verificatieaccount aan het productprofiel te koppelen.

Een ADC-project maken:

  1. Login aan Adobe Developer Consolegebruikend uw Adobe ID.

    Adobe Developer Console

  2. Van de Snelle sectie van het Begin, klik op creeer nieuwe project knoop.

    creeer nieuw project

  3. Het leidt tot een nieuw project met de standaardnaam.

    Nieuw gecreeerd project

  4. Bewerk de projectnaam door te klikken uitgeeft project knoop in de hoogste juiste hoek. Verstrek een betekenisvolle naam en klik sparen.

    geef projectnaam uit

ADC-project configureren configure-adc-project

Nadat u het ADC-project hebt gemaakt, moet u de gewenste AEM API's toevoegen, de verificatie ervan instellen en de verificatieaccount aan het productprofiel koppelen.

  1. Om AEM APIs toe te voegen, klik op voeg API knoop toe.

    voeg API toe

  2. In voeg API dialoog toe, filter door Experience Cloud en selecteer gewenste AEM API. Bijvoorbeeld, in dit geval, wordt Auteur API van Activa geselecteerd.

    voeg AEM API toe

  3. Daarna, in vorm API dialoog, selecteer de gewenste authentificatieoptie. Bijvoorbeeld, in dit geval, wordt de server-aan-Server authentificatieoptie geselecteerd.

    Uitgezochte authentificatie

    De server-aan-server authentificatie is ideaal voor de backenddiensten die API toegang zonder gebruikersinteractie vereisen. De opties Web App en Single Page App voor verificatie zijn geschikt voor toepassingen die API-toegang nodig hebben namens gebruikers. Zie Verschil tussen Server-aan-Server van OAuth vs Web App vs Één enkele geloofsbrieven van de Toepassing van de Paginavoor meer informatie.

  4. Indien nodig kunt u de naam van de API wijzigen om deze gemakkelijker te kunnen identificeren. Voor demo-doeleinden wordt de standaardnaam gebruikt.

    noem referentie anders

  5. In dit geval, is de authentificatiemethode OAuth Server-aan-Server zodat moet u de authentificatierekening met het Profiel van het Product associëren. Selecteer de Gebruikers van de Medewerker van AEM Assets - auteur - Programma XXX - het Profiel van het Product van Milieu XXX en klik sparen.

    Uitgezochte Profiel van het Product

  6. Controleer de AEM API- en verificatieconfiguratie.

    de configuratie van AEM API

    configuratie van de Authentificatie

Als u of OAuth App authentificatiemethode van de Toepassing van de Toepassing van de enig-Pagina kiest, wordt de vereniging van het Profiel van het Product niet veroorzaakt maar de toepassing richt URI wordt vereist. De URI voor omleiding van de toepassing wordt gebruikt om de gebruiker na verificatie met een machtigingscode om te leiden naar de toepassing. In de relevante zelfstudies voor gebruiksgevallen worden dergelijke configuraties beschreven die specifiek zijn voor verificatie.

De AEM-instantie configureren om ADC-projectcommunicatie in te schakelen configure-aem-instance

Om de ClientID van het Project van ADC aan communicatie met de instantie van AEM toe te laten, moet u de instantie van AEM vormen.

Het wordt gedaan door de API configuratie in een dossier te bepalen YAML en het op te stellen gebruikend de Pijpleiding Config in Cloud Manager. Het dossier YAML bepaalt toegestane ClientIDs van het Project ADC dat met de instantie van AEM kan communiceren.

  1. Zoek in AEM Project het api.yaml -bestand in de map config of maak dit.

    plaats API YAML {width="500"}

  2. Voeg de volgende configuratie toe aan het api.yaml dossier.

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

    Vervang <ADC Project's Credentials ClientID> door de werkelijke ClientID van de Credentials-waarde van het ADC-project. Het API eindpunt dat in dit leerprogramma wordt gebruikt is beschikbaar slechts op de auteurslaag, maar voor andere APIs, kan yaml config ook a hebben publiceren of voorproef knoop.

    note caution
    CAUTION
    Voor demo-doeleinden wordt dezelfde ClientID gebruikt voor alle omgevingen. Het wordt aanbevolen afzonderlijke ClientID per omgeving (dev, stage, prod) te gebruiken voor betere beveiliging en controle.

  3. Leg de configuratiewijzigingen vast en duw de wijzigingen naar de externe Git-opslagplaats waar de Cloud Manager-pijplijn op is aangesloten.

  4. Implementeer de bovenstaande wijzigingen met behulp van de configuratiegids in de Cloud Manager. Het api.yaml -bestand kan ook worden geïnstalleerd in een RDE met behulp van opdrachtregelprogramma's.

    stel YAML op

Volgende stappen

Zodra de AEM-instantie is geconfigureerd om ADC-projectcommunicatie in te schakelen, kunt u beginnen met het gebruik van de op OpenAPI gebaseerde AEM API's. Leer hoe u de op OpenAPI gebaseerde AEM API's gebruikt met verschillende OAuth-verificatiemethoden:

API aanroepen met Server-naar-server verificatie

Oproep API gebruikend Server-aan-Server authentificatie

Leer hoe u op OpenAPI gebaseerde AEM API's aanroept vanuit een aangepaste NodeJS-toepassing met OAuth Server-to-Server-verificatie.

Leer meer

API aanroepen met webtoepassingsverificatie

Oproep API gebruikend de authentificatie van de App van het Web

Leer hoe u op OpenAPI gebaseerde AEM API's aanroept vanuit een aangepaste webtoepassing met OAuth Web App-verificatie.

Leer meer

API aanroepen met App-verificatie met één pagina

Oproep API gebruikend de Enige authentificatie van de Toepassing van de Pagina

Leer hoe u op OpenAPI gebaseerde AEM API's aanroept vanuit een aangepaste Single Page App (SPA) met OAuth 2.0 PKCE-stroom.

Leer meer

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69