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>Zorunlu Olmayan Özelliklerin Eklenmesi</h2> <div class="level2"> <p> İmzaya adres bilgisi, imza zamanı bilgisi gibi opsiyonel bilgileri özellik olarak ekleyebilirsiniz. API'de tanımlı olan, kullanabileceğiniz özellikler; </p> <p> <img src="/esya-api/lib/images/smileys/fixme.gif" class="icon" alt="FIXME" /> Aşağıdaki tabloda CommitmentTypeIndicationAttr'nin alabileceği değerler tablonın satırı değil o attributun alt hücreleri şeklinde yeralmalılar. <img src="/esya-api/lib/images/smileys/fixme.gif" class="icon" alt="FIXME" /> </p> <span class='np_break'> </span> <div class="table"><table class="inline"> <tr class="row0"> <td class="col0"> SigningTimeAttr </td><td class="col1 leftalign"> Beyan edilen imza zamanını içerir. Ancak beyan edilen bu tarih güvenilir bir tarih olmadığından, imzanın bu tarihte atıldığını garanti etmez, bilgi amaçlı kullanılabilir. </td> </tr> <tr class="row1"> <td class="col0"> SignerLocationAttr </td><td class="col1 leftalign"> İmzacının adresi hakkında bilgiler içerir. İmzacının ülkesi, şehri ve posta adresi belirtilebilir. Bilgi amaçlı olduğundan bu bilgilerden bazılarının değeri null olabilir. </td> </tr> <tr class="row2"> <td class="col0"> CommitmentTypeIndicationAttr </td><td class="col1 leftalign"> İmza amacını belirtmek için kullanılabilir. İmzalanan verinin tarafınızdan oluşturulmuş olduğunu, sadece imzanın içeriğini onayladığınızı vs. belirtebilirsiniz. CommitmentType sınıfında tanımlanmış aşağıdaki değerler verilebilir. </td> </tr> <tr class="row3"> <td class="col0"> RECEIPT </td><td class="col1 leftalign"> İmza sahibinin imzalı belgeyi aldığını (bir yerden geliyor ise) belirtmek için kullanılır. </td> </tr> <tr class="row4"> <td class="col0"> SENDER </td><td class="col1 leftalign"> İmzalı veriyi gönderenin (imzalı veri bir yere gönderiliyor ise) veriyi gönderen kişi olduğunu belirtmek için kullanılır. Yani imza sahibinin gönderilen verinin içeriğini onayladığı anlamına gelmez sadece bunu ben gönderdim demektir. </td> </tr> <tr class="row5"> <td class="col0"> APPROVAL </td><td class="col1 leftalign"> İmza sahibinin belgenin içeriğini onayladığını belirtmek için kullanılır. </td> </tr> <tr class="row6"> <td class="col0"> APPROVAL, DELIVERY </td><td class="col1 leftalign"> Bir mesaj gönderildiğinde, bu mesajın karşı tarafa iletildiğini belirtmek için kullanılır. Bu tür imzalar genelde güvenilir servis sağlayıcılar (TSP - Trusted Service Provider) tarafından kullanılır. </td> </tr> <tr class="row7"> <td class="col0"> CREATION </td><td class="col1 leftalign"> İmza sahibinin belgeyi oluşturan kişi olduğunu belirtmek için kullanılır. Belge içeriğini onayladığı veya gönderdiği anlamına gelmez. </td> </tr> <tr class="row8"> <td class="col0"> ORIGIN </td><td class="col1 leftalign"> İmza sahibinin belgeyi oluşturduğunu, içeriğini onayladığını ve gönderenin de kendisi olduğunu belirtmek için kullanılır. </td> </tr> <tr class="row9"> <td class="col0"> ContentIdentifierAttr </td><td class="col1 leftalign"> İmzalanan içeriği tanımlamak için kullanılır. Özellikle ayrık imzada, imzalanan dökümanı imza ile eşleştrimek için kullanılabilir. byte [] olacak şekilde herhangi bir değer olabilir. </td> </tr> <tr class="row10"> <td class="col0"> ContentHintsAttr </td><td class="col1 leftalign"> İmzalanan içerik hakkında alıcıya fikir vermek amacıyla kullanılır. </td> </tr> <tr class="row11"> <td class="col0"> SignerAttributesAttr </td><td class="col1 leftalign"> İmzalayan kişi hakkında bilgiler içerir. İmzalayanın iddia ettiği özellikleri veya imzalayanın yetki sertifikasını barındırabilir. </td> </tr> </table> <span class='np_break'> </span> </div> <p> İmza atma sırasında imzaya eklenmek istenen özellikler bir listeye konularak kütüphaneye verilir. Eklenecek alanın değeri, alanın yaratılması sırasında kurucu fonksiyona verilir. Aşağıdaki örnekteki gibi imzaya eklenirler ve imzadan okunurlar. </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>