API-referenties en productprofielbeheer
- Onderwerpen:
- Ontwikkelen
Gemaakt voor:
- Beginner
- Ontwikkelaar
- Leider
Leer hoe te om Geloofsbrieven en het Profiel van het Product voor op OpenAPI-Gebaseerde AEM APIs te beheren.
In deze zelfstudie leert u hoe u inhoud kunt toevoegen of verwijderen:
- Geloofsbrieven: Verstrek authentificatie voor een AEM API.
- Profielen van het Product: Verstrek toestemmingen (of vergunning) voor geloofsbrieven om tot de middelen van AEM toegang te hebben.
Achtergrond
Wanneer u AEM API gebruikt, moet u de Geloofsbrieven en Profiel van het Product in het project van Adobe Developer Console (of ADC) bepalen. In het volgende screenshot, kunt u Geloofsbrieven en Profiel van het Product voor een Auteur API van AEM Assets zien:
De Geloofsbrieven verstrekken het authentificatiemechanisme voor API. Het Profiel van het Product verleent toestemmingen (of vergunning) aan de geloofsbrieven, die toegang verlenen de middelen van AEM. De API-aanvraag kan namens een toepassing of een gebruiker worden ingediend.
Een Profiel van het Product wordt geassocieerd met één of meerdere Diensten. In AEM as a Cloud Service, vertegenwoordigt de a Dienst gebruikersgroepen met vooraf bepaalde Lijsten van het Toegangsbeheer (ACLs) voor gegevensopslagplaatsen, die korrelig toestemmingsbeheer toestaan.
Na succesvolle API-aanroeping wordt een gebruiker die de referentie van het ADC-project vertegenwoordigt, in de AEM Auteur-service gemaakt, samen met de gebruikersgroepen die overeenkomen met de configuratie Productprofiel en Services.
In het bovenstaande scenario wordt de gebruiker 1323d2...
gemaakt in de AEM Author-service en is deze een lid van de gebruikersgroepen AEM Assets Collaborator Users - Service
en AEM Assets Collaborator Users - author - Program XXX - Environment XXX
.
Credentials toevoegen of verwijderen
De AEM API's bieden ondersteuning voor de volgende verificatietypen:
- OAuth Server-aan-Server: Ontworpen voor machine-aan-machine interactie.
- OAuth App van het Web: Ontworpen voor gebruiker-gedreven interactie met een backendserver in uw cliënttoepassing.
- OAuth Enige Pagina App: Ontworpen voor gebruiker-gedreven interactie zonder een backendserver in uw cliënttoepassing.
U kunt verschillende gebruikersgevallen ondersteunen met behulp van verschillende soorten referenties.
Alle geloofsbrieven worden beheerd in uw project ADC.
Om geloofsbrieven voor AEM API toe te voegen, ga naar de APIs sectie van uw project ADC en klik verbind een andere referentie. Volg vervolgens de instructies voor het specifieke type referentie.
Om een referentie van AEM API te verwijderen, selecteer het in de APIs sectie van uw project ADC, dan klik credential van de Schrapping.
Productprofielen toevoegen of verwijderen
Het Profiel van het Product verstrekt de toestemmingen (of vergunning) aan de geloofsbrieven om tot de middelen van AEM toegang te hebben. De toestemmingen die door het Profiel van het Product worden verstrekt zijn gebaseerd op de Diensten verbonden aan het Profiel van het Product. Het grootste deel van de Diensten verstrekt LEZEN toestemming aan de middelen van AEM, via de gebruikersgroepen in de instantie van AEM die de zelfde naam zoals de Dienst hebben.
Er zijn tijden wanneer de geloofsbrieven (ook bekend als technische rekeningsgebruiker) extra toestemmingen zoals creeer, Update, schrap (CUD) van de middelen van AEM nodig hebben. In dergelijke gevallen, moet u een nieuw Profiel van het Product toevoegen dat met de Diensten wordt geassocieerd die de vereiste toestemmingen verstrekken.
Bijvoorbeeld, wanneer de aanroeping van de Auteur van AEM Assets API 403 fout voor niet-GET verzoekenontvangt, kunt u Beheerders van AEM toevoegen - auteur - Programma XXX - Milieu XXX Profiel van het Product om de kwestie op te lossen.
Om de Profielen van het Product voor een AEM API toe te voegen, klik productprofielen in de APIs sectie van het project ADC, selecteer het gewenste Profiel van het Product in vorm API dialoog, en sparen uw veranderingen.

Selecteer het gewenste Profiel van het Product (b.v., de Beheerders van AEM - auteur - Programma XXX - Milieu XXX) verbonden aan de vereiste diensten, dan sparen uw veranderingen.

Merk op dat de Beheerders van AEM - auteur - Programma XXX - het Profiel van het Product van het Milieu XXX met zowel de dienst van de Beheerders van AEM als de gebruikers van AEM Assets API dienst wordt geassocieerd. Zonder deze laatste optie wordt het productprofiel niet weergegeven in de lijst met beschikbare productprofielen.

Het PATCH verzoek om de activa meta-gegevens bij te werken zou nu zonder kwesties moeten werken.


Samenvatting
U leerde hoe te om het authentificatiemechanisme en de toestemmingen voor AEM APIs te veranderen gebruikend Referenties en het Profiel van het Product in het project van Adobe Developer Console (ADC).