Werken met referenties working-with-credentials
Informatie over de Credential Service
Een referentie bevat uw persoonlijke sleutelgegevens die nodig zijn voor het ondertekenen of identificeren van documenten. Een certificaat is openbare zeer belangrijke informatie die u voor vertrouwen vormt. AEM Forms gebruikt certificaten en referenties voor verschillende doeleinden:
- Acrobat Reader DC-extensies gebruiken een referentie om Adobe Reader-gebruiksrechten in PDF-documenten in te schakelen. (Zie Gebruiksrechten toepassen op PDF-documenten.)
- De handtekeningservice krijgt toegang tot certificaten en gegevens tijdens het uitvoeren van bewerkingen, zoals het digitaal ondertekenen van PDF-documenten. (Zie PDF-documenten digitaal ondertekenen.)
U kunt programmatically met de dienst van de Referentie in wisselwerking staan gebruikend Java API van de Manager van het Vertrouwen. U kunt de volgende taken uitvoeren:
Referenties importeren met de Betrouwbaarheidsbeheer-API importing-credentials-by-using-the-trust-manager-api
Met de Betrouwbaarheidsbeheer-API kunt u via programmacode een referentie naar AEM Forms importeren. U kunt bijvoorbeeld een referentie importeren die wordt gebruikt om een PDF-document te ondertekenen. (Zie PDF-documenten digitaal ondertekenen).
Wanneer u een referentie importeert, geeft u een alias voor de referentie op. De alias wordt gebruikt om een Forms-bewerking uit te voeren waarvoor een referentie vereist is. Zodra ingevoerd, kan een referentie in beleidsconsole worden bekeken, zoals aangetoond in de volgende illustratie. Merk op dat de alias voor de referentie Beveiligen.
Overzicht van de stappen summary-of-steps
Voer de volgende stappen uit om een referentie te importeren in AEM Forms:
- Inclusief projectbestanden.
- Creeer een cliënt van de credentiedienst.
- Verwijs naar de referentie.
- Voer de importbewerking uit.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.
De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-truststore-client.jar
- adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
- jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.
Een crediteurenserviceclient maken
Voordat u via programmacode een referentie naar AEM Forms kunt importeren, maakt u een client voor de referentieservice. Zie voor meer informatie Verbindingseigenschappen instellen.
Referentie van de referentie
Verwijs naar een referentie die u in AEM Forms wilt importeren. De snelle start die aan deze sectie is gekoppeld, verwijst naar een P12-bestand in het bestandssysteem.
De importbewerking uitvoeren
Importeer de referentie naar AEM Forms nadat u naar de referentie hebt verwezen. Als de referentie niet correct is geïmporteerd, wordt een uitzondering gegenereerd. Wanneer u een referentie importeert, geeft u een alias voor de referentie op.
Zie ook
Referenties importeren met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Referentieservice-API: snel aan de slag
Referenties verwijderen met de Betrouwbaarheidsbeheer-API
Referenties importeren met de Java API import-credentials-using-the-java-api
Een referentie importeren in AEM Forms met de Betrouwbaarheidsbeheer-API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-truststore-client.jar, op in het klassenpad van uw Java-project.
-
Een crediteurenserviceclient maken
- Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
CredentialServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
Referentie van de referentie
- Een
java.io.FileInputStream
object met behulp van de constructor. Geef een tekenreekswaarde door die de locatie van de referentie opgeeft. - Een
com.adobe.idp.Document
object dat de referentie opslaat met hetcom.adobe.idp.Document
constructor. Geef dejava.io.FileInputStream
object dat de referentie voor de constructor bevat.
- Een
-
De importbewerking uitvoeren
-
Maak een array met tekenreeksen die één element bevat. De waarde toewijzen
truststore.usage.type.sign
naar het element. -
De
CredentialServiceClient
objectimportCredential
en geeft de volgende waarden door:- Een tekenreekswaarde die de aliaswaarde voor de referentie opgeeft.
- De
com.adobe.idp.Document
instantie die de referentie opslaat. - Een tekenreekswaarde die het wachtwoord opgeeft dat aan de referentie is gekoppeld.
- De tekenreeks-array die de gebruikswaarde bevat. U kunt bijvoorbeeld deze waarde opgeven
truststore.usage.type.sign
. Als u een Reader Extension-referentie wilt importeren, geeft utruststore.usage.type.lcre
.
-
Zie ook
Referenties importeren met de Betrouwbaarheidsbeheer-API
Snel starten (SOAP-modus): Referenties importeren met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Referenties verwijderen met de Betrouwbaarheidsbeheer-API deleting-credentials-by-using-the-trust-manager-api
U kunt een referentie programmatically schrappen door de Manager API van het Vertrouwen te gebruiken. Wanneer u een referentie verwijdert, geeft u een alias op die overeenkomt met de referentie. Als deze eenmaal is verwijderd, kan geen referentie worden gebruikt om een bewerking uit te voeren.
Overzicht van de stappen summary_of_steps-1
Voer de volgende stappen uit om een referentie te verwijderen:
- Inclusief projectbestanden.
- Creeer een cliënt van de credentiedienst.
- Voer de verwijderbewerking uit.
Projectbestanden opnemen
Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:
- adobe-livecycle-client.jar
- adobe-usermanager-client.jar
- adobe-truststore-client.jar
- adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
- jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)
Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.
Een crediteurenserviceclient maken
Alvorens u een referentie programmatically kunt schrappen, creeer een de dienstcliënt van de Integratie van Gegevens. Wanneer u een serviceclient maakt, definieert u verbindingsinstellingen die vereist zijn om een service aan te roepen. Zie voor meer informatie Verbindingseigenschappen instellen.
De verwijderbewerking uitvoeren
Als u een referentie wilt verwijderen, geeft u de alias op die overeenkomt met de referentie. Als u een alias opgeeft die niet bestaat, wordt een uitzondering gegenereerd.
Zie ook
Referenties importeren met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen
Referenties importeren met de Java API
Referenties verwijderen met de Java API deleting-credentials-using-the-java-api
Een referentie uit AEM Forms verwijderen met de Betrouwbaarheidsbeheer-API (Java):
-
Projectbestanden opnemen
Neem client-JAR-bestanden, zoals adobe-truststore-client.jar, op in het klassenpad van uw Java-project.
-
Een crediteurenserviceclient maken
- Een
ServiceClientFactory
object dat verbindingseigenschappen bevat. - Een
CredentialServiceClient
object door de constructor ervan te gebruiken en door te gevenServiceClientFactory
object.
- Een
-
De verwijderbewerking uitvoeren
De
CredentialServiceClient
objectdeleteCredential
methode en geef een tekenreekswaarde door die de aliaswaarde opgeeft.
Zie ook
Referenties verwijderen met de Betrouwbaarheidsbeheer-API
Snel starten (SOAP-modus): Referenties verwijderen met de Java API
Inclusief AEM Forms Java-bibliotheekbestanden
Verbindingseigenschappen instellen