Digitalt signera och certifiera dokument digitally-signing-and-certifying-documents

API-snabbstart för signaturtjänst

Lägga till signaturfält med Java API add-signature-fields-using-the-java-api

Lägg till ett signaturfält med signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta ett PDF-dokument som ett signaturfält läggs till i
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som ett signaturfält läggs till i med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

Lägg till ett signaturfält

Skapa ett PositionRectangle-objekt som anger signaturfältets plats med hjälp av dess konstruktor. Ange koordinatvärden i konstruktorn.
Om du vill kan du skapa ett FieldMDPOptions-objekt som anger de fält som är låsta när en digital signatur används i signaturfältet.
Lägg till ett signaturfält i ett PDF-dokument genom att anropa SignatureServiceClient-objektets addSignatureField-metod och skicka följande värden:
- A com.adobe.idp. Document-objekt som representerar det PDF-dokument som ett signaturfält läggs till i.
- Ett strängvärde som anger signaturfältets namn.
- Ett java.lang.Integer-värde som representerar sidnumret som ett signaturfält läggs till på.
- Ett PositionRectangle-objekt som anger signaturfältets plats.
- Ett FieldMDPOptions-objekt som anger fält i PDF-dokumentet som är låsta efter att en digital signatur har tillämpats på signaturfältet. Det här parametervärdet är valfritt och du kan skicka null.
Ett PDFSeedValueOptions-objekt som anger olika körningsvärden. Det här parametervärdet är valfritt och du kan skicka null.

Metoden addSignatureField returnerar com.adobe.idp. Document-objekt som representerar ett PDF-dokument som innehåller ett signaturfält.

note note
NOTE
Du kan anropa `SignatureServiceClient`-objektets `addInvisibleSignatureField`-metod för att lägga till ett osynligt signaturfält.

Spara PDF-dokumentet som en PDF-fil
- Skapa ett java.io.File-objekt och kontrollera att filtillägget är .pdf.
- Anropa com.adobe.idp. Document-objektets copyToFile-metod för att kopiera innehållet i Document-objektet till filen. Kontrollera att du använder com.adobe.idp. Document objekt som returnerades av metoden addSignatureField.

Se även

Lägga till signaturfält med webbtjänstens API add-signature-fields-using-the-web-service-api

Så här lägger du till ett signaturfält med signatur-API:t (webbtjänsten):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta ett PDF-dokument som ett signaturfält läggs till i
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra det PDF-dokument som ska innehålla ett signaturfält.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll objektet BLOB genom att tilldela dess MTOM-egenskap med innehållet i bytearrayen.
Lägg till ett signaturfält

Lägg till ett signaturfält i PDF-dokumentet genom att anropa SignatureServiceClient-objektets addSignatureField-metod och skicka följande värden:
- Ett BLOB-objekt som representerar det PDF-dokument som ett signaturfält läggs till i.
- Ett strängvärde som anger signaturfältets namn.
- Ett heltalsvärde som representerar sidnumret som ett signaturfält läggs till på.
- Ett PositionRect-objekt som anger signaturfältets plats.
- Ett FieldMDPOptions-objekt som anger fält i PDF-dokumentet som är låsta efter att en digital signatur har tillämpats på signaturfältet. Det här parametervärdet är valfritt och du kan skicka null.
- Ett PDFSeedValueOptions-objekt som anger olika körningsvärden. Det här parametervärdet är valfritt och du kan skicka null.
Metoden addSignatureField returnerar ett BLOB-objekt som representerar ett PDF-dokument som innehåller ett signaturfält.
Spara PDF-dokumentet som en PDF-fil
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska innehålla signaturfältet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden addSignatureField. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets binaryData-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Hämta namn på signaturfält med Java API

Hämtar namn på signaturfält retrieving-signature-field-names

Du kan hämta namnen på alla signaturfält i ett PDF-dokument som du vill signera eller certifiera. Om du är osäker på vilka signaturfältsnamn som finns i ett PDF-dokument eller vill verifiera namnen, kan du hämta dem programmatiskt. Signaturtjänsten returnerar signaturfältets kvalificerade namn, till exempel form1[0].grantApplication[0].page1[0].SignatureField1[0].

NOTE

Mer information om signaturtjänsten finns i Tjänstreferens för AEM Forms

Sammanfattning av steg summary_of_steps-1

Gör så här för att hämta signaturfältsnamn:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta det PDF-dokument som innehåller signaturfält.
Hämta signaturfältens namn.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en signaturklient

Innan du programmässigt kan utföra en signeringstjänståtgärd måste du skapa en signaturtjänstklient.

Hämta PDF-dokumentet som innehåller signaturfält

Hämta ett PDF-dokument som innehåller signaturfält.

Hämta signaturfältsnamnen

Du kan hämta namn på signaturfält när du har hämtat ett PDF-dokument som innehåller ett eller flera signaturfält.

Se även

Hämta signaturfält med webbtjänstens API

Hämtar namn på signaturfält

Hämta namn på signaturfält med Java API retrieve-signature-field-names-using-the-java-api

Hämta namn på signaturfält med signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta PDF-dokumentet som innehåller signaturfält
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som innehåller signaturfält genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Hämta namn på signaturfält
- Hämta signaturfältsnamnen genom att anropa SignatureServiceClient-objektets getSignatureFieldList-metod och skicka com.adobe.idp.Document-objektet som innehåller PDF-dokumentet som innehåller signaturfält. Den här metoden returnerar ett java.util.List-objekt där varje element innehåller ett PDFSignatureField-objekt. Med det här objektet kan du få ytterligare information om ett signaturfält, till exempel om det är synligt.
- Iterera genom objektet java.util.List för att avgöra om det finns signaturfältsnamn. För varje signaturfält i PDF-dokumentet kan du hämta ett separat PDFSignatureField-objekt. Anropa PDFSignatureField-objektets getName-metod för att hämta signaturfältets namn. Den här metoden returnerar ett strängvärde som anger signaturfältets namn.

Se även

Snabbstart (SOAP läge): Hämta signaturfältnamn med Java API

Hämtar namn på signaturfält

Hämta signaturfält med webbtjänstens API retrieve-signature-field-using-the-web-service-api

Hämta namn på signaturfält med signatur-API:t (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta PDF-dokumentet som innehåller signaturfält
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra PDF-dokumentet som innehåller signaturfält.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-fält innehållet i bytearrayen.
Hämta namn på signaturfält
- Hämta signaturfältsnamnen genom att anropa SignatureServiceClient-objektets getSignatureFieldList-metod och skicka BLOB-objektet som innehåller PDF-dokumentet som innehåller signaturfält. Den här metoden returnerar ett MyArrayOfPDFSignatureField-samlingsobjekt där varje element innehåller ett PDFSignatureField-objekt.
- Iterera genom objektet MyArrayOfPDFSignatureField för att avgöra om det finns signaturfältsnamn. För varje signaturfält i PDF-dokumentet kan du hämta ett PDFSignatureField-objekt. Anropa PDFSignatureField-objektets getName-metod för att hämta signaturfältets namn. Den här metoden returnerar ett strängvärde som anger signaturfältets namn.

Se även

Ändra signaturfält modifying-signature-fields

Du kan ändra signaturfält som finns i ett PDF-dokument med hjälp av Java API och webbtjänstens API. När du ändrar ett signaturfält måste du ändra signaturfältets låsordlistevärden eller ordlistevärden för startvärde.

En fältlåsordlista anger en lista med fält som är låsta när signaturfältet signeras. Ett låst fält hindrar användaren från att göra ändringar i fältet. En startvärdesordlista innehåller begränsad information som används när signaturen tillämpas. Du kan till exempel ändra behörigheter som styr vilka åtgärder som kan utföras utan att en signatur blir ogiltig.

Genom att ändra ett befintligt signaturfält kan du ändra PDF-dokumentet så att det återspeglar förändrade affärskrav. Ett nytt affärskrav kan till exempel kräva att alla dokumentfält låses efter att dokumentet har signerats.

I det här avsnittet beskrivs hur du ändrar ett signaturfält genom att ändra både fältets låsordlista och ordlistevärden för startvärde. Ändringar som görs i signaturfältet låser ordlistan så att alla fält i PDF-dokumentet låses när ett signaturfält signeras. Ändringar i ordlistan för dirigerade värden förbjuder vissa typer av ändringar i dokumentet.

NOTE

Mer information om signaturtjänsten och om hur du ändrar signaturfält finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-2

Gör så här om du vill ändra signaturfält i ett PDF-dokument:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta det PDF-dokument som innehåller det signaturfält som ska ändras.
Ange lexikonvärden.
Ändra signaturfältet.
Spara PDF-dokumentet som en PDF-fil.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera Java-biblioteksfiler för LiveCycle.

Skapa en signaturklient

Innan du programmässigt kan utföra en signeringstjänståtgärd måste du skapa en signaturtjänstklient.

Hämta det PDF-dokument som innehåller signaturfältet som ska ändras

Hämta ett PDF-dokument som innehåller det signaturfält som ska ändras.

Ange ordlistevärden

Om du vill ändra ett signaturfält tilldelar du värden till dess låsordlista för fält eller ordlista för startvärde. När du anger värden för signaturfält låses ordlistevärden, vilket innebär att du anger dokumentfält i PDF som är låsta när signaturfältet signeras. (I det här avsnittet beskrivs hur du låser alla fält.)

Följande ordlistevärden för dirigerade värden kan anges:

Revisionskontroll: Anger om spärrkontroll utförs när en signatur tillämpas på signaturfältet.
Certifikatalternativ: Tilldelar värden till certifikatets startvärdesordlista. Innan du anger certifikatalternativ bör du bekanta dig med en ordlista för certifikatstartvärden. (Se Referenshandbok för PDF.)
Sammanfattningsalternativ: Tilldelar sammanfattningsalgoritmer som används för signering. Giltiga värden är SHA1, SHA256, SHA384, SHA512 och RIPEMD160.
Filter: Anger det filter som används med signaturfältet. Du kan till exempel använda filtret Adobe.PPKLite. (Se Referenshandbok för PDF.)
Flaggalternativ: Anger flaggvärden som är associerade med det här signaturfältet. Värdet 1 innebär att en signerare endast får använda de angivna värdena för posten. Värdet 0 innebär att andra värden är tillåtna. Här är bitpositionerna:
- 1(Filter): Den underskriftshanterare som ska användas för att signera signaturfältet
- 2 (SubFilter): En array med namn som anger godkända kodningar att använda vid signering
- 3 (V): Det lägsta versionsnummer för underskriftshanteraren som krävs för att signaturfältet ska kunna signeras
- 4 (Orsaker): En matris med strängar som anger möjliga orsaker till signering av ett dokument
- 5 (PDFLegalWarnings): En matris med strängar som anger möjliga juridiska attesteringar
Juridiska attesteringar: När ett dokument har certifierats skannas det automatiskt efter specifika typer av innehåll som kan göra det synliga innehållet i ett dokument tvetydigt eller vilseledande. En anteckning kan till exempel skymma text som är viktig för att förstå vad som certifieras. Skanningsprocessen genererar varningar som anger att den här typen av innehåll finns. Det innehåller även en ytterligare förklaring av innehållet som kan ha genererat varningar.
Behörigheter: Anger behörigheter som kan användas för ett PDF-dokument utan att signaturen blir ogiltig.
Orsaker: Anger varför det här dokumentet måste signeras.
Tidsstämpel: Anger tidsstämpelalternativ. Du kan till exempel ange URL:en för den tidsstämpelserver som används.
Version: Anger det lägsta versionsnumret för underskriftshanteraren som ska användas för att signera signaturfältet.

Ändra signaturfältet

När du har skapat en signaturtjänstklient, hämtat det PDF-dokument som innehåller det signaturfält som ska ändras och angett värden för ordlista, kan du instruera signaturtjänsten att ändra signaturfältet. Signaturtjänsten returnerar sedan ett PDF-dokument som innehåller det ändrade signaturfältet. Det ursprungliga PDF-dokumentet påverkas inte.

Spara PDF-dokumentet som en PDF-fil

Spara det PDF-dokument som innehåller det ändrade signaturfältet som en PDF-fil så att användare kan öppna det i Acrobat eller Adobe Reader.

Se även

API-snabbstart för signaturtjänst

Ändra signaturfält med Java API modify-signature-fields-using-the-java-api

Ändra ett signaturfält med hjälp av signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta det PDF-dokument som innehåller signaturfältet som ska ändras
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som innehåller signaturfältet som ska ändras med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.

Ange lexikonvärden

Skapa ett PDFSignatureFieldProperties-objekt med hjälp av dess konstruktor. Ett PDFSignatureFieldProperties-objekt lagrar information om låsordlista för signaturfält och startvärdesordlista.
Skapa ett PDFSeedValueOptionSpec-objekt med hjälp av dess konstruktor. Med det här objektet kan du ange ordlistevärden för startvärde.
Tillåt inte ändringar i PDF-dokumentet genom att anropa PDFSeedValueOptionSpec-objektets setMdpValue-metod och skicka MDPPermissions.NoChanges-uppräkningsvärdet.
Skapa ett FieldMDPOptionSpec-objekt med hjälp av dess konstruktor. Med det här objektet kan du ange värden för låsning av signaturfält.
Lås alla fält i PDF-dokumentet genom att anropa FieldMDPOptionSpec-objektets setMdpValue-metod och skicka FieldMDPAction.ALL-uppräkningsvärdet.
Ange information om startvärdesordlista genom att anropa PDFSignatureFieldProperties-objektets setSeedValue-metod och skicka PDFSeedValueOptionSpec-objektet.
Ange information om signaturfält för att låsa ordlistan genom att anropa PDFSignatureFieldPropertiesobjektets setFieldMDP-metod och skicka FieldMDPOptionSpec-objektet.

note note
NOTE
Se klassreferensen `PDFSeedValueOptionSpec` om du vill se alla ordlistevärden för startvärde som du kan ange. (Se AEM Forms API Reference.)

Ändra signaturfältet

Ändra signaturfältet genom att anropa SignatureServiceClient-objektets modifySignatureField-metod och skicka följande värden:
- Det com.adobe.idp.Document-objekt som lagrar dokumentet som innehåller signaturfältet som ska ändras
- Ett strängvärde som anger signaturfältets namn
- Objektet PDFSignatureFieldProperties som lagrar information om låsning av signaturfält och ordlista för startvärde
Metoden modifySignatureField returnerar ett com.adobe.idp.Document-objekt som lagrar ett PDF-dokument som innehåller det ändrade signaturfältet.
Spara PDF-dokumentet som en PDF-fil
- Skapa ett java.io.File-objekt och kontrollera att filnamnstillägget är .pdf.
- Anropa com.adobe.idp.Document-objektets copyToFile-metod för att kopiera innehållet i com.adobe.idp.Document-objektet till filen. Kontrollera att du använder objektet com.adobe.idp.Document som metoden modifySignatureField returnerade.

Ändra signaturfält med webbtjänstens API modify-signature-fields-using-the-web-service-api

Ändra ett signaturfält med hjälp av signatur-API:t (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta det PDF-dokument som innehåller signaturfältet som ska ändras
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra det PDF-dokument som innehåller det signaturfält som ska ändras.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.

Ange lexikonvärden

Skapa ett PDFSignatureFieldProperties-objekt med hjälp av dess konstruktor. Det här objektet lagrar information om låsordlista för signaturfält och ordlista för startvärde.
Skapa ett PDFSeedValueOptionSpec-objekt med hjälp av dess konstruktor. Med det här objektet kan du ange ordlistevärden för startvärde.
Tillåt inte ändringar i PDF-dokumentet genom att tilldela uppräkningsvärdet MDPPermissions.NoChanges till PDFSeedValueOptionSpec-objektets mdpValue-datamedlem.
Skapa ett FieldMDPOptionSpec-objekt med hjälp av dess konstruktor. Med det här objektet kan du ange värden för låsning av signaturfält.
Lås alla fält i PDF-dokumentet genom att tilldela uppräkningsvärdet FieldMDPAction.ALL till FieldMDPOptionSpec-objektets mdpValue-datamedlem.
Ange information om startvärdesordlista genom att tilldela PDFSeedValueOptionSpec-objektet till PDFSignatureFieldProperties-objektets seedValue-datamedlem.
Ange information om låsning av signaturfält genom att tilldela FieldMDPOptionSpec-objektet till PDFSignatureFieldProperties-objektets fieldMDP-datamedlem.

note note
NOTE
Se klassreferensen `PDFSeedValueOptionSpec` om du vill se alla ordlistevärden för startvärde som du kan ange. (Se API-referens för AEM Forms).

Ändra signaturfältet

Ändra signaturfältet genom att anropa SignatureServiceClient-objektets modifySignatureField-metod och skicka följande värden:
- Det BLOB-objekt som lagrar dokumentet som innehåller signaturfältet som ska ändras
- Ett strängvärde som anger signaturfältets namn
- Objektet PDFSignatureFieldProperties som lagrar information om låsning av signaturfält och ordlista för startvärde
Metoden modifySignatureField returnerar ett BLOB-objekt som lagrar ett PDF-dokument som innehåller det ändrade signaturfältet.
Spara PDF-dokumentet som en PDF-fil
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska innehålla signaturfältet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returneras av metoden addSignatureField. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Signera PDF-dokument digitalt med Java API

Signera PDF-dokument digitalt digitally-signing-pdf-documents

Digitala signaturer kan användas i PDF-dokument för att ge en viss säkerhetsnivå. Digitala signaturer, precis som handskrivna signaturer, är ett sätt som signerare kan använda för att identifiera sig och göra programsatser om ett dokument. Den teknik som används för att digitalt signera dokument gör att både signeraren och mottagaren vet vad som signerats och vet att dokumentet inte har ändrats sedan det signerades.

PDF-dokument undertecknas med hjälp av teknik med öppen nyckel. En signerare har två nycklar: en offentlig nyckel och en privat nyckel. Den privata nyckeln lagras i en användares autentiseringsuppgifter som måste vara tillgängliga vid signeringen. Den offentliga nyckeln lagras i användarens certifikat som måste vara tillgängligt för mottagarna för att validera signaturen. Information om återkallade certifikat finns i listor över återkallade certifikat (CRL:er) och OCSP-svar (Online Certificate Status Protocol) som distribueras av certifikatutfärdare (CA:er). Tidpunkten för signering kan hämtas från en betrodd källa som kallas tidsstämpelutfärdare.

NOTE

Innan du kan signera ett PDF-dokument digitalt måste du se till att du lägger till certifikatet i AEM Forms. Ett certifikat läggs till med administrationskonsolen eller programmatiskt med Trust Manager API. (Se Importera autentiseringsuppgifter med Trust Manager API.)

Du kan signera PDF-dokument digitalt. När du signerar ett PDF-dokument digitalt måste du referera till en säkerhetsbehörighet som finns i AEM Forms. Autentiseringsuppgiften är den privata nyckel som används för signering.

Signaturtjänsten utför följande steg när ett PDF-dokument signeras:

Signaturtjänsten hämtar autentiseringsuppgifterna från förtroendelagret genom att skicka det alias som anges i begäran.
Truststore söker efter de angivna autentiseringsuppgifterna.
Autentiseringsuppgifterna returneras till signaturtjänsten och används för att signera dokumentet. Autentiseringsuppgiften cachelagras även mot aliaset för framtida begäranden.

Mer information om hur du hanterar säkerhetsuppgifter finns i guiden Installera och distribuera AEM Forms för programservern.

NOTE

Det finns skillnader mellan att underteckna och certifiera dokument. (Se Certifiera PDF-dokument.)

NOTE

Alla PDF-dokument har inte stöd för signering. Mer information om signaturtjänsten och digitalt signerade dokument finns i Tjänstreferens för AEM Forms.

NOTE

Signaturtjänsten stöder inte XDP-filer med inbäddade PDF-data som indata till en åtgärd, till exempel certifiering av ett dokument. Den här åtgärden resulterar i att signaturtjänsten genererar PDFOperationException. Du löser det här problemet genom att konvertera XDP-filen till en PDF-fil med tjänsten PDF Utilities och sedan skicka den konverterade PDF-filen till en Signature-tjänståtgärd. (Se Arbeta med PDF-verktyg.)

Krypterings-HSM-autentiseringsuppgifter

När du använder en Cipher Shield HSM-autentiseringsuppgift för att signera eller certifiera ett PDF-dokument, kan den nya autentiseringsuppgiften inte användas förrän J2EE-programservern som AEM Forms är distribuerad på har startats om. Du kan dock ange ett konfigurationsvärde, vilket gör att signerings- eller certifieringsåtgärden fungerar utan att J2EE-programservern startas om.

Du kan lägga till följande konfigurationsvärde i filen cknfastrc, som finns på /opt/nfast/cknfastrc (eller c:\nfast\cknfastrc):

    CKNFAST_ASSUME_SINGLE_PROCESS=0

När du har lagt till det här konfigurationsvärdet i cknfastrc-filen kan de nya autentiseringsuppgifterna användas utan att J2EE-programservern startas om.

>[ !OBS!]
>
> Du bör använda kommandot Ctrl + C för att starta om SDK:n. Om du startar om AEM SDK med alternativa metoder, till exempel genom att stoppa Java-processer, kan det leda till inkonsekvenser i den AEM utvecklingsmiljön.

Signaturen är inte betrodd

När du certifierar och signerar samma dokument i PDF visas en gul triangel mot den första signaturen när du öppnar dokumentet i PDF i Acrobat eller Adobe Reader, om den certifierande signaturen inte är tillförlitlig. Certifikatsignaturen måste vara betrodd för att den här situationen ska undvikas.

Signera dokument som är XFA-baserade formulär

Om du försöker signera ett XFA-baserat formulär med Signature Service API, kan data saknas i View Signed Version i Acrobat. Ta till exempel följande arbetsflöde:

Med hjälp av en XDP-fil som skapats med Designer kan du sammanfoga en formulärdesign som innehåller ett signaturfält och XML-data som innehåller formulärdata. Du använder Forms-tjänsten för att generera ett interaktivt PDF-dokument.
Du signerar PDF-dokumentet med signaturtjänstens API.

Sammanfattning av steg summary_of_steps-3

Så här signerar du ett PDF-dokument digitalt:

Inkludera projektfiler.
Skapa en signaturtjänstklient.
Få PDF-dokumentet att signera.
Underteckna PDF-dokumentet.
Spara det signerade PDF-dokumentet som en PDF-fil.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Skapa en signaturklient

Innan du programmässigt kan utföra en signeringstjänståtgärd måste du skapa en signaturtjänstklient.

Hämta PDF-dokumentet för signering

Om du vill signera ett PDF-dokument måste du skaffa ett PDF-dokument som innehåller ett signaturfält. Om ett PDF-dokument inte innehåller något signaturfält kan det inte signeras. Ett signaturfält kan läggas till med Designer eller via programmering.

Signera PDF-dokumentet

När du signerar ett PDF-dokument kan du ange körningsalternativ som används av signeringstjänsten. Du kan ange följande alternativ:

Utseendealternativ
Spärrkontroll
Värden för tidsstämpling

Du anger utseendealternativ med hjälp av ett PDFSignatureAppearanceOptionSpec-objekt. Du kan till exempel visa datumet i en signatur genom att anropa PDFSignatureAppearanceOptionSpec-objektets setShowDate-metod och skicka true.

Du kan också ange om en spärrkontroll ska utföras eller inte som avgör om det certifikat som används för att digitalt signera ett PDF-dokument har återkallats eller inte. Om du vill utföra spärrkontroll kan du ange ett av följande värden:

NoCheck: Utför inte spärrkontroll.
BestEffort: Försök alltid att kontrollera om alla certifikat i kedjan har återkallats. Om det uppstår något problem vid kontrollen antas återkallningen vara giltig. Om något fel inträffar antar du att certifikatet inte återkallas.
CheckIfAvailable: Kontrollera om det finns återkallningsinformation för alla certifikat i kedjan. Om något problem uppstår vid kontrollen antas återkallningen vara ogiltig. Om något fel inträffar antar du att certifikatet har återkallats och är ogiltigt. (Detta är standardvärdet.)
AlwaysCheck: Kontrollera om alla certifikat i kedjan har återkallats. Om det inte finns någon återkallningsinformation i något certifikat antas återkallningen vara ogiltig.

Om du vill utföra återkallningskontroll på ett certifikat kan du ange en URL till en CRL-server (Certificate revocation List) med hjälp av ett CRLOptionSpec-objekt. Om du vill utföra en spärrkontroll och inte anger en URL till en CRL-server, hämtar signaturtjänsten URL-adressen från certifikatet.

I stället för att använda en CRL-server kan du använda en OCSP-server (Online Certificate Status Protocol) när du utför spärrkontroll. När du använder en OCSP-server i stället för en CRL-server utförs spärrkontrollen oftast snabbare. (Se "Online Certificate Status Protocol" på https://tools.ietf.org/html/rfc2560.)

Du kan ställa in CRL- och OCSP-serverordningen som används av signaturtjänsten med Adobe-program och -tjänster. Om till exempel OCSP-servern är inställd först i Adobe-program och -tjänster kontrolleras OCSP-servern, som följs av CRL-servern. (Se Hantera certifikat och autentiseringsuppgifter med Trust Store i AAC-hjälpen.)

Om du anger att du inte ska utföra spärrkontroll kontrollerar inte signaturtjänsten om certifikatet som användes för att signera eller certifiera ett dokument har spärrats. CRL- och OCSP-serverinformation ignoreras alltså.

NOTE

Även om en CRL eller en OCSP-server kan anges i certifikatet, kan du åsidosätta den URL som anges i certifikatet genom att använda ett CRLOptionSpec- och ett OCSPOptionSpec-objekt. Om du till exempel vill åsidosätta CRL-servern kan du anropa CRLOptionSpec-objektets setLocalURI-metod.

Tidsstämpling avser processen att spåra den tidpunkt då ett signerat eller certifierat dokument ändrades. När ett dokument har signerats bör det inte ändras, inte ens av dokumentägaren. Tidsstämpling gör det lättare att framtvinga giltigheten av ett undertecknat eller certifierat dokument. Du kan ange tidsstämplingsalternativ med ett TSPOptionSpec-objekt. Du kan till exempel ange URL:en för en TSP-server (Time Stamping Provider).

NOTE

I Java- och webbtjänsten går du igenom sektioner och motsvarande snabbstarter används spärrkontroll. Eftersom ingen information om CRL- eller OCSP-server har angetts hämtas serverinformationen från certifikatet som används för att digitalt signera PDF-dokumentet.

Om du vill signera ett PDF-dokument kan du ange det fullständiga, kvalificerade namnet på signaturfältet som ska innehålla den digitala signaturen, till exempel form1[0].#subform[1].SignatureField3[3]. När du använder ett XFA-formulärfält kan signaturfältets delnamn också användas: SignatureField3[3].

Du måste även referera till en säkerhetsuppgift för att digitalt signera ett PDF-dokument. Om du vill referera till en säkerhetsreferens anger du ett alias. Aliaset är en referens till en faktisk autentiseringsuppgift som kan finnas i en PKCS#12-fil (med filnamnstillägget .pfx) eller en maskinvarusäkerhetsmodul (HSM). Mer information om säkerhetsuppgifter finns i guiden Installera och distribuera AEM Forms för programservern.

Spara det signerade PDF-dokumentet

När signeringstjänsten har signerat PDF-dokumentet digitalt kan du spara det som en PDF-fil så att användare kan öppna det i Acrobat eller Adobe Reader.

Se även

Signera PDF-dokument digitalt med webbtjänstens API

Hämtar namn på signaturfält

Signera PDF-dokument digitalt med Java API digitally-sign-pdf-documents-using-the-java-api

Signera ett PDF-dokument digitalt med signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Få PDF-dokumentet att signera
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som ska signeras digitalt med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Signera PDF-dokumentet

Signera PDF-dokumentet genom att anropa SignatureServiceClient-objektets sign-metod och skicka följande värden:
- Ett com.adobe.idp.Document-objekt som representerar det PDF-dokument som ska signeras.
- Ett strängvärde som representerar namnet på signaturfältet som ska innehålla den digitala signaturen.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att digitalt signera PDF-dokumentet. Skapa ett Credential-objekt genom att anropa Credential-objektets statiska getInstance-metod och skicka ett strängvärde som anger det aliasvärde som motsvarar säkerhetsuppgifter.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar hash-algoritmen som ska användas för att analysera PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet signerades digitalt.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den digitala signaturen. Du kan till exempel använda det här objektet för att lägga till en egen logotyp till en digital signatur.
- Ett java.lang.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat.
- Ett OCSPOptionSpec-objekt som lagrar inställningar för stöd för OCSP (Online Certificate Status Protocol). Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). Den här parametern är valfri och kan vara null. Mer information finns i AEM Forms API Reference.
Metoden sign returnerar ett com.adobe.idp.Document-objekt som representerar det signerade PDF-dokumentet.
Spara det signerade PDF-dokumentet
- Skapa ett java.io.File-objekt och kontrollera att filtillägget är .pdf.
- Anropa com.adobe.idp.Document-objektets copyToFile-metod och skicka java.io.File för att kopiera innehållet i Document-objektet till filen. Kontrollera att du använder objektet com.adobe.idp.Document som returnerades av metoden sign.

Se även

Snabbstart (SOAP): Signera ett PDF-dokument digitalt med Java API

Signera PDF-dokument digitalt med webbtjänstens API digitally-signing-pdf-documents-using-the-web-service-api

Så här signerar du ett PDF-dokument digitalt med signatur-API:t (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Få PDF-dokumentet att signera
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som är signerat.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska signeras samt läget i vilket filen ska öppnas.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.
Signera PDF-dokumentet

Signera PDF-dokumentet genom att anropa SignatureServiceClient-objektets sign-metod och skicka följande värden:
- Ett BLOB-objekt som representerar det PDF-dokument som ska signeras.
- Ett strängvärde som representerar namnet på signaturfältet som ska innehålla den digitala signaturen.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att digitalt signera PDF-dokumentet. Skapa ett Credential-objekt med hjälp av dess konstruktor och ange aliaset genom att tilldela ett värde till Credential-objektets alias -egenskap.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar hash-algoritmen som ska användas för att analysera PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett booleskt värde som anger om hash-algoritmen används.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet signerades digitalt.
- Ett strängvärde som representerar signerarens plats.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den digitala signaturen. Du kan till exempel använda det här objektet för att lägga till en egen logotyp till en digital signatur.
- Ett System.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat. Om spärrkontrollen är klar bäddas den in i signaturen. Standardvärdet är false.
- Ett OCSPOptionSpec-objekt som lagrar inställningar för stöd för OCSP (Online Certificate Status Protocol). Om spärrkontroll inte utförs används inte den här parametern och du kan ange null. Mer information om det här objektet finns i AEM Forms API Reference.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). Den här parametern är valfri och kan vara null.
Metoden sign returnerar ett BLOB-objekt som representerar det signerade PDF-dokumentet.
Spara det signerade PDF-dokumentet
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för det signerade PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden sign. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Signera ett interaktivt formulär digitalt med Java API

Digital Signing Interactive Forms digitally-signing-interactive-forms

Du kan signera ett interaktivt formulär som skapas av Forms-tjänsten. Ta till exempel följande arbetsflöde:

Du sammanfogar ett XFA-baserat PDF-formulär som skapats med Designer och formulärdata i ett XML-dokument med hjälp av Forms-tjänsten. Forms-servern återger ett interaktivt formulär.
Du signerar det interaktiva formuläret med hjälp av API:t för signaturtjänsten.

Resultatet är ett digitalt signerat interaktivt PDF-formulär. När du signerar ett PDF-formulär som är baserat på ett XFA-formulär ska du se till att du sparar PDF-filen som ett Adobe Static PDF. Om du försöker signera ett PDF-formulär som har sparats som ett Adobe dynamiskt PDF-formulär inträffar ett undantag. Eftersom du signerar formuläret som returneras från Forms-tjänsten måste du se till att formuläret innehåller ett signaturfält.

NOTE

Innan du kan signera ett interaktivt formulär digitalt måste du se till att du lägger till certifikatet i AEM Forms. Ett certifikat läggs till med administrationskonsolen eller programmatiskt med Trust Manager API. (Se Importera autentiseringsuppgifter med Trust Manager API.)

När du använder API:t för Forms-tjänsten anger du körningsalternativet GenerateServerAppearance till true. Med det här körningsalternativet kan du vara säker på att utseendet på det formulär som genereras på servern förblir giltigt när det öppnas i Acrobat eller Adobe Reader. Vi rekommenderar att du anger det här körningsalternativet när du genererar ett interaktivt formulär som ska signeras med Forms API.

NOTE

Innan du läser Digital Signing Interactive Forms rekommenderar vi att du är bekant med att signera PDF-dokument. (Se Signera PDF-dokument digitalt.)

Sammanfattning av steg summary_of_steps-4

Så här signerar du ett interaktivt formulär digitalt från Forms-tjänsten:

Inkludera projektfiler.
Skapa en Forms- och Signatures-klient.
Hämta det interaktiva formuläret med hjälp av tjänsten Forms.
Signera det interaktiva formuläret.
Spara det signerade PDF-dokumentet som en PDF-fil.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-forms-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en Forms- och signaturklient

Eftersom det här arbetsflödet anropar både Forms- och Signature-tjänsterna skapar du både en Forms-tjänstklient och en signaturtjänstklient.

Hämta det interaktiva formuläret med Forms-tjänsten

Du kan använda Forms-tjänsten för att hämta det interaktiva formuläret PDF för signering. Från och med AEM Forms kan du skicka ett com.adobe.idp.Document-objekt till den Forms-tjänst som innehåller det formulär som ska återges. Namnet på den här metoden är renderPDFForm2. Den här metoden returnerar ett com.adobe.idp.Document-objekt som innehåller formuläret som ska signeras. Du kan skicka den här com.adobe.idp.Document-instansen till signaturtjänsten.

Om du använder webbtjänster kan du på samma sätt skicka BLOB-instansen som Forms-tjänsten returnerar till signaturtjänsten.

NOTE

Snabbstarten som är associerad med avsnittet Digital Signing Interactive Forms anropar metoden renderPDFForm2.

Signera det interaktiva formuläret

När du signerar ett PDF-dokument kan du ange alternativ för körning som används av signaturtjänsten. Du kan ange följande alternativ:

Utseendealternativ
Spärrkontroll
Värden för tidsstämpling

Spara det signerade PDF-dokumentet

När signeringstjänsten har signerat PDF-dokumentet digitalt kan du spara det som en PDF-fil. PDF kan öppnas i Acrobat eller Adobe Reader.

Se även

Signera ett interaktivt formulär digitalt med webbtjänstens API

Återger interaktiv PDF forms

Signera ett interaktivt formulär digitalt med Java API digitally-sign-an-interactive-form-using-the-java-api

Signera ett interaktivt formulär digitalt med Forms och Signature API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar och adobe-forms-client.jar, i Java-projektets klassökväg.
Skapa en Forms- och Signatures-klient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
- Skapa ett FormsServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta det interaktiva formuläret med hjälp av tjänsten Forms
- Skapa ett java.io.FileInputStream-objekt som representerar PDF-dokumentet som ska skickas till Forms-tjänsten med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
- Skapa ett java.io.FileInputStream-objekt som representerar XML-dokumentet som innehåller formulärdata som ska skickas till Forms-tjänsten med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för XML-filen.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
- Skapa ett PDFFormRenderSpec-objekt som används för att ange körningsalternativ. Anropa PDFFormRenderSpec-objektets setGenerateServerAppearance-metod och skicka true.
- Anropa FormsServiceClient-objektets renderPDFForm2-metod och skicka följande värden:
  - Ett com.adobe.idp.Document-objekt som innehåller det PDF-formulär som ska återges.
  - Ett com.adobe.idp.Document-objekt som innehåller data som ska sammanfogas med formuläret.
  - Ett PDFFormRenderSpec-objekt som lagrar körningsalternativ.
  - Ett URLSpec-objekt som innehåller URI-värden som krävs av Forms-tjänsten. Du kan ange null som parametervärde.
  - Ett java.util.HashMap-objekt som lagrar bifogade filer. Det här är en valfri parameter och du kan ange null om du inte vill bifoga filer till formuläret.
  Metoden renderPDFForm2 returnerar ett FormsResult-objekt som innehåller en formulärdataström
- Hämta formuläret PDF genom att anropa FormsResult-objektets getOutputContent-metod. Den här metoden returnerar ett com.adobe.idp.Document-objekt som representerar det interaktiva formuläret.
Signera det interaktiva formuläret

Signera PDF-dokumentet genom att anropa SignatureServiceClient-objektets sign-metod och skicka följande värden:
- Ett com.adobe.idp.Document-objekt som representerar det PDF-dokument som ska signeras. Kontrollera att det här objektet är det com.adobe.idp.Document-objekt som hämtas från Forms-tjänsten.
- Ett strängvärde som representerar namnet på signaturfältet som är signerat.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att digitalt signera PDF-dokumentet. Skapa ett Credential-objekt genom att anropa Credential-objektets statiska getInstance-metod. Skicka ett strängvärde som anger aliasvärdet som motsvarar säkerhetsuppgifter.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar hash-algoritmen som ska användas för att analysera PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet signerades digitalt.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den digitala signaturen. Du kan till exempel använda det här objektet för att lägga till en egen logotyp till en digital signatur.
- Ett java.lang.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat.
- Ett OCSPPreferences-objekt som lagrar inställningar för stöd för OCSP (Online Certificate Status Protocol). Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). Den här parametern är valfri och kan vara null.
Metoden sign returnerar ett com.adobe.idp.Document-objekt som representerar det signerade PDF-dokumentet.
Spara det signerade PDF-dokumentet
- Skapa ett java.io.File-objekt och kontrollera att filnamnstillägget är .pdf.
- Anropa com.adobe.idp.Document-objektets copyToFile-metod och skicka java.io.File för att kopiera innehållet i Document-objektet till filen. Kontrollera att du använder objektet com.adobe.idp.Document som metoden sign returnerade.

Se även

Digital Signing Interactive Forms

Snabbstart (SOAP): Signera ett PDF-dokument digitalt med Java API

Digital Signing Interactive Forms

Signera ett interaktivt formulär digitalt med webbtjänstens API digitally-sign-an-interactive-form-using-the-web-service-api

Signera ett interaktivt formulär digitalt med Forms och Signature API (webbtjänsten):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Eftersom klientprogrammet anropar två AEM Forms-tjänster skapar du två tjänstreferenser. Använd följande WSDL-definition för den tjänstreferens som är associerad med signaturtjänsten: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

Använd följande WSDL-definition för den tjänstreferens som är associerad med Forms-tjänsten: http://localhost:8080/soap/services/FormsService?WSDL&lc_version=9.0.1.

Eftersom datatypen BLOB är gemensam för båda tjänstreferenserna kan du kvalificera datatypen BLOB fullständigt när du använder den. I motsvarande snabbstart för webbtjänsten är alla BLOB instanser kvalificerade.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en Forms- och Signatures-klient

Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
- Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
- Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
- Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.

note note
NOTE
Upprepa dessa steg för Forms tjänstklient.

Hämta det interaktiva formuläret med hjälp av tjänsten Forms
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som är signerat.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska signeras samt läget i vilket filen ska öppnas.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra formulärdata.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för XML-filen som innehåller formulärdata, och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.
- Skapa ett PDFFormRenderSpec-objekt som används för att ange körningsalternativ. Tilldela värdet true till PDFFormRenderSpec-objektets generateServerAppearance-fält.
- Anropa FormsServiceClient-objektets renderPDFForm2-metod och skicka följande värden:
  - Ett BLOB-objekt som innehåller det PDF-formulär som ska återges.
  - Ett BLOB-objekt som innehåller data som ska sammanfogas med formuläret.
  - Ett PDFFormRenderSpec-objekt som lagrar körningsalternativ.
  - Ett URLSpec-objekt som innehåller URI-värden som krävs av Forms-tjänsten. Du kan ange null som parametervärde.
  - Ett java.util.HashMap-objekt som lagrar bifogade filer. Det här är en valfri parameter och du kan ange null om du inte vill bifoga filer till formuläret.
  - En lång utdataparameter som används för att lagra antalet sidor i formuläret.
  - En strängutdataparameter som används för språkvärdet.
  - Ett FormResult-värde som är en utdataparameter som används för att lagra det interaktiva formuläret.
- Hämta formuläret PDF genom att anropa FormsResult-objektets outputContent-fält. Det här fältet lagrar ett BLOB-objekt som representerar det interaktiva formuläret.
Signera det interaktiva formuläret

Signera PDF-dokumentet genom att anropa SignatureServiceClient-objektets sign-metod och skicka följande värden:
- Ett BLOB-objekt som representerar det PDF-dokument som ska signeras. Använd instansen BLOB som returneras av Forms-tjänsten.
- Ett strängvärde som representerar namnet på signaturfältet som är signerat.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att digitalt signera PDF-dokumentet. Skapa ett Credential-objekt med hjälp av dess konstruktor och ange aliaset genom att tilldela ett värde till Credential-objektets alias -egenskap.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar hash-algoritmen som ska användas för att analysera PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett booleskt värde som anger om hash-algoritmen används.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet signerades digitalt.
- Ett strängvärde som representerar signerarens plats.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den digitala signaturen. Du kan till exempel använda det här objektet för att lägga till en egen logotyp till en digital signatur.
- Ett System.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat. Om spärrkontrollen är klar bäddas den in i signaturen. Standardvärdet är false.
- Ett OCSPPreferences-objekt som lagrar inställningar för stöd för OCSP (Online Certificate Status Protocol). Om spärrkontroll inte utförs används inte den här parametern och du kan ange null. Mer information om det här objektet finns i AEM Forms API Reference.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). Den här parametern är valfri och kan vara null.
Metoden sign returnerar ett BLOB-objekt som representerar det signerade PDF-dokumentet.
Spara det signerade PDF-dokumentet
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för det signerade PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden sign. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Certifiera PDF-dokument med Java API

Certifiera PDF-dokument certifying-pdf-documents

Du kan skydda ett PDF-dokument genom att certifiera det med en viss typ av signatur som kallas för en certifierad signatur. En certifierad signatur skiljer sig från en digital signatur på följande sätt:

Det måste vara den första signaturen som tillämpas på dokumentet i PDF. Det vill säga, när den certifierade signaturen tillämpas, måste alla andra signaturfält i dokumentet vara osignerade. Endast en certifierad signatur tillåts i ett PDF-dokument. Om du vill signera och certifiera ett PDF-dokument måste du certifiera det innan du signerar det. När du har certifierat ett PDF-dokument kan du signera ytterligare signaturfält digitalt.
Författaren eller författaren till dokumentet kan ange att dokumentet kan ändras på vissa sätt utan att den certifierade signaturen blir ogiltig. Dokumentet kan t.ex. tillåta ifyllnad av formulär eller kommentarer. Om författaren anger att en viss ändring inte är tillåten, begränsar Acrobat användare från att ändra dokumentet på det sättet. Om sådana ändringar görs, t.ex. om ett annat program används, är den certifierade signaturen ogiltig och Acrobat skickar en varning när en användare öppnar dokumentet. (Med icke-certifierade signaturer förhindras inte ändringar och normala redigeringsåtgärder gör inte den ursprungliga signaturen ogiltig.)
Vid tidpunkten för signering genomsöks dokumentet efter specifika typer av innehåll som kan göra innehållet i ett dokument tvetydigt eller vilseledande. En anteckning kan t.ex. dölja text på en sida som är viktig för att förstå vad som certifieras. En förklaring (juridisk attestering) kan ges om sådant innehåll.

Du kan certifiera PDF-dokument programmatiskt med hjälp av Java API:t för signaturtjänsten eller API:t för signaturwebbtjänsten. När du certifierar ett PDF-dokument måste du referera till en säkerhetsreferens som finns i tjänsten Credential. Mer information om säkerhetsuppgifter finns i guiden Installera och distribuera AEM Forms för programservern.

NOTE

När du certifierar och signerar samma dokument i PDF visas en gul triangel bredvid den första signeringssignaturen när du öppnar dokumentet i PDF i Acrobat eller Adobe Reader, om certifikatsignaturen inte är tillförlitlig. Certifikatsignaturen måste vara betrodd för att den här situationen ska undvikas.

NOTE

Du kan lägga till följande konfigurationsvärde i filen cknfastrc, som finns på /opt/nfast/cknfastrc (eller c:\nfast\cknfastrc):

    CKNFAST_ASSUME_SINGLE_PROCESS=0

När du har lagt till det här konfigurationsvärdet i cknfastrc-filen kan de nya autentiseringsuppgifterna användas utan att J2EE-programservern startas om.

NOTE

Mer information om signaturtjänsten och om hur du certifierar ett dokument finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-5

Så här certifierar du ett PDF-dokument:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta PDF-dokumentet som ska certifieras.
Certifiera PDF-dokumentet.
Spara det certifierade PDF-dokumentet som en PDF-fil.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en signaturklient

Innan du programmässigt kan utföra en signeringsåtgärd måste du skapa en signaturklient.

Hämta PDF-dokumentet för certifiering

Om du vill certifiera ett PDF-dokument måste du skaffa ett PDF-dokument som innehåller ett signaturfält. Om ett PDF-dokument inte innehåller något signaturfält kan det inte certifieras. Ett signaturfält kan läggas till med Designer eller via programmering. Mer information om att lägga till ett signaturfält programmatiskt finns i Lägga till signaturfält.

Certifiera PDF-dokumentet

Om du vill certifiera ett PDF-dokument måste du ange följande indatavärden som används av signaturtjänsten för att certifiera ett PDF-dokument:

PDF-dokument: Ett PDF-dokument som innehåller ett signaturfält, som är ett formulärfält som innehåller en grafisk representation av den certifierade signaturen. Ett PDF-dokument måste innehålla ett signaturfält innan det kan certifieras. Ett signaturfält kan läggas till med Designer eller via programmering. (Se Lägga till signaturfält.)
Namn på signaturfält: Det fullständiga kvalificerade namnet på signaturfältet som är certifierat. Följande värde är ett exempel: form1[0].#subform[1].SignatureField3[3]. När du använder ett XFA-formulärfält kan signaturfältets delnamn också användas: SignatureField3[3]. Om ett null-värde skickas för fältnamnet skapas och certifieras ett osynligt signaturfält dynamiskt.
Säkerhetsuppgifter: En autentiseringsuppgift som används för att certifiera PDF-dokumentet. Den här säkerhetsreferensen innehåller ett lösenord och ett alias, som måste matcha ett alias som visas i den autentiseringsuppgift som finns i autentiseringsuppgiften. Aliaset är en referens till en faktisk autentiseringsuppgift som kan finnas i en PKCS#12-fil (med filnamnstillägget .pfx) eller en maskinvarusäkerhetsmodul (HSM).
Hash-algoritm: En hash-algoritm som används för att analysera PDF-dokumentet.
Anledning till signering: Ett värde som visas i Acrobat eller Adobe Reader så att andra användare vet varför PDF-dokumentet certifierades.
Undertecknarens plats: Undertecknarens plats som anges av autentiseringsuppgifterna.
Kontaktinformation: Undertecknarens kontaktinformation, t.ex. adress och telefonnummer.
Behörighetsinformation: Behörigheter som styr de åtgärder som en slutanvändare kan utföra på ett dokument utan att den certifierade signaturen blir ogiltig. Du kan till exempel ställa in behörigheten så att den certifierade signaturen blir ogiltig om du ändrar PDF-dokumentet.
Juridisk förklaring: När ett dokument har certifierats skannas det automatiskt efter specifika typer av innehåll som kan göra innehållet i ett dokument tvetydigt eller vilseledande. En anteckning kan t.ex. dölja text på en sida som är viktig för att förstå vad som certifieras. Skanningsprocessen genererar varningar om dessa typer av innehåll. Det här värdet ger ytterligare en förklaring av innehållet som kan ha genererat varningar.
Utseendealternativ: Alternativ som styr utseendet på den certifierade signaturen. Den certifierade signaturen kan t.ex. visa datuminformation.
Spärrkontroll: Det här värdet anger om spärrkontroll utförs för signerarens certifikat. Standardinställningen false innebär att spärrkontroll inte utförs.
OCSP-inställningar: Inställningar för OCSP-stöd (Online Certificate Status Protocol), som ger information om statusen för de autentiseringsuppgifter som används för att certifiera PDF-dokumentet. Du kan till exempel ange webbadressen till servern som innehåller information om de autentiseringsuppgifter som du använder för att logga in på PDF-dokumentet.
CRL-inställningar: Inställningar för inställningar för listan över återkallade certifikat (CRL) om återkallningskontrollen är klar. Du kan till exempel ange att alltid ska kontrollera om en autentiseringsuppgift har återkallats.
Tidsstämpling: Inställningar som definierar tidsstämplingsinformation som används för den certifierade signaturen. En tidsstämpel anger att specifika data har upprättats före en viss tid. Denna kunskap hjälper till att bygga upp en förtroenderelation mellan signeraren och verifieraren.

Spara det certifierade PDF-dokumentet som en PDF-fil

När signaturtjänsten har certifierat PDF-dokumentet kan du spara det som en PDF-fil så att användare kan öppna det i Acrobat eller Adobe Reader.

Se även

Certifiera PDF-dokument med hjälp av webbtjänstens API

Snabbstart (SOAP): certifiera ett PDF-dokument med Java API

Certifiera PDF-dokument med Java API certify-pdf-documents-using-the-java-api

Certifiera ett PDF-dokument med signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta PDF-dokumentet för certifiering
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som ska certifieras med hjälp av dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Certifiera PDF-dokumentet

Certifiera PDF-dokumentet genom att anropa SignatureServiceClient-objektets certify-metod och skicka följande värden:
- Objektet com.adobe.idp.Document som representerar det PDF-dokument som ska certifieras.
- Ett strängvärde som representerar namnet på signaturfältet som ska innehålla signaturen.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att certifiera PDF-dokumentet. Skapa ett Credential-objekt genom att anropa Credential-objektets statiska getInstance-metod och skicka ett strängvärde som anger det aliasvärde som motsvarar säkerhetsuppgifter.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar den hash-algoritm som används för att sammanställa PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet certifierades.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett MDPPermissions-objekt som anger åtgärder som kan utföras på det PDF-dokument som gör underskriften ogiltig.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den certifierade signaturen. Om du vill kan du ändra signaturens utseende genom att anropa en metod, till exempel setShowDate.
- Ett strängvärde som ger en förklaring till vilka åtgärder som gör underskriften ogiltig.
- Ett java.lang.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat. Om spärrkontrollen är klar bäddas den in i signaturen. Standardvärdet är false.
- Ett java.lang.Boolean-objekt som anger om signaturfältet som certifieras är låst. Om fältet är låst markeras signaturfältet som skrivskyddat, dess egenskaper kan inte ändras och det kan inte rensas av någon som inte har de behörigheter som krävs. Standardvärdet är false.
- Ett OCSPPreferences-objekt som lagrar inställningar för stöd för OCSP (Online Certificate Status Protocol). Om spärrkontroll inte utförs används inte den här parametern och du kan ange null. Mer information om det här objektet finns i AEM Forms API Reference.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). När du till exempel har skapat ett TSPPreferences-objekt kan du ange TSP-serverns URL genom att anropa TSPPreferences-objektets setTspServerURL -metod. Den här parametern är valfri och kan vara null. Mer information finns i Tjänstreferens för AEM Forms.
Metoden certify returnerar ett com.adobe.idp.Document-objekt som representerar det certifierade PDF-dokumentet.
Spara det certifierade PDF-dokumentet som en PDF-fil
- Skapa ett java.io.File-objekt och kontrollera att filtillägget är .pdf.
- Anropa com.adobe.idp.Document-objektets copyToFile-metod för att kopiera innehållet i com.adobe.idp.Document-objektet till filen.

Se även

Certifiera PDF-dokument

Certifiera PDF-dokument med hjälp av webbtjänstens API certify-pdf-documents-using-the-web-service-api

Certifiera ett PDF-dokument med hjälp av signatur-API:t (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta PDF-dokumentet för certifiering
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett certifierat PDF-dokument.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska certifieras och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod och skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-datamedlem innehållet i bytearrayen.
Certifiera PDF-dokumentet

Certifiera PDF-dokumentet genom att anropa SignatureServiceClient-objektets certify-metod och skicka följande värden:
- Objektet BLOB som representerar det PDF-dokument som ska certifieras.
- Ett strängvärde som representerar namnet på signaturfältet som ska innehålla signaturen.
- Ett Credential-objekt som representerar de autentiseringsuppgifter som används för att certifiera PDF-dokumentet. Skapa ett Credential-objekt med hjälp av dess konstruktor och ange aliaset genom att tilldela ett värde till Credential-objektets alias -egenskap.
- Ett HashAlgorithm-objekt som anger en statisk datamedlem som representerar den hash-algoritm som används för att sammanställa PDF-dokumentet. Du kan till exempel ange HashAlgorithm.SHA1 för att använda SHA1-algoritmen.
- Ett booleskt värde som anger om hash-algoritmen används.
- Ett strängvärde som representerar orsaken till varför PDF-dokumentet certifierades.
- Ett strängvärde som representerar signerarens plats.
- Ett strängvärde som representerar signerarens kontaktinformation.
- Ett MDPPermissions-objekts statiska datamedlem som anger åtgärder som kan utföras på det PDF-dokument som gör underskriften ogiltig.
- Ett booleskt värde som anger om objektet MDPPermissions som skickades som föregående parametervärde ska användas.
- Ett strängvärde som förklarar vilka åtgärder som gör underskriften ogiltig.
- Ett PDFSignatureAppearanceOptions-objekt som styr utseendet på den certifierade signaturen. Skapa ett PDFSignatureAppearanceOptions-objekt med hjälp av dess konstruktor. Du kan ändra signaturens utseende genom att ange en av dess datamedlemmar.
- Ett System.Boolean-objekt som anger om spärrkontroll ska utföras på signerarens certifikat. Om spärrkontrollen är klar bäddas den in i signaturen. Standardvärdet är false.
- Ett System.Boolean-objekt som anger om signaturfältet som certifieras är låst. Om fältet är låst markeras signaturfältet som skrivskyddat, dess egenskaper kan inte ändras och det kan inte rensas av någon som inte har de behörigheter som krävs. Standardvärdet är false.
- Ett System.Boolean-objekt som anger om signaturfältet är låst. Det vill säga om du skickar true till föregående parameter, skickar du true till den här parametern.
- Ett OCSPPreferences-objekt som lagrar inställningar för OCSP-stöd (Online Certificate Status Protocol) som ger information om statusen för de autentiseringsuppgifter som används för att certifiera PDF-dokumentet. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett CRLPreferences-objekt som lagrar inställningar för listan över återkallade certifikat. Om spärrkontroll inte utförs används inte den här parametern och du kan ange null.
- Ett TSPPreferences-objekt som lagrar inställningar för stöd för tidsstämpelprovider (TSP). När du t.ex. har skapat ett TSPPreferences-objekt kan du ange TSP-objektets URL genom att ange TSPPreferences-objektets tspServerURL-datamedlem. Den här parametern är valfri och kan vara null.
Metoden certify returnerar ett BLOB-objekt som representerar det certifierade PDF-dokumentet.
Spara det certifierade PDF-dokumentet som en PDF-fil
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som ska innehålla det certifierade PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden certify. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets binaryData-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till en PDF-fil genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även

Certifiera PDF-dokument

Verifiera digitala signaturer med Java API

Verifierar digitala signaturer verifying-digital-signatures

Digitala signaturer kan verifieras för att säkerställa att ett signerat PDF-dokument inte ändras och att den digitala signaturen är giltig. När du verifierar en digital signatur kan du kontrollera signaturens status och dess egenskaper, t.ex. signerarens identitet. Innan du litar på en elektronisk underskrift bör du verifiera den. När du verifierar en digital signatur refererar du till ett PDF-dokument som innehåller en digital signatur.

Anta att undertecknarens identitet är okänd. När du öppnar PDF-dokumentet i Acrobat visas ett varningsmeddelande om att undertecknarens identitet är okänd, vilket visas på följande bild.

vd_vd_verifysig

På samma sätt kan du, när du programmässigt verifierar en digital signatur, fastställa status för signerarens identitet. Om du till exempel verifierar den digitala signaturen i dokumentet som visas i föregående bild, blir resultatet att signerarens identitet är okänd.

NOTE

Mer information om signaturtjänsten och verifiering av digitala signaturer finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-6

Så här verifierar du en digital signatur:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta det PDF-dokument som innehåller den signatur som ska verifieras.
Ange alternativ för PKI-körning.
Verifiera den digitala signaturen.
Fastställ signaturens status.
Identifiera undertecknarens identitet.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en signaturklient

Skapa en signaturtjänstklient innan du programmässigt utför en signeringstjänståtgärd.

Hämta det PDF-dokument som innehåller signaturen som ska verifieras

Om du vill verifiera en signatur som används för att digitalt signera eller certifiera ett PDF-dokument, ska du hämta ett PDF-dokument som innehåller en signatur.

Ange alternativ för PKI-körning

Ange följande PKI-körningsalternativ som används av signaturtjänsten när signaturer verifieras i ett PDF-dokument:

Verifieringstid
Spärrkontroll
Tidsstämplingsvärden

Som en del av inställningen av dessa alternativ kan du ange verifieringstid. Du kan till exempel välja aktuell tid (tiden på validerarens dator), vilket anger att den aktuella tiden ska användas. Information om de olika tidsvärdena finns i uppräkningsvärdet VerificationTime i AEM Forms API Reference.

Du kan också ange om spärrkontroll ska utföras som en del av verifieringsprocessen. Du kan till exempel utföra en spärrkontroll för att avgöra om certifikatet har återkallats. Mer information om alternativen för spärrkontroll finns i uppräkningsvärdet RevocationCheckStyle i AEM Forms API Reference.

Om du vill göra en återkallningskontroll på ett certifikat anger du en URL till en CRL-server (Certificate revocation List) med hjälp av ett CRLOptionSpec-objekt. Om du inte anger en URL till en CRL-server hämtar signaturtjänsten URL:en från certifikatet.

Om du inte utför spärrkontroll kontrollerar inte signaturtjänsten om certifikatet har spärrats. CRL- och OCSP-serverinformation ignoreras alltså.

NOTE

Du kan åsidosätta den URL som anges i certifikatet genom att använda ett CRLOptionSpec- och ett OCSPOptionSpec-objekt. Om du till exempel vill åsidosätta CRL-servern kan du anropa CRLOptionSpec-objektets setLocalURI-metod.

Tidsstämpling är processen att spåra den tid då ett signerat eller certifierat dokument ändrades. När ett dokument har signerats kan ingen ändra det. Tidsstämpling gör det lättare att framtvinga giltigheten av ett undertecknat eller certifierat dokument. Du kan ange tidsstämplingsalternativ med ett TSPOptionSpec-objekt. Du kan till exempel ange URL:en för en TSP-server (Time Stamping Provider).

NOTE

I snabbstarten för Java och webbtjänsten anges verifieringstiden till VerificationTime.CURRENT_TIME och spärrkontrollen är inställd på RevocationCheckStyle.BestEffort. Eftersom ingen CRL- eller OCSP-serverinformation har angetts hämtas serverinformationen från certifikatet.

Verifiera den digitala signaturen

Om du vill verifiera en signatur anger du det fullständiga, kvalificerade namnet på signaturfältet som innehåller signaturen, till exempel form1[0].#subform[1].SignatureField3[3]. När du använder ett XFA-formulärfält kan du även använda det partiella namnet på signaturfältet: SignatureField3.

Som standard begränsar signaturtjänsten den tid som ett dokument kan signeras efter valideringstiden till 65 min. Om en användare försöker verifiera en signatur vid den aktuella tidpunkten och signeringstiden är senare än den aktuella tiden och är inom 65 minuter, skapar inte signaturtjänsten något verifieringsfel.

NOTE

Andra värden som du behöver för att verifiera en signatur finns i AEM Forms API Reference.

Kontrollera signaturens status

Som en del av verifieringen av en digital signatur kan du kontrollera signaturens status.

Identifiera undertecknarens identitet

Du kan bestämma signerarens identitet, vilket kan vara något av följande värden:

Okänd: Den här signeraren är okänd eftersom det inte går att utföra signerarverifieringen.
Betrodd: Den här signeraren är betrodd.
Inte betrodd: Den här signeraren är inte betrodd.

Se även

Verifiera digitala signaturer med webbtjänstens API

Verifierar digitala signaturer

Verifiera digitala signaturer med Java API verify-digital-signatures-using-the-java-api

Verifiera en digital signatur med hjälp av Signature Service API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta PDF-dokumentet som innehåller signaturen som ska verifieras
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som innehåller signaturen som ska verifieras med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Ange alternativ för PKI-körning
- Skapa ett PKIOptions-objekt med hjälp av dess konstruktor.
- Ange verifieringstiden genom att anropa PKIOptions-objektets setVerificationTime-metod och skicka ett VerificationTime-uppräkningsvärde som anger verifieringstiden.
- Ange alternativet för spärrkontroll genom att anropa PKIOptions-objektets setRevocationCheckStyle-metod och skicka ett RevocationCheckStyle-uppräkningsvärde som anger om spärrkontroll ska utföras.
Verifiera den digitala signaturen

Verifiera signaturen genom att anropa SignatureServiceClient-objektets verify2-metod och skicka följande värden:
- Ett com.adobe.idp.Document-objekt som innehåller ett digitalt signerat eller certifierat PDF-dokument.
- Ett strängvärde som representerar signaturfältets namn som innehåller signaturen som ska verifieras.
- Ett PKIOptions-objekt som innehåller PKI-körningsalternativ.
- En VerifySPIOptions-instans som innehåller SPI-information. Du kan ange null för den här parametern.
Metoden verify2 returnerar ett PDFSignatureVerificationInfo-objekt som innehåller information som kan användas för att verifiera den digitala signaturen.
Bestäm signaturens status
- Fastställ signaturens status genom att anropa PDFSignatureVerificationInfo-objektets getStatus-metod. Den här metoden returnerar ett SignatureStatus-objekt som anger signaturstatusen. Om ett signerat PDF-dokument inte ändras returnerar den här metoden SignatureStatus.DocumentSigNoChanges.
Bestämma signerarens identitet
- Identifiera signerarens identitet genom att anropa PDFSignatureVerificationInfo-objektets getSigner-metod. Den här metoden returnerar ett IdentityInformation-objekt.
- Anropa IdentityInformation-objektets getStatus-metod för att fastställa undertecknarens identitet. Den här metoden returnerar ett IdentityStatus-uppräkningsvärde som anger identiteten. Om signeraren är betrodd returnerar den här metoden IdentityStatus.TRUSTED.

Se även

Snabbstart (SOAP): Verifiera en digital signatur med Java API

Verifierar digitala signaturer

Verifiera digitala signaturer med webbtjänstens API verify-digital-signatures-using-the-web-service-api

Verifiera en digital signatur med hjälp av Signature Service API (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta PDF-dokumentet som innehåller signaturen som ska verifieras
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som innehåller en digital eller certifierad signatur som ska verifieras.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för det signerade PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.
Ange alternativ för PKI-körning
- Skapa ett PKIOptions-objekt med hjälp av dess konstruktor.
- Ange verifieringstiden genom att tilldela PKIOptions-objektets verificationTime-datamedlem ett VerificationTime-uppräkningsvärde som anger verifieringstiden.
- Ange alternativet för spärrkontroll genom att tilldela revocationCheckStyle-objektets PKIOptions-datamedlem ett RevocationCheckStyle-uppräkningsvärde som anger om spärrkontroll ska utföras.
Verifiera den digitala signaturen

Verifiera signaturen genom att anropa SignatureServiceClient-objektets verify2-metod och skicka följande värden:
- Objektet BLOB som innehåller ett digitalt signerat eller certifierat PDF-dokument.
- Ett strängvärde som representerar signaturfältets namn som innehåller signaturen som ska verifieras.
- Ett PKIOptions-objekt som innehåller PKI-körningsalternativ.
- En VerifySPIOptions-instans som innehåller SPI-information. Du kan ange null för den här parametern.
Metoden verify2 returnerar ett PDFSignatureVerificationInfo-objekt som innehåller information som kan användas för att verifiera den digitala signaturen.
Bestäm signaturens status

Fastställ signaturens status genom att hämta värdet för PDFSignatureVerificationInfo-objektets status-datamedlem. Den här datamedlemmen lagrar ett SignatureStatus-objekt som anger signaturens status. Om till exempel ett signerat PDF-dokument ändras lagrar datamedlemmen status värdet SignatureStatus.DocumentSigNoChanges.
Bestämma signerarens identitet
- Identifiera signerarens identitet genom att hämta värdet för PDFSignatureVerificationInfo-objektets signer-datamedlem. Medlemmen returnerar ett IdentityInformation-objekt.
- Hämta IdentityInformation-objektets status-datamedlem för att fastställa signerarens identitet. Den här datamedlemmen returnerar ett IdentityStatus-uppräkningsvärde som anger identiteten. Om signeraren är betrodd returnerar den här medlemmen IdentityStatus.TRUSTED.

Se även

Verifiera flera digitala signaturer med Java API

Verifierar flera digitala signaturer verifying-multiple-digital-signatures

AEM Forms ger möjlighet att verifiera alla digitala signaturer i ett PDF-dokument. Anta att ett PDF-dokument innehåller flera digitala signaturer som ett resultat av en affärsprocess som kräver signaturer från flera signerare. Ta till exempel en finansiell transaktion som kräver både en lånesammans och en chefs underskrift. Du kan använda Java API:t för signaturtjänsten eller webbtjänstens API för att verifiera alla signaturer i PDF-dokumentet. När du verifierar flera digitala signaturer kan du kontrollera status och egenskaper för varje signatur. Innan du litar på en elektronisk underskrift bör du verifiera den. Vi rekommenderar att du är bekant med att verifiera en enda digital signatur.

NOTE

Mer information om signaturtjänsten och verifiering av digitala signaturer finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-7

Så här verifierar du flera digitala signaturer:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta det PDF-dokument som innehåller signaturerna som ska verifieras.
Ange alternativ för PKI-körning.
Hämta alla digitala signaturer.
Upprepa med alla signaturer.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster inkluderar du proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en signaturklient

Skapa en signaturtjänstklient innan du programmässigt utför en signeringstjänståtgärd.

Hämta det PDF-dokument som innehåller signaturerna som ska verifieras

Om du vill verifiera en signatur som används för att digitalt signera eller certifiera ett PDF-dokument, ska du hämta ett PDF-dokument som innehåller en signatur.

Ange PKI-körningsalternativ

Ange följande PKI-körningsalternativ som används av signaturtjänsten när alla signaturer i ett PDF-dokument verifieras:

Verifieringstid
Spärrkontroll
Tidsstämplingsvärden

Om du inte utför spärrkontroll kontrollerar inte signaturtjänsten om certifikatet har spärrats. CRL- och OCSP-serverinformation ignoreras alltså.

NOTE

Tidsstämpling är processen att spåra den tid då ett signerat eller certifierat dokument ändrades. När ett dokument har signerats kan ingen ändra det. Tidsstämpling gör det lättare att framtvinga giltigheten av ett undertecknat eller certifierat dokument. Du kan ange tidsstämplingsalternativ med hjälp av ett TSPOptionSpec-objekt. Du kan till exempel ange URL:en för en TSP-server (Time Stamping Provider).

NOTE

Hämta alla digitala signaturer

Om du vill verifiera alla digitala signaturer i ett PDF-dokument hämtar du de digitala signaturerna från PDF-dokumentet. Alla signaturer returneras i en lista. Som en del av verifieringen av en digital signatur kontrollerar du signaturens status.

NOTE

Till skillnad från när du verifierar en enda elektronisk underskrift behöver du inte ange signaturfältets namn när du verifierar flera underskrifter.

Upprepa genom alla signaturer

Iterera genom varje signatur. Det vill säga, för varje signatur, verifiera den digitala signaturen och kontrollera signerarens identitet och status för varje signatur. (Se Verifiera digitala signaturer.)

NOTE

Du behöver inte iterera igenom alla signaturer om kravet är hela dokumentet.

Se även

Verifiera flera digitala signaturer med webbtjänstens API

Verifierar flera digitala signaturer

Verifiera flera digitala signaturer med Java API verify-multiple-digital-signatures-using-the-java-api

Verifiera flera digitala signaturer med Signature Service API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta PDF-dokumentet som innehåller signaturerna som ska verifieras
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som innehåller flera digitala signaturer som ska verifieras med hjälp av dess konstruktor. Skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Ange alternativ för PKI-körning
- Skapa ett PKIOptions-objekt med hjälp av dess konstruktor.
- Ange verifieringstiden genom att anropa PKIOptions-objektets setVerificationTime-metod och skicka ett VerificationTime-uppräkningsvärde som anger verifieringstiden.
- Ange alternativet för spärrkontroll genom att anropa PKIOptions-objektets setRevocationCheckStyle-metod och skicka ett RevocationCheckStyle-uppräkningsvärde som anger om spärrkontroll ska utföras.
Hämta alla digitala signaturer

Anropa SignatureServiceClient-objektets verifyPDFDocument-metod och skicka följande värden:
- Ett com.adobe.idp.Document-objekt som innehåller ett PDF-dokument som innehåller flera digitala signaturer.
- Ett PKIOptions-objekt som innehåller PKI-körningsalternativ.
- En VerifySPIOptions-instans som innehåller SPI-information. Du kan ange null för den här parametern.
Metoden verifyPDFDocument returnerar ett PDFDocumentVerificationInfo-objekt som innehåller information om alla digitala signaturer i PDF-dokumentet.
Upprepa med alla signaturer
- Upprepa genom alla signaturer genom att anropa PDFDocumentVerificationInfo-objektets getVerificationInfos-metod. Den här metoden returnerar ett java.util.List-objekt där varje element är ett PDFSignatureVerificationInfo-objekt. Använd ett java.util.Iterator-objekt för att iterera igenom signaturlistan.
- Med objektet PDFSignatureVerificationInfo kan du utföra åtgärder som att fastställa signaturens status genom att anropa metoden getStatus för objektet PDFSignatureVerificationInfo . Den här metoden returnerar ett SignatureStatus-objekt vars statiska datamedlem informerar dig om signaturens status. Om signaturen till exempel är okänd returnerar metoden SignatureStatus.DocumentSignatureUnknown.

Se även

Snabbstart (SOAP): Verifiera flera digitala signaturer med Java API

Verifierar digitala signaturer

Verifierar flera digitala signaturer

Verifiera flera digitala signaturer med webbtjänstens API verifying-multiple-digital-signatures-using-the-web-service-api

Verifiera flera digitala signaturer med Signature Service API (webbtjänst):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta PDF-dokumentet som innehåller signaturerna som ska verifieras
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB lagrar ett PDF-dokument som innehåller flera digitala signaturer som ska verifieras.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor. Skicka ett strängvärde som representerar filplatsen för PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll i objektet BLOB genom att tilldela dess MTOM-egenskap innehållet i bytearrayen.
Ange alternativ för PKI-körning
- Skapa ett PKIOptions-objekt med hjälp av dess konstruktor.
- Ange verifieringstiden genom att tilldela PKIOptions-objektets verificationTime-datamedlem ett VerificationTime-uppräkningsvärde som anger verifieringstiden.
- Ange alternativet för spärrkontroll genom att tilldela PKIOptions-objektets revocationCheckStyle-datamedlem ett RevocationCheckStyle-uppräkningsvärde som anger om spärrkontroll ska utföras.
Hämta alla digitala signaturer

Anropa SignatureServiceClient-objektets verifyPDFDocument-metod och skicka följande värden:
- Ett BLOB-objekt som innehåller ett PDF-dokument som innehåller flera digitala signaturer.
- Ett PKIOptions-objekt som innehåller PKI-körningsalternativ.
- En VerifySPIOptions-instans som innehåller SPI-information. Du kan ange null för den här parametern.
Metoden verifyPDFDocument returnerar ett PDFDocumentVerificationInfo-objekt som innehåller information om alla digitala signaturer i PDF-dokumentet.
Upprepa med alla signaturer
- Iterera genom alla signaturer genom att hämta PDFDocumentVerificationInfo-objektets verificationInfos-datamedlem. Den här datamedlemmen returnerar en Object-array där varje element är ett PDFSignatureVerificationInfo-objekt.
- Med objektet PDFSignatureVerificationInfo kan du utföra åtgärder som att fastställa signaturens status genom att hämta PDFSignatureVerificationInfo-objektets status-datamedlem. Den här datamedlemmen returnerar ett SignatureStatus-objekt vars statiska datamedlem informerar dig om signaturens status. Om signaturen till exempel är okänd returnerar metoden SignatureStatus.DocumentSignatureUnknown.

Se även

Ta bort digitala signaturer med Java API

Tar bort digitala signaturer removing-digital-signatures

Digitala signaturer måste tas bort från ett signaturfält innan en nyare digital signatur kan användas. En digital signatur kan inte skrivas över. Om du försöker tillämpa en digital signatur på ett signaturfält som innehåller en signatur inträffar ett undantag.

NOTE

Mer information om signaturtjänsten finns i Tjänstreferens för AEM Forms.

Sammanfattning av steg summary_of_steps-8

Så här tar du bort en digital signatur från ett signaturfält:

Inkludera projektfiler.
Skapa en signaturklient.
Hämta det PDF-dokument som innehåller en signatur som ska tas bort.
Ta bort den digitala signaturen från signaturfältet.
Spara PDF-dokumentet som en PDF-fil.

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Följande JAR-filer måste läggas till i projektets klassökväg:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-signatures-client.jar
adobe-utilities.jar (krävs om AEM Forms används i JBoss)
jbossall-client.jar (krävs om AEM Forms används i JBoss)

Mer information om platsen för dessa JAR-filer finns i Inkludera AEM Forms Java-biblioteksfiler.

Skapa en signaturklient

Innan du programmässigt kan utföra en signeringstjänståtgärd måste du skapa en signaturtjänstklient.

Hämta det PDF-dokument som innehåller en signatur som ska tas bort

Om du vill ta bort en signatur från ett PDF-dokument måste du skaffa ett PDF-dokument som innehåller en signatur.

Ta bort den digitala signaturen från signaturfältet

Om du vill ta bort en digital signatur från ett PDF-dokument måste du ange namnet på signaturfältet som innehåller den digitala signaturen. Du måste också ha behörighet att ta bort den digitala signaturen, annars inträffar ett undantag.

Spara PDF-dokumentet som en PDF-fil

När signaturtjänsten har tagit bort en digital signatur från ett signaturfält kan du spara PDF-dokumentet som en PDF-fil så att användare kan öppna det i Acrobat eller Adobe Reader.

Se även

Ta bort digitala signaturer med webbtjänstens API

Tar bort digitala signaturer

Ta bort digitala signaturer med Java API remove-digital-signatures-using-the-java-api

Ta bort en digital signatur med signatur-API (Java):

Inkludera projektfiler

Inkludera JAR-klientfiler, t.ex. adobe-signatures-client.jar, i Java-projektets klassökväg.
Skapa en signaturklient.
- Skapa ett ServiceClientFactory-objekt som innehåller anslutningsegenskaper.
- Skapa ett SignatureServiceClient-objekt med hjälp av dess konstruktor och skicka ServiceClientFactory-objektet.
Hämta PDF-dokumentet som innehåller en signatur som ska tas bort
- Skapa ett java.io.FileInputStream-objekt som representerar det PDF-dokument som innehåller signaturen som ska tas bort genom att använda dess konstruktor och skicka ett strängvärde som anger platsen för PDF-dokumentet.
- Skapa ett com.adobe.idp.Document-objekt med hjälp av dess konstruktor och skicka java.io.FileInputStream-objektet.
Ta bort den digitala signaturen från signaturfältet

Ta bort en digital signatur från ett signaturfält genom att anropa SignatureServiceClient-objektets clearSignatureField-metod och skicka följande värden:
- Ett com.adobe.idp.Document-objekt som representerar det PDF-dokument som innehåller den signatur som ska tas bort.
- Ett strängvärde som anger namnet på det signaturfält som innehåller den digitala signaturen.
Metoden clearSignatureField returnerar ett com.adobe.idp.Document-objekt som representerar det PDF-dokument som den digitala signaturen har tagits bort från.
Spara PDF-dokumentet som en PDF-fil
- Skapa ett java.io.File-objekt och kontrollera att filtillägget är .pdf.
- Anropa metoden copyToFile för objektet com.adobe.idp.Document. Skicka objektet java.io.File för att kopiera innehållet i objektet com.adobe.idp.Document till filen. Kontrollera att du använder objektet Document som returnerades av metoden clearSignatureField.

Se även

Snabbstart (SOAP): Ta bort en digital signatur med Java API

Tar bort digitala signaturer

Ta bort digitala signaturer med webbtjänstens API remove-digital-signatures-using-the-web-service-api

Ta bort en elektronisk underskrift med hjälp av Signature API (webbtjänsten):

Inkludera projektfiler

Skapa ett Microsoft .NET-projekt som använder MTOM. Kontrollera att du använder följande WSDL-definition: http://localhost:8080/soap/services/SignatureService?WSDL&lc_version=9.0.1.

note note
NOTE
Ersätt `localhost` med IP-adressen för servern som är värd för AEM Forms.

Skapa en signaturklient
- Skapa ett SignatureServiceClient-objekt med hjälp av dess standardkonstruktor.
- Skapa ett SignatureServiceClient.Endpoint.Address-objekt med konstruktorn System.ServiceModel.EndpointAddress. Skicka ett strängvärde som anger WSDL till AEM Forms-tjänsten (till exempel http://localhost:8080/soap/services/SignatureService?WSDL). Du behöver inte använda attributet lc_version. Detta attribut används när du skapar en tjänstreferens.)
- Skapa ett System.ServiceModel.BasicHttpBinding-objekt genom att hämta värdet för fältet SignatureServiceClient.Endpoint.Binding. Skicka returvärdet till BasicHttpBinding.
- Ställ in System.ServiceModel.BasicHttpBinding-objektets MessageEncoding-fält till WSMessageEncoding.Mtom. Detta värde garanterar att MTOM används.
- Aktivera grundläggande HTTP-autentisering genom att utföra följande åtgärder:
  - Tilldela användarnamnet för AEM formulär till fältet SignatureServiceClient.ClientCredentials.UserName.UserName.
  - Tilldela motsvarande lösenordsvärde till fältet SignatureServiceClient.ClientCredentials.UserName.Password.
  - Tilldela konstantvärdet HttpClientCredentialType.Basic till fältet BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - Tilldela konstantvärdet BasicHttpSecurityMode.TransportCredentialOnly till fältet BasicHttpBindingSecurity.Security.Mode.
Hämta PDF-dokumentet som innehåller en signatur som ska tas bort
- Skapa ett BLOB-objekt med hjälp av dess konstruktor. Objektet BLOB används för att lagra ett PDF-dokument som innehåller en digital signatur som ska tas bort.
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det signerade PDF-dokumentet och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet System.IO.FileStream. Du kan bestämma storleken på bytearrayen genom att hämta System.IO.FileStream-objektets Length-egenskap.
- Fyll i bytearrayen med strömdata genom att anropa System.IO.FileStream-objektets Read-metod. Skicka bytearrayen, startpositionen och strömlängden som ska läsas.
- Fyll objektet BLOB genom att tilldela dess MTOM-egenskap med innehållet i bytearrayen.
Ta bort den digitala signaturen från signaturfältet

Ta bort den digitala signaturen genom att anropa SignatureServiceClient-objektets clearSignatureField-metod och skicka följande värden:
- Ett BLOB-objekt som innehåller det signerade PDF-dokumentet.
- Ett strängvärde som representerar namnet på signaturfältet som innehåller den digitala signaturen som ska tas bort.
Metoden clearSignatureField returnerar ett BLOB-objekt som representerar det PDF-dokument som den digitala signaturen har tagits bort från.
Spara PDF-dokumentet som en PDF-fil
- Skapa ett System.IO.FileStream-objekt genom att anropa dess konstruktor och skicka ett strängvärde som representerar filplatsen för det PDF-dokument som innehåller ett tomt signaturfält och läget som filen ska öppnas i.
- Skapa en bytearray som lagrar innehållet i objektet BLOB som returnerades av metoden sign. Fyll i bytearrayen genom att hämta värdet för BLOB-objektets MTOM-datamedlem.
- Skapa ett System.IO.BinaryWriter-objekt genom att anropa dess konstruktor och skicka System.IO.FileStream-objektet.
- Skriv bytearrayens innehåll till PDF-filen genom att anropa System.IO.BinaryWriter-objektets Write-metod och skicka bytearrayen.

Se även