เพื่อใช้สำหรับการสร้าง Digital Signature
\nการสร้าง Digital Signature ด้วย API นี้ ทาง client จะใช้เทคนิคที่เรียกว่า external sign โดยคำนวนหา hash ของ pdf content ที่ต้องการ Sign (รวม Signature Apperance) แล้วทำการส่งค่า hash มายัง server เพื่อรับ Sign Data ไปใส่ใน pdf
\nแนะนำให้ใช้ iText
https://kb.itextpdf.com/home/it7kb/examples/digital-signatures-chapter-4
https://gist.github.com/suthon-psu/209d4164999bafd2c6101af3c7042dd0
\nStartFragmentdFragment
\nแนะนำให้ใช้ SetaPDF-Signer
\nhttps://manuals.setasign.com/setapdf-signer-manual/signature-modules/individual-module
\nhttps://pypi.org/project/psusigner/ (ขอบคุณไลบราลีจาก อ.ธนาธิป)
\n(source code: https://gitlab.psu.ac.th/diis-itoc/psu-signer)
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"644041","collectionId":"3e8c6f1e-8c0c-4f0c-86a5-70daef25fca0","publishedId":"2s93eU1tyD","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2023-05-01T17:04:02.000Z"},"item":[{"name":"Sign","id":"08c1cd1d-007c-4fe0-87b5-b570e53f176c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Agent-Key","value":"H2MMK2jjwRzVz3ta1","description":"สำหรับแจ้งให้ทราบว่าเป็น Agent ใด
\n","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"code\": \"c1\",\r\n \"secret\": \"87654321\",\r\n \"pdfHash\": \"ZX69KEPmcdlmZNbW0/t9+aEU5PEXtQs7/1r+PWLvM8Y=\",\r\n \"ref1\": \"ref1\",\r\n \"ref2\": \"ref2\",\r\n \"remark\": \"remark..\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://ds-dev.psu.ac.th/api/v1/sign/withPdfSignature","description":"JSON Body
\njwtSecret ที่ใช้ใน API ทดสอบคือ 6MDhMa7LT+5Rb7RnnOaMWbVVG0xhZLXZAEJQpDBEnX5ndLjY8kKusEC5LFAXU/9QzKtbUcT6AGaNW2I8jnMACg==
\nทั้งนี้ jwtSecret จะเป็นค่า per Agent
\nเราทำขั้นตอนนี้เพื่อแสดง proof of identity โดยที่ jwtSecret จะไม่ถูกส่งไปพร้อมกับ request (ต่างกับ Agent Key)
\nสามารถทดลองออก jwt token ได้จาก https://jwt.io/
\nJSON Body
\nทั้งนี้ในตย. payload จะเป็นการ encode ข้อมูล string ดังแสดงข้างล่างด้วย alg = HS256
{
\"code\": \"c1\",
\"secret\": \"12345678\",
\"pdfHash\": \"ZX69KEPmcdlmZNbW0/t9+aEU5PEXtQs7/1r+PWLvM8Y=\"
}
exact match
\n","type":"text/plain"},"key":"ref1","value":"ref1"},{"description":{"content":"partial match
\n","type":"text/plain"},"key":"ref2","value":"ref2"},{"disabled":true,"description":{"content":"must apply when filter by action datetime
\n","type":"text/plain"},"key":"fromActionDateTime","value":"2023-06-05T11:00:00"},{"disabled":true,"description":{"content":"optional when filter by action datetime
\n","type":"text/plain"},"key":"toActionDateTime","value":"2023-06-05T12:00:00"},{"description":{"content":"maximum result
\n","type":"text/plain"},"key":"max","value":"10"},{"description":{"content":"result offset for pagination
\n","type":"text/plain"},"key":"offset","value":"0"},{"description":{"content":"[id, ref1, ref2, actionDateTime]
\n","type":"text/plain"},"key":"sort","value":"actionDateTime"},{"description":{"content":"[asc, desc]
\n","type":"text/plain"},"key":"order","value":"desc"}],"variable":[]}},"response":[{"id":"2ec6d8af-4caf-4bfb-8672-4a62b7cae6d1","name":"Logs","originalRequest":{"method":"GET","header":[{"key":"X-Agent-Key","value":"H2MMK2jjwRzVz3ta1","type":"text"}],"url":{"raw":"https://ds-dev.psu.ac.th/api/v1/sign/logs?ref1=ref1&ref2=ref2&fromActionDateTime=2023-06-05T11:00:00&toActionDateTime=2023-06-05T12:00:00&max=10&offset=0&sort=actionDateTime&order=desc","host":["https://ds-dev.psu.ac.th"],"path":["api","v1","sign","logs"],"query":[{"key":"certEntryCode","value":"c1","disabled":true},{"key":"ref1","value":"ref1","description":"exact match"},{"key":"ref2","value":"ref2","description":"partial match"},{"key":"fromActionDateTime","value":"2023-06-05T11:00:00","description":"must apply when filter by action datetime"},{"key":"toActionDateTime","value":"2023-06-05T12:00:00","description":"optional when filter by action datetime"},{"key":"max","value":"10"},{"key":"offset","value":"0"},{"key":"sort","value":"actionDateTime","description":"[id, ref1, ref2, actionDateTime]"},{"key":"order","value":"desc","description":"[asc, desc]"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Content-Language","value":"en-US"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 05 Jun 2023 04:43:34 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statusCode\": 1,\n \"data\": [\n {\n \"id\": \"2c9370818889cf13018889dc64b10005\",\n \"certEntryCode\": \"c1\",\n \"signatureHash\": \"ZX69KEPmcdlmZNbW0/t9+aEU5PEXtQs7/1r+PWLvM8Y=\",\n \"remark\": \"remark..\",\n \"ref2\": \"ref2\",\n \"ref1\": \"ref1\",\n \"actionDateTime\": \"2023-06-05T11:41:42.312\"\n }\n ],\n \"totalCount\": 1\n}"}],"_postman_id":"5431b2ea-bc35-4964-9a0e-94c5af4e9e34"}],"event":[{"listen":"prerequest","script":{"id":"ce479c26-c80b-4d0e-8174-b938dc3d0574","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"cd02ff25-86e8-49ab-b77a-50cb50c5c8dd","type":"text/javascript","exec":[""]}}],"variable":[{"key":"apiUrlPrefix","value":"https://ds-dev.psu.ac.th","type":"string"}]}