OAuth Server-till-server-autentisering

OAuth Server-till-Server-autentisering ger säker, tokenbaserad åtkomst till AEM Forms Communications API:er utan att användaren behöver göra något. OAuth server-till-server-autentisering stöds av Adobe Developer Console.

Förutsättningar

Kontrollera att följande krav är uppfyllda innan du börjar:

Hur skapar man en åtkomsttoken med hjälp av OAuth Server-till-Server-autentisering?

Följ stegen nedan för att generera en åtkomsttoken från Adobe Developer-konsolen och gör ditt första API-anrop via OAuth Server-to-Server-autentisering.

1. Adobe Developer Console Project Setup

  1. Navigera till Adobe Developer Console

  2. Logga in med din Adobe ID

  3. Skapa nytt projekt eller navigera till ditt befintliga projekt

Så här skapar du ett nytt projekt
  1. Klicka på Skapa nytt projekt i avsnittet Snabbstart

  2. Ett nytt projekt skapas med ett standardnamn

    Skapa ADC-projekt

  3. Klicka på Redigera projekt längst upp till höger

    Redigera projekt

  4. Ange ett beskrivande namn (t.ex. "formsproject")

  5. Klicka på Spara

    Redigera projektnamn

Navigera till ditt befintliga projekt
  1. Klicka på Alla projekt i Adobe Developer Console

    Sökprojekt

  2. Leta upp projektet och klicka för att öppna det.

    Hitta projekt

​2. Lägg till Forms API:er

Lägg till Forms-API:er baserat på vad du vill göra:

  • AEM Forms Communications API:er: använd när du behöver generera, konvertera, sätta ihop eller skydda dokument (PDF och relaterade format).
  • Adaptiva Forms Runtime API:er - använd när du behöver återge, skicka eller bearbeta adaptiv Forms vid körning.
För AEM Forms Communications API:er
  1. Klicka på Lägg till API

    Lägg till API

  2. Välj Forms Communication API:er

    1. I dialogrutan Lägg till API kan du filtrera efter Experience Cloud

    2. Välj "Forms Communication APIs"

      Lägg till Forms Communication API

    3. Klicka på Nästa

    4. Välj autentiseringsmetoden OAuth Server-till-server

      Välj autentiseringsmetod

För adaptiva Forms Runtime API:er
  1. Klicka på Lägg till API

    Lägg till API

  2. Välj AEM Forms-leverans- och körnings-API

    1. I dialogrutan Lägg till API kan du filtrera efter Experience Cloud

    2. Välj "AEM Forms Delivery and Runtime API"
      Lägg till Forms Communication API

    3. Klicka på Nästa

    4. Välj autentiseringsmetoden OAuth Server-to-Server.
      Välj autentiseringsmetod

Du kan också lägga till API:t och autentiseringsmetoden i ditt befintliga projekt genom att klicka på Lägg till i projekt > API
Lägg till API i befintligt projekt

​3. Lägg till produktprofil

Produktprofilen ger behörighet (eller behörighet) för inloggningsuppgifter för åtkomst till AEM-resurser.

  1. Välj den produktprofil som matchar din AEM-instans-URL (https://Service Type -Environment Type-Program XXX-Environment XXX.adobeaemcloud.com).

    • Tjänsttyp - anger tjänster eller behörigheter som är associerade med AEM-instansen

    • Miljötyp - anger om miljön är för författare eller publiceringstjänst

    • Program XXX - identifierar Cloud Manager program-ID

    • Environment XXX - identifierar det specifika miljö-ID:t i det programmet

    note note
    NOTE
    Produktprofiler är knutna till en viss AEM-instans (program + miljö). Välj alltid den profil som matchar din instans-URL.
  2. Klicka på Spara konfigurerat API. API och produktprofil läggs till i ditt projekt

    Välj projektkonfiguration

​4. Generera och spara autentiseringsuppgifter

  1. Navigera till ditt projekt i Adobe Developer Console

  2. Klicka på autentiseringsuppgifter för OAuth Server-till-Server

  3. Visa avsnittet Information om autentiseringsuppgifter

    Visa autentiseringsuppgifter

Post-API-autentiseringsuppgifter

    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. Generera åtkomsttoken

Generera åtkomsttoken antingen manuellt eller programmatiskt:

För testning

Generera åtkomsttoken manuellt i Adobe Developer Console:

  1. Navigera till ditt projekt

    1. Öppna ditt projekt i Adobe Developer Console
    2. Klicka på OAuth Server-to-Server
  2. Generera åtkomsttoken

    1. Klicka på knappen "Generera åtkomsttoken" i projektets API-avsnitt
    2. Kopiera genererad åtkomsttoken

    Generera åtkomsttoken

    note note
    NOTE
    Åtkomsttoken är endast giltig i 24 timmar
För produktion

Generera tokens programmatiskt med Adobe IMS API:

Nödvändiga autentiseringsuppgifter:

  • Klient-ID
  • Klienthemlighet
  • Omfång (vanligtvis: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Tokenslutpunkt:

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

Exempelbegäran (url):

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'

Svar:

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

Du kan nu använda den genererade åtkomsttoken för att göra API-anrop för utvecklings-, scen- eller produktionsmiljöer.

God praxis: Hantera autentiseringsuppgifter för utveckling, mellanlagring och produktion

  • Använd alltid separata autentiseringsuppgifter för utveckling, mellanlagring och produktion.

  • Mappa alla autentiseringsuppgifter till rätt URL för AEM-miljön.

  • Lagra hemligheter på ett säkert sätt och implementera dem aldrig i källkontrollen.

  • Giltigheten för spåråtkomsttoken, eftersom tokens endast är giltiga i 24 timmar.

Nästa steg

Mer information om hur du konfigurerar miljö för synkrona Forms Communication API:er finns i Synkron bearbetning i AEM Forms as a Cloud Service Communications.

Relaterade artiklar

Lär dig hur du ställer in miljön för API:er för synkron (On-Demand) och asynkron (Batch) Forms Communications:

Synkrona API:er

API:er för AEM Forms Communications - Synkron

Lär dig hur du konfigurerar miljö för Synkrona (on-demand) API:er för Forms Communications som genererar eller bearbetar dokument direkt.

Läs mer

Asynkrona API:er

AEM Forms Communications API:er - asynkron (batch)

Lär dig hur du konfigurerar miljö för asynkrona (Batch) Forms Communications API:er som genererar eller bearbetar flera dokument på ett schemalagt sätt.

Läs mer

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