OAuth Server-to-Server Authentificatie

Met verificatie van server naar server kunt u veilige, tokengebaseerde toegang tot AEM Forms Communications API's toestaan zonder gebruikersinteractie te vereisen. OAuth server-aan-server authentificatie wordt gesteund door Adobe Developer Console.

Vereisten

Voordat u begint, moet u controleren of aan de volgende voorwaarden is voldaan:

Hoe te om een Token van de Toegang te produceren die de Server-aan-server Authentificatie van OAuth gebruikt?

Volg de onderstaande stappen om een toegangstoken van de console van Adobe Developer te produceren, en uw eerste API vraag door de Server-aan-Server Authentificatie van OAuth te maken.

1. Adobe Developer Console Project Setup

  1. Ga aan ​ Adobe Developer Console ​

  2. Meld u aan bij uw Adobe ID

  3. Nieuw project maken of naar een bestaand project navigeren

om een nieuw project te creëren
  1. Van de Snelle sectie van het Begin, klik creeer nieuw project

  2. Een nieuw project wordt gecreeerd met een standaardnaam

    creeer ADC Project

  3. Klik uitgeven project in de hoogste juiste hoek

    geef Project uit

  4. Geef een betekenisvolle naam op (bijvoorbeeld "formsproject")

  5. Klik sparen

    geef de Naam van het Project uit

om aan uw bestaand project te navigeren
  1. Klik Alle Projecten van Adobe Developer Console

    Projecten van het Onderzoek

  2. Zoek uw project en klik om het te openen.

    plaats Projecten

​2. Forms API's toevoegen

Voeg Forms API's toe op basis van wat u wilt doen:

  • Communicatie APIs van AEM Forms: gebruik wanneer u, documenten (PDF en verwante formaten) moet produceren omzetten, assembleren of beveiligen.
  • Adaptieve Runtime van Forms APIs - gebruik wanneer u, Adaptieve Forms bij runtime moet teruggeven voorleggen of verwerken.
voor Communicatie APIs van AEM Forms
  1. Klik toevoegen API

    voeg api toe

  2. Selecteer Communicatie APIs van Forms

    1. In voeg API dialoog toe, filter door Experience Cloud

    2. Selecteer "Communicatie APIs van Forms"

      voeg Communicatie API van Forms toe

    3. Klik daarna

    4. Selecteer Server-aan-Server authentificatiemethode

      Uitgezochte methode van de Authentificatie

voor AanpassingsForms Runtime APIs
  1. klik toevoegen API

    voeg api toe

  2. Uitgezochte AEM Forms Levering en Runtime API

    1. In voeg API dialoog toe, filter door Experience Cloud

    2. Selecteer "AEM Forms Delivery and Runtime API"
      voeg Communicatie API van Forms toe

    3. Klik daarna

    4. Selecteer Server-aan-Server authentificatiemethode.
      Uitgezochte methode van de Authentificatie

U kunt API en authentificatiemethode aan uw bestaand project ook toevoegen door te klikken toevoegt aan Project > API
voeg API aan bestaand Project toe

​3. Productprofiel toevoegen

Het productprofiel bevat machtigingen (of autorisaties) voor referenties om toegang te krijgen tot de AEM-bronnen.

  1. Selecteer het Profiel van het Product dat uw instantie URL van AEM (https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com) aanpast.

    • Type van Dienst - specificeert de diensten of toestemmingen verbonden aan de instantie van AEM

    • Type van Milieu - specificeert of het milieu voor de dienst van de Auteur of van de Publicatie is

    • Programma XXX - identificeert Cloud Manager programma identiteitskaart

    • Milieu XXX - identificeert specifieke milieuidentiteitskaart binnen dat programma

    note note
    NOTE
    Productprofielen zijn gekoppeld aan een specifieke AEM-instantie (programma + omgeving). Kies altijd het profiel dat overeenkomt met de instantie-URL.
  2. Klik sparen gevormde API. De API en het Profiel van het Product worden toegevoegd aan uw project

    Uitgezochte Configuratie van het Project

​4. Referenties genereren en opslaan

  1. Ga naar uw project in Adobe Developer Console

  2. Klik Server-aan-Server referentie

  3. Bekijk de Credentials details sectie

    Credentials van de Mening

Opname API geloofsbrieven

    API Credentials:
    ================
    Client ID: <your_client_id>
    Client Secret: <your_client_secret>
    Technical Account ID: <tech_account_id>
    Organization ID: <org_id>
    Scopes: AdobeID,openid,read_organizations

​5. Tokengeneratie benaderen

Genereer het toegangstoken handmatig of programmatisch:

voor het Testen

Handmatig toegangstokens genereren in Adobe Developer Console:

  1. ga aan uw Project

    1. Open uw project in Adobe Developer Console
    2. Klik Server-aan-Server
  2. produceer het Token van de Toegang

    1. Klik "produceer toegangstoken" knoop in de API van uw project sectie
    2. Het gegenereerde toegangstoken kopiëren

    produceer het Token van de Toegang

    note note
    NOTE
    Het teken van de toegang is geldig slechts voor 24 uren
voor Productie

Genereer programmatically tokens gebruikend ​ IMS van Adobe ​ API:

Vereiste Referenties:

  • Client-id
  • Clientgeheim
  • Bereiken (doorgaans: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Symbolische Eindpunt:

code language-none
https://ims-na1.adobelogin.com/ims/token/v3

Verzoek van de Steekproef (krulling):

code language-bash
curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials' \
-d 'client_id=<YOUR_CLIENT_ID>' \
-d 'client_secret=<YOUR_CLIENT_SECRET>' \
-d 'scope=AdobeID,openid,read_organizations'

Reactie:

code language-json
    {
    "access_token": "eyJhbGciOiJSUz...",
    "token_type": "bearer",
    "expires_in": 86399
    }

U kunt het gegenereerde toegangstoken nu gebruiken om API-aanroepen te maken voor ontwikkelings-, stage- of productieomgevingen.

Tips en trucs: Beheer uw aanmeldingsgegevens voor Ontwikkeling, Staging en Productie

  • Gebruik altijd afzonderlijke referenties voor Ontwikkeling, Staging en Productie.

  • Wijs elke referentie toe aan de juiste URL voor de AEM-omgeving.

  • Sla geheimen veilig op en verbind ze nooit tot broncontrole.

  • Geldigheid van toegangstoken bijhouden, aangezien tokens slechts 24 uur geldig zijn.

Volgende stappen

Leren hoe te opstellingsmilieu voor Synchrone Communicatie APIs van Forms, zie ​ Communicatie van AEM Forms as a Cloud Service Synchrone Verwerking ​.

Verwante artikelen

Leer hoe u een omgeving instelt voor synchrone (On-Demand) en asynchrone (Batch) Forms Communications API's:

Synchrone API's

Communicatie APIs van AEM Forms - Synchroon

Leer hoe u een omgeving instelt voor synchrone (on-demand) communicatie-API's die direct documenten genereren of verwerken.

Leer meer

Asynchrone API's

Communicatie APIs van AEM Forms - Asynchroon (Partij)

Leer hoe u een omgeving instelt voor Asynchronous (Batch) Forms Communications API's die meerdere documenten op een geplande manier genereren of verwerken.

Leer meer

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab