visual signature profile oasis - dss-x session 2

Visual Signature ProfileVisual Signature Profile OASIS - DSS-X OASIS - DSS-XSession 2Session 2

AgendaAgenda

Action Items from previous discussionsAction Items from previous discussions

Signature OperationSignature Operation

Verification OperationVerification Operation

Action ItemsAction Items

Support PDF Certify OperationSupport PDF Certify OperationA new Optional Parameter called: A new Optional Parameter called: DocumentRestrictionLevel DocumentRestrictionLevel of type of type integerinteger was added. This parameter defines the state of the restrictions was added. This parameter defines the state of the restrictions the documents turns to when the digital signature operation is the documents turns to when the digital signature operation is completed.completed.

Scenarios Vs. ConformanceScenarios Vs. ConformanceA new Optional Parameter called: A new Optional Parameter called: VisualSignaturePolicyVisualSignaturePolicy was added. was added. This value is mandatory and define restrictions to the input This value is mandatory and define restrictions to the input parameters. For example, in the case of a simple workflow operation, parameters. For example, in the case of a simple workflow operation, the client is not allowed to send any configuration for the created the client is not allowed to send any configuration for the created visual signature.visual signature.

FieldName typeFieldName typeA simple string is used instead of xs:ID.A simple string is used instead of xs:ID.

Visible Signature ContentVisible Signature Content

Visible Signature contentVisible Signature content

Signer Information – items will be extracted Signer Information – items will be extracted from the signer’s certificatefrom the signer’s certificateCA information – items will be extracted from CA information – items will be extracted from the signer’s certificatethe signer’s certificateSignature timeSignature timeSigner’s Related imageSigner’s Related imageAdditional application information – Reason Additional application information – Reason for the signature operationfor the signature operationDigital Signature:Digital Signature:

Encoded digital signatureEncoded digital signatureScanable digital signatureScanable digital signature

Visible Signature content – Cont.Visible Signature content – Cont.

The information is either passed to the digital The information is either passed to the digital signature service as part of a “document signature service as part of a “document submission” scenario or encoded inside the submission” scenario or encoded inside the signature field.signature field.

The configuration includes sub-elements, The configuration includes sub-elements, each element (text or image) will be each element (text or image) will be incorporated to the signature field in a incorporated to the signature field in a certain location. certain location. The location is abstract and a simple location The location is abstract and a simple location type is defined.type is defined.

Signature OperationSignature Operation

DSSSign operationDSSSign operation

The profile adds the following information The profile adds the following information that should be passed to the digital signature that should be passed to the digital signature service:service:

Visual Signature Policy – According to scenarioVisual Signature Policy – According to scenario

Document Type: PDF, OOXML, Open Office, …Document Type: PDF, OOXML, Open Office, …

Field IDField ID

Document Restriction LevelDocument Restriction Level

Visual Signature PositionVisual Signature Position

Visual Signature configurationVisual Signature configuration

DSSSign operation – document typeDSSSign operation – document type

Document Content and type – using the <Document> element Document Content and type – using the <Document> element in the DSSSign request. <Base64Data> will include the in the DSSSign request. <Base64Data> will include the document content.document content.The MimeType attribute will include the type of the document.The MimeType attribute will include the type of the document.

PDF – “application/pdfPDF – “application/pdf “ODF – “application/vnd.oasis.opendocument.text”DOCX – “application/vnd.openxmlformats-officedocument.wordprocessingml.document”TIF - image/tiff

…

If the document is sent via <AttachmentReference> the mime If the document is sent via <AttachmentReference> the mime type will be taken.type will be taken.

Mime Type is a mandatory parameter.Mime Type is a mandatory parameter.

DSSSign operation – optional inputsDSSSign operation – optional inputs

<xs:complexType name=VisualSignatureConfiguration”><xs:complexType name=VisualSignatureConfiguration”>

<xs:sequence><xs:sequence>

<xs:element ref="VisualSignaturePolicy"/><xs:element ref="VisualSignaturePolicy"/>

<xs:element name=”DocumentID” type=xs:ID” use=”optional”/><xs:element name=”DocumentID” type=xs:ID” use=”optional”/>

<xs:element ref=”FieldName” type=xs:string” use=”optional”/><xs:element ref=”FieldName” type=xs:string” use=”optional”/>

<xs:element ref=”VisualSignaturePosition” use=”optional”/><xs:element ref=”VisualSignaturePosition” use=”optional”/>

<xs:element ref=”VisualSignatureDisplayConfig” use=”optional”/><xs:element ref=”VisualSignatureDisplayConfig” use=”optional”/>

<xs:element name=”other” type=”dss:AnyType”/><xs:element name=”other” type=”dss:AnyType”/>

</xs:choice></xs:choice>

</xs:complexType></xs:complexType>

DocumentID will be used if several documents need to be signed.DocumentID will be used if several documents need to be signed.

DSSSign operation – Sig. PositionDSSSign operation – Sig. Position

<xs:element name="<xs:element name="VisualSignaturePositionVisualSignaturePosition" type=”" type=”VisualSignaturePositionTypeVisualSignaturePositionType”>”>

<xs:complexType name=“VisualSignaturePositionType” abstract=”true”/><xs:complexType name=“VisualSignaturePositionType” abstract=”true”/>

<xs:complexType name=“SimpleVisualSignaturePosition”><xs:complexType name=“SimpleVisualSignaturePosition”>

<xs:complexContent><xs:complexContent>

<xs:extension base=”VisualSignaturePositionType”><xs:extension base=”VisualSignaturePositionType”>


<xs:element name=”PageNumber” type=”xs:integer”/><xs:element name=”PageNumber” type=”xs:integer”/>

<xs:element name=”TopLeft-X” type=”xs:integer”/><xs:element name=”TopLeft-X” type=”xs:integer”/>

<xs:element name=”TopLeft-Y” type=”xs:integer”/><xs:element name=”TopLeft-Y” type=”xs:integer”/>

<xs:element name=”Width” type=”xs:integer” use=”optional”/><xs:element name=”Width” type=”xs:integer” use=”optional”/>

<xs:element name=”Height” type=”xs:integer” use=”optional”/><xs:element name=”Height” type=”xs:integer” use=”optional”/>

</xs:sequence></xs:sequence>

</xs:extension></xs:extension>

</xs:complexContent></xs:complexContent>

</xs:compelxType></xs:compelxType>

DSSSign operation – ConfigurationDSSSign operation – Configuration

<xs:element name="<xs:element name="VisualSignatureDisplayConfigVisualSignatureDisplayConfig" " type=”VisualSignatureDisplayConfigType”>type=”VisualSignatureDisplayConfigType”>

<xs:complexType name=<xs:complexType name=VisualSignatureDisplayConfigTypeVisualSignatureDisplayConfigType”>”><xs:sequence ><xs:sequence >

<xs:element name=”<xs:element name=”ShowLabelsShowLabels” type=”xs:boolean” use=”optional”>” type=”xs:boolean” use=”optional”><xs:choice minOccures=”0” maxOccures=”unbounded”><xs:choice minOccures=”0” maxOccures=”unbounded”>

<xs:element ref=”VisualSignatureItem”/><xs:element ref=”VisualSignatureItem”/></xs:choice></xs:choice>

</xs:sequence ></xs:sequence ></xs:complexType></xs:complexType>

<xs:complexType name=<xs:complexType name=VisualSignatureItemVisualSignatureItem”>”><xs:sequence><xs:sequence>

<xs:element name=”<xs:element name=”ItemNameItemName” type=” ItemNameEnum”/>” type=” ItemNameEnum”/><xs:element name=”<xs:element name=”ItemPositionItemPosition” type=”ItemPositionType”” type=”ItemPositionType”

use=“optional”/>/><xs:element name=”<xs:element name=”ItemValueItemValue” type=”ItemValueType” use=”optional”/>” type=”ItemValueType” use=”optional”/>

</xs:sequence></xs:sequence></xs:compelxType></xs:compelxType>

DSSSign operation – Element PositionDSSSign operation – Element Position

<xs:complexType name=“<xs:complexType name=“ItemPositionTypeItemPositionType” abstract=”true”/>” abstract=”true”/>

<xs:complexType name=”<xs:complexType name=”SimpleItemPositionTypeSimpleItemPositionType”>”>


<xs:extension base=”ItemPositionType”><xs:extension base=”ItemPositionType”>


<xs:element name=”TopLeftX” type=”xs:integer”/><xs:element name=”TopLeftX” type=”xs:integer”/>

<xs:element name=”TopLeftY” type=”xs:integer”/><xs:element name=”TopLeftY” type=”xs:integer”/>

</xs:sequence></xs:sequence>

</xs:extension></xs:extension>



The coordinates are relative to the visible signature rectangle (signature block)The coordinates are relative to the visible signature rectangle (signature block)

DSSSign operation – Element ValueDSSSign operation – Element Value

<xs:complexType name=“<xs:complexType name=“ItemValueTypeItemValueType” abstract=”true”/>” abstract=”true”/>

<xs:complexType name=<xs:complexType name=ItemValueStringTypeItemValueStringType”>”>


<xs:extension base=”ItemValueType”><xs:extension base=”ItemValueType”>


<xs:element name=”ItemValue” type=”xs:string”/><xs:element name=”ItemValue” type=”xs:string”/>

<xs:element name=”ItemFont” type=”xs:string” use=”optional”/><xs:element name=”ItemFont” type=”xs:string” use=”optional”/><xs:element name=”ItemFontSize” type=”xs:integer”<xs:element name=”ItemFontSize” type=”xs:integer”

use=”optional”/> use=”optional”/> </xs:sequence> </xs:sequence> </xs:extension> </xs:extension>



In the same manner Images and URI are defined.In the same manner Images and URI are defined.

Signature Verification Signature Verification OperationOperation

DSSVerify operation DSSVerify operation

Optional InputsOptional Inputs::

Field IDField IDOnly the digital signature that is linked to the given signature field is verified.Only the digital signature that is linked to the given signature field is verified.

VisibleIndicationFormatVisibleIndicationFormatThe Verify service can optionally embed a visual indication into the visible signature.The Verify service can optionally embed a visual indication into the visible signature.The visible indication can include the following:The visible indication can include the following:

Validation Mark – V, X, ?Validation Mark – V, X, ?Verification Time – The time of verification actionVerification Time – The time of verification actionVerification Scope – An indication to the level of certificationVerification Scope – An indication to the level of certification

Optional output:Optional output:

Field ID – The ID of the validated field.Field ID – The ID of the validated field.

DocumentWithSignature:DocumentWithSignature:

In the case of IncludeVisibleIndication, the updated document is In the case of IncludeVisibleIndication, the updated document is replied.replied.

General Questions General Questions

Can the reference include “functionality” of a given product such as Can the reference include “functionality” of a given product such as Adobe Reader or MS Office? Should we avoid this?Adobe Reader or MS Office? Should we avoid this?

Is it required to include examples in the profile or is it the scope of Is it required to include examples in the profile or is it the scope of another document?another document?

Next Step?Next Step?

visual signature profile oasis - dss-x session 2

Documents