Werken met referenties working-with-credentials

Voorbeelden en voorbeelden in dit document gelden alleen voor AEM Forms in JEE-omgeving.

Informatie over de Credential Service

Een referentie bevat de gegevens van uw persoonlijke sleutel 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:

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:

NOTE
U kunt certificaten ook importeren en verwijderen met behulp van de beheerconsole. (Zie Help bij de administratie.)

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. De alias voor de referentie is Beveiligen.

ww_ww_truststore

NOTE
U kunt met webservices geen referentie naar AEM Forms importeren.

Overzicht van de stappen summary-of-steps

Voer de volgende stappen uit om een referentie te importeren in AEM Forms:

  1. Inclusief projectbestanden.
  2. Creeer een cliënt van de credentiedienst.
  3. Verwijs naar de referentie.
  4. 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):

  1. Projectbestanden opnemen

    Neem client-JAR-bestanden, zoals adobe-truststore-client.jar, op in het klassenpad van uw Java-project.

  2. Een crediteurenserviceclient maken

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een CredentialServiceClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. 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 de com.adobe.idp.Document constructor. Geef de java.io.FileInputStream object dat de referentie voor de constructor bevat.
  4. De importbewerking uitvoeren

    • Maak een array met tekenreeksen die één element bevat. De waarde toewijzen truststore.usage.type.sign naar het element.

    • De CredentialServiceClient object importCredential en geeft de volgende waarden door:

      • Een tekenreekswaarde die de alias 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 u truststore.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 een referentie niet worden gebruikt om een bewerking uit te voeren.

NOTE
U kunt met webservices geen referentie naar AEM Forms verwijderen.

Overzicht van de stappen summary_of_steps-1

Voer de volgende stappen uit om een referentie te verwijderen:

  1. Inclusief projectbestanden.
  2. Creeer een cliënt van de credentiedienst.
  3. 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):

  1. Projectbestanden opnemen

    Neem client-JAR-bestanden, zoals adobe-truststore-client.jar, op in het klassenpad van uw Java-project.

  2. Een crediteurenserviceclient maken

    • Een ServiceClientFactory object dat verbindingseigenschappen bevat.
    • Een CredentialServiceClient object door de constructor ervan te gebruiken en de ServiceClientFactory object.
  3. De verwijderbewerking uitvoeren

    De CredentialServiceClient object deleteCredential 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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2