ESYAE-imza Kütüphaneleri

Bu sayfa salt okunur. Kaynağı görebilirsiniz ama değiştiremezsiniz. Bunun yanlış olduğunu düşünüyorsanız yöneticiye danışın.

<h2>Optional Attributes</h2> <div class="level2"> <p> You can add optional information such as signing time, adress as attributes into the signature. The list of attributes deifned in the API is as follows; </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="col0" colspan="2"> SigningTimeAttr </td><td class="col2 leftalign" colspan="2"> Contains stated signing time. It does not guarantee the exact signing time and is only used for informational purposes. </td> </tr> <tr class="row1"> <td class="col0" colspan="2"> SignerLocationAttr </td><td class="col2 leftalign" colspan="2"> Includes information about signer's address. Country, city and postal code might be included. Since it is only for informational purposes, some of its fields can be null. </td> </tr> <tr class="row2"> <td class="col0" colspan="2" rowspan="7"> CommitmentTypeIndicationAttr </td><td class="col2" colspan="2"> Specifies the intention of the signature. You can indicate that the signed document is created by yourself, or that you just confirm the content of the document etc. CommitmentType values are defined as follows: </td> </tr> <tr class="row3"> <td class="col0"> RECEIPT </td><td class="col1"> Indicates that the signature owner has received the signed document. </td><td class="col2"></td> </tr> <tr class="row4"> <td class="col0"> SENDER </td><td class="col1 leftalign"> Indicates that the sender of the signed document is the signer of the original document. That does not mean any confirmation of the content of the document by the sender. Sender only confirms that the document is sent by himself. </td><td class="col2"></td> </tr> <tr class="row5"> <td class="col0"> APPROVAL </td><td class="col1 leftalign"> Indicates that the signer confirms the content of the document. </td><td class="col2"></td> </tr> <tr class="row6"> <td class="col0"> APPROVAL, DELIVERY </td><td class="col1"> Indicates that a message is transferred successfully to the receiver. This type of messages are generally used by Trusted Service Providers (TSPs). </td><td class="col2"></td> </tr> <tr class="row7"> <td class="col0"> CREATION </td><td class="col1 leftalign"> Indicates the signer confirms that the signed document is created by himself. It does not include content confirmation. </td><td class="col2"></td> </tr> <tr class="row8"> <td class="col0"> ORIGIN </td><td class="col1 leftalign"> Indicates that the signer has created the document, confirmed its content and sent himself. </td><td class="col2"></td> </tr> <tr class="row9"> <td class="col0" colspan="2"> ContentIdentifierAttr </td><td class="col2 leftalign" colspan="2"> Identifies the signed content. Especially when the signature is detached, it is used to match signed document and the original document. It can have any binary value. </td> </tr> <tr class="row10"> <td class="col0" colspan="2"> ContentHintsAttr </td><td class="col2" colspan="2"> Provides additional information about the signed content. </td> </tr> <tr class="row11"> <td class="col0" colspan="2"> SignerAttributesAttr </td><td class="col2" colspan="2"> Provides information about the signer. The claimed attributes or the attribute certificate of the signecan take place here. </td> </tr> </table> <span class='np_break'> </span> </div> <p> When creating signatures, the attributes to be added into the signature is given to the API function as a list. They are added into the signature as follows; </p> <p> <em><</em>sxh java;title:Java> List<em><</em>IAttribute> optionalAttributes = new ArrayList<em><</em>IAttribute>(); optionalAttributes.add(new SigningTimeAttr(Calendar.getInstance())); optionalAttributes.add(new SignerLocationAttr("TURKEY", "KOCAELİ", new String[]{"TUBITAK UEKAE","GEBZE"})); optionalAttributes.add(new CommitmentTypeIndicationAttr(CommitmentType.CREATION)); optionalAttributes.add(new ContentIdentifierAttr("PL123456789".getBytes("ASCII"))); </p> <p> bs.addSigner(ESignatureType.TYPE_BES, cert , signer, optionalAttributes, params); </p> <p> SmartCardManager.getInstance().logout(); </p> <p> <em>reading Attributes BaseSignedData bs2 = new BaseSignedData(bs.getEncoded()); List</em><<em>EAttribute> attrs ; Signer aSigner = bs2.getSignerList().get(0); attrs = aSigner.getAttribute(SigningTimeAttr.OID); Calendar st = SigningTimeAttr.toTime(attrs.get(0)); System.out.println("Signing time: " + st.getTime()); attrs = aSigner.getAttribute(SignerLocationAttr.OID); ESignerLocation sl = SignerLocationAttr.toSignerLocation(attrs.get(0)); StringBuilder sb = new StringBuilder(); for (String address : sl.getPostalAddress()) sb.append(" " + address); System.out.println("\nCountry: " + sl.getCountry() + "\nCity: " + sl.getLocalityName() +"\nAdress: " + sb); attrs = aSigner.getAttribute(ContentIdentifierAttr.OID); byte [] ci = ContentIdentifierAttr.toIdentifier(attrs.get(0)); System.out.println("\n" + Arrays.toString(ci)); attrs = aSigner.getAttribute(CommitmentTypeIndicationAttr.OID); CommitmentType ct = CommitmentTypeIndicationAttr.toCommitmentType(attrs.get(0)); System.out.println("\n" + ct); </em><<em>/sxh> </em><<em>sxh csharp;title:C#> List</em><<em>IAttribute> optionalAttributes = new List</em><<em>IAttribute>(); optionalAttributes.Add(new SigningTimeAttr(DateTime.UtcNow)); optionalAttributes.Add(new SignerLocationAttr("TURKEY", "KOCAELI", new String[] { "TUBITAK UEKAE", "GEBZE" })); optionalAttributes.Add(new CommitmentTypeIndicationAttr(CommitmentType.CREATION)); optionalAttributes.Add(new ContentIdentifierAttr( ASCIIEncoding.ASCII.GetBytes("PL123456789"))); bs.addSigner(ESignatureType.TYPE_BES, cert, signer, optionalAttributes, params_); SmartCardManager.getInstance().logout(); </em>reading Attributes BaseSignedData bs2 = new BaseSignedData(bs.getEncoded()); List<em><</em>EAttribute> attrs; Signer aSigner = bs2.getSignerList()[0]; </p> <p> attrs = aSigner.getAttribute(SigningTimeAttr.OID); DateTime? st = SigningTimeAttr.toTime(attrs[0]); Console.WriteLine("Signing time: " + st.Value.ToLocalTime().ToString()); </p> <p> attrs = aSigner.getAttribute(SignerLocationAttr.OID); ESignerLocation sl = SignerLocationAttr.toSignerLocation(attrs[0]); StringBuilder sb = new StringBuilder(); foreach (String address in sl.getPostalAddress()) </p> <pre class="code"> sb.Append(" " + address); </pre><p> </p> <p> Console.WriteLine("\nCountry: " + sl.getCountry() + "\nCity: " + sl.getLocalityName() + "\nAdress: " + sb); </p> <p> attrs = aSigner.getAttribute(ContentIdentifierAttr.OID); byte[] ci = ContentIdentifierAttr.toIdentifier(attrs[0]); Console.WriteLine("\n" + BitConverter.ToString(ci)); </p> <p> attrs = aSigner.getAttribute(CommitmentTypeIndicationAttr.OID); CommitmentType ct = CommitmentTypeIndicationAttr.toCommitmentType(attrs[0]); Console.WriteLine("\n" + ct); <em><</em>/sxh> </p> </div>