Node.js, Python এবং Go-তে Open Badge সিগনেচার যাচাই করা

স্বাক্ষরিত Open Badge credential আনা, ইস্যুকারীর পাবলিক কী খুঁজে বের করা এবং JWS সিগনেচার যাচাই করার তিনটি কার্যকর কোড নমুনা (Node, Python, Go)।

Nacho Coll লেখক: আপডেট করা হয়েছে 9 মিনিট পড়া
স্বাক্ষরিত Open Badge credential আনা, ইস্যুকারীর পাবলিক কী খুঁজে বের করা এবং JWS সিগনেচার যাচাই করার তিনটি কার্যকর কোড নমুনা (Node, Python, Go)।

আপনি যদি credential ইস্যু করেন, তাহলে যাচাইয়ের বেশিরভাগ কাজ আপনার অজান্তেই হয়ে যায়: প্রাপক একটি লিংক শেয়ার করেন, নিয়োগকর্তা সেটিতে ক্লিক করেন, আর যাচাই পেজ বাকি কাজ করে। কিন্তু দেরিতে হোক বা আগে, কেউ একটা কঠিনতর প্রশ্ন করবেই। “আমি কীভাবে জানব যে এই ফাইলটা সত্যিই আপনি সাইন করেছেন, এবং পরে কেউ এটি এডিট করেনি?” এই প্রশ্নের উত্তর দেয় একটি ডিজিটাল সিগনেচার, আর যেকোনো জনপ্রিয় ভাষায় সেটি যাচাই করতে মোটামুটি পনেরো লাইন কোডই যথেষ্ট।

এই টিউটোরিয়ালে ধাপে ধাপে দেখানো হয়েছে কীভাবে https://badges.ninja থেকে ইস্যু করা একটি স্বাক্ষরিত Open Badges 3.0 credential Node.js, Python এবং Go-তে যাচাই করতে হয়। credential ইস্যু করতে এর কিছুই চালানোর দরকার নেই। এটি তাঁদের জন্য যাঁরা সিস্টেমটি অডিট করতে চান, অভ্যন্তরীণ যাচাইকরণ টুল বানাতে চান, বা “যাচাইযোগ্য” বলতে বাস্তবে কী বোঝায় তা বুঝতে চান।

আসলে আপনি কী যাচাই করছেন

Open Badges-এ যাচাইয়ের দুটি স্তর আছে, এবং দুটিকে আলাদা রাখলে বোঝা সহজ হয়।

Hosted যাচাই হলো Open Badges 2.0 মডেল। অ্যাওয়ার্ডের একটি পাবলিক URL থাকে, আর যে-কেউ সেটি খুললে ইস্যুকারী, ব্যাজ, প্রাপকের হ্যাশ করা পরিচয় এবং স্ট্যাটাস দেখতে পান। বিশ্বাসযোগ্যতা আসে এই কারণে যে ডেটা ইস্যুকারীর নিজস্ব ডোমেইন থেকে সরবরাহ করা হয়। https://badges.ninja-তে পেজটি খুলতে পারলেই credential আসল। এতে কোড বা সিগনেচার কিছুই লাগে না।

সিগনেচার যাচাই হলো Open Badges 3.0 মডেল, যা W3C Verifiable Credentials-এর ওপর তৈরি। credential-টি একটি স্বাক্ষরিত টোকেন হিসেবে প্যাকেজ করা থাকে, তাই বছর পরেও, এমনকি ওয়ালেট বা ইমেইল অ্যাটাচমেন্টে কপি হয়ে গেলেও, অফলাইনে এটি যাচাই করা যায়। বিশ্বাস আসে গণিত থেকে: টোকেনে এমন একটি সিগনেচার থাকে যা কেবল ইস্যুকারীর প্রাইভেট কী-এর মালিকই তৈরি করতে পারতেন।

https://badges.ninja-তে প্রতিটি অ্যাওয়ার্ড দুটি রূপেই পাওয়া যায়। এই লেখা দ্বিতীয়টি নিয়ে। দুই সংস্করণের পার্থক্যের পটভূমি জানতে পড়ুন Open Badges v2 vs v3, আর hosted JSON-এর পরিচিতির জন্য দেখুন Open Badge JSON-LD walkthrough।

কাজের অংশগুলো

স্বাক্ষরিত credential হলো একটি VC-JWT: একটি compact JWS, অর্থাৎ ডট দিয়ে আলাদা করা তিনটি base64url স্ট্রিং।

header.payload.signature
  • হেডার বলে এটি কীভাবে সাইন করা হয়েছে। আমাদের credential-এ এতে থাকে alg: EdDSA, typ: JWT এবং একটি kid (কী আইডি), যা দেখতে did:web:api.badges.ninja#<thumbprint>-এর মতো।
  • পেলোড-এ থাকে ক্লেইমগুলো, যার মধ্যে iss (ইস্যুকারী DID did:web:api.badges.ninja), jti (credential আইডি), nbf (কখন থেকে বৈধ), ঐচ্ছিক exp (মেয়াদ শেষ), এবং আসল OpenBadgeCredential সহ একটি vc অবজেক্ট।
  • সিগনেচার হলো header.payload-এর হুবহু বাইটের ওপর একটি Ed25519 সিগনেচার।

সিগনেচার যাচাইয়ের পাবলিক কী ইস্যুকারী দুটি জায়গায় প্রকাশ করেন, দুটিই অথেনটিকেশন ছাড়া:

  • https://api.badges.ninja/.well-known/jwks.json একটি JWK Set ফেরত দেয়।
  • https://api.badges.ninja/.well-known/did.json ফেরত দেয় did:web:api.badges.ninja-এর DID ডকুমেন্ট।

JWKS-এর kid হলো কী-টির RFC 7638 থাম্বপ্রিন্ট। টোকেন হেডারের kid হলো DID URL, এবং তার ফ্র্যাগমেন্ট (#-এর পরের অংশ) সেই একই থাম্বপ্রিন্ট। সঠিক কী বেছে নিতে এই ফ্র্যাগমেন্টই কাজে লাগে।

যাচাইয়ের রেসিপি

প্রতিটি ভাষায় একই পাঁচটি ধাপ:

  1. পাবলিক এন্ডপয়েন্ট থেকে স্বাক্ষরিত credential আনুন।
  2. টোকেনটিকে তিন ভাগে ভাগ করুন।
  3. হেডার পড়ুন, alg ঠিক EdDSA কি না দেখুন, এবং kid থেকে থাম্বপ্রিন্ট নিন।
  4. JWKS আনুন এবং যে কী-এর kid মেলে সেটি খুঁজে বের করুন।
  5. সেই কী দিয়ে header.payload-এর ওপর Ed25519 সিগনেচার যাচাই করুন।

credential এন্ডপয়েন্টটি পাবলিক এবং অ্যাওয়ার্ড আইডি নেয় (যাচাই URL-এ যে GUID দেখেন, যেমন https://badges.ninja/awards/<awardId>):

curl https://api.badges.ninja/certify-badge/award/<awardId>/vc

ডিফল্টভাবে এটি স্বাক্ষরিত VC-JWT application/jwt হিসেবে ফেরত দেয়। পড়ার জন্য স্বাক্ষরহীন credential JSON পেতে ?format=json যোগ করুন। যাচাই রেফারেন্স-এ দুটিই বর্ণিত আছে।

লক্ষ্য করুন, “আমার হয়ে যাচাই করে দাও” ধরনের আলাদা কোনো এন্ডপয়েন্ট নেই, এবং এটি ইচ্ছাকৃত। যে সার্ভার বলে “হ্যাঁ, বৈধ”, সে আপনাকে সার্ভারকেই বিশ্বাস করতে বলে। সিগনেচারের পুরো উদ্দেশ্যই হলো প্রকাশিত কী-এর বিপরীতে আপনি নিজেই যাচাই করতে পারবেন।

Node.js

Node-এর বিল্ট-ইন crypto মডিউল Ed25519 এবং JWK ইমপোর্ট সমর্থন করে, তাই কোনো ডিপেন্ডেন্সি লাগে না।

import crypto from "node:crypto";
const API = "https://api.badges.ninja";
const awardId = process.argv[2];
// —— 1. fetch the signed credential
const jwt = (await (await fetch(`${API}/certify-badge/award/${awardId}/vc`)).text()).trim();
// —— 2. split into parts
const [h, p, s] = jwt.split(".");
const header = JSON.parse(Buffer.from(h, "base64url").toString());
const payload = JSON.parse(Buffer.from(p, "base64url").toString());
// —— 3. refuse anything but EdDSA
if (header.alg !== "EdDSA") throw new Error(`unexpected alg: ${header.alg}`);
const thumbprint = header.kid.split("#")[1];
// —— 4. resolve the public key
const jwks = await (await fetch(`${API}/.well-known/jwks.json`)).json();
const jwk = jwks.keys.find((k) => k.kid === thumbprint);
if (!jwk) throw new Error("no matching key in JWKS");
const publicKey = crypto.createPublicKey({ key: jwk, format: "jwk" });
// —— 5. verify the signature over "header.payload"
const ok = crypto.verify(null, Buffer.from(`${h}.${p}`), publicKey, Buffer.from(s, "base64url"));
console.log(ok ? "signature valid" : "signature INVALID");
console.log("issuer:", payload.iss, "credential:", payload.jti);

null অ্যালগরিদম আর্গুমেন্টটি সঠিক: Ed25519-এ কী-এর ধরনই অ্যালগরিদম নির্ধারণ করে। লাইব্রেরি পছন্দ করলে jose একই কাজ করে compactVerify ও importJWK দিয়ে, এবং হেডার চেকও সামলে নেয়।

Python

cryptography প্যাকেজ সরাসরি Ed25519 দেয়। pip install cryptography requests দিয়ে ইনস্টল করুন।

import base64, json, sys
import requests
from cryptography.exceptions import InvalidSignature
from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey
API = "https://api.badges.ninja"
award_id = sys.argv[1]
def b64url(data: str) -> bytes:
    return base64.urlsafe_b64decode(data + "=" * (-len(data) % 4))
# —— 1. fetch the signed credential
jwt = requests.get(f"{API}/certify-badge/award/{award_id}/vc").text.strip()
# —— 2. split into parts
h, p, s = jwt.split(".")
header = json.loads(b64url(h))
payload = json.loads(b64url(p))
# —— 3. refuse anything but EdDSA
if header["alg"] != "EdDSA":
    raise SystemExit(f"unexpected alg: {header['alg']}")
thumbprint = header["kid"].split("#")[1]
# —— 4. resolve the public key
keys = requests.get(f"{API}/.well-known/jwks.json").json()["keys"]
jwk = next((k for k in keys if k["kid"] == thumbprint), None)
if jwk is None:
    raise SystemExit("no matching key in JWKS")
public_key = Ed25519PublicKey.from_public_bytes(b64url(jwk["x"]))
# —— 5. verify the signature over "header.payload"
try:
    public_key.verify(b64url(s), f"{h}.{p}".encode())
    print("signature valid")
except InvalidSignature:
    print("signature INVALID")
print("issuer:", payload["iss"], "credential:", payload["jti"])

এই লাইব্রেরিতে Ed25519-এর জন্য JWK ইমপোর্ট নেই, তাই আমরা নিজেরাই x কোঅর্ডিনেট (কাঁচা ৩২-বাইটের পাবলিক কী) ডিকোড করি। OKP টাইপ ও Ed25519 কার্ভের একটি JWK-এ ঠিক এটুকুই থাকে।

Go

Go-র স্ট্যান্ডার্ড লাইব্রেরিই সবকিছু কভার করে, crypto/ed25519 সহ।

package main
import (
	"crypto/ed25519"
	"encoding/base64"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)
const api = "https://api.badges.ninja"
func get(url string) []byte {
	res, err := http.Get(url)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	b, _ := io.ReadAll(res.Body)
	return b
}
func main() {
	awardID := os.Args[1]
	// —— 1. fetch the signed credential
	jwt := strings.TrimSpace(string(get(api + "/certify-badge/award/" + awardID + "/vc")))
	// —— 2. split into parts
	parts := strings.Split(jwt, ".")
	if len(parts) != 3 {
		panic("not a compact JWS")
	}
	enc := base64.RawURLEncoding
	hb, _ := enc.DecodeString(parts[0])
	var header struct{ Alg, Kid string }
	json.Unmarshal(hb, &header)
	// —— 3. refuse anything but EdDSA
	if header.Alg != "EdDSA" {
		panic("unexpected alg: " + header.Alg)
	}
	thumbprint := strings.Split(header.Kid, "#")[1]
	// —— 4. resolve the public key
	var jwks struct {
		Keys []struct{ Kid, X string } `json:"keys"`
	}
	json.Unmarshal(get(api+"/.well-known/jwks.json"), &jwks)
	var pub ed25519.PublicKey
	for _, k := range jwks.Keys {
		if k.Kid == thumbprint {
			pub, _ = enc.DecodeString(k.X)
		}
	}
	if pub == nil {
		panic("no matching key in JWKS")
	}
	// —— 5. verify the signature over "header.payload"
	sig, _ := enc.DecodeString(parts[2])
	ok := ed25519.Verify(pub, []byte(parts[0]+"."+parts[1]), sig)
	fmt.Println("signature valid:", ok)
}

go run main.go <awardId> দিয়ে চালান। পড়ার সুবিধার জন্য এরর হ্যান্ডলিং ছোট করা হয়েছে; বাস্তব টুলে প্রতিটি ডিকোড চেক করা উচিত।

সাধারণ ভুল এবং সেগুলো কীভাবে পড়বেন

JWKS-এ কী পাওয়া যাচ্ছে না। আপনি টোকেন হেডারের পুরো kid (did:web:api.badges.ninja#abc) JWKS-এর kid (abc)-এর সঙ্গে তুলনা করেছেন। শুধু #-এর পরের ফ্র্যাগমেন্ট তুলনা করুন। ফ্র্যাগমেন্ট তবুও না মিললে হতে পারে টোকেন তৈরির পর ইস্যুকারী কী রোটেট করেছেন; DID ডকুমেন্ট আনুন এবং এর verificationMethod এন্ট্রিগুলো দেখুন।

এইমাত্র ডাউনলোড করা টোকেনে সিগনেচার অবৈধ। নিশ্চিত করুন আপনি header.payload মূল base64url টেক্সট হিসেবেই যাচাই করেছেন, পুনরায় এনকোড করা JSON নয়। JSON নতুন করে সিরিয়ালাইজ করলে বাইট বদলে যায় এবং সিগনেচার ভেঙে যায়। ডাউনলোড করা টোকেনের শেষে নতুন লাইন আছে কি না, তাও দেখুন।

অ্যালগরিদম কনফিউশন। JWT-এর ক্লাসিক আক্রমণ হলো এমন টোকেন যা alg: none দাবি করে বা সিমেট্রিক অ্যালগরিদমে সুইচ করে, যাতে ভেরিফায়ার ভুলে সেটি গ্রহণ করে। আমাদের নমুনাগুলো প্রত্যাশিত অ্যালগরিদম EdDSA হার্ড-কোড করে এবং বাকি সবকিছু প্রত্যাখ্যান করে এটি এড়ায়। টোকেনকে কখনো ঠিক করতে দেবেন না কীভাবে সেটি যাচাই হবে।

Base64 প্যাডিং এরর। JWS প্যাডিং ছাড়া base64url ব্যবহার করে। Python-এ প্যাডিং আবার যোগ করতে হয় (উপরে দেখানো হয়েছে), আর Go-তে URLEncoding নয়, RawURLEncoding লাগে।

সিগনেচার বৈধ, কিন্তু credential কি এখনো ভালো? সিগনেচার সত্যতা ও অখণ্ডতা প্রমাণ করে, বর্তমান স্ট্যাটাস নয়। একটি credential সঠিকভাবে স্বাক্ষরিত হয়েও বাতিল বা মেয়াদোত্তীর্ণ হতে পারে। পেলোডের exp দেখুন, এবং এরপর বর্ণিত বাতিলকরণ স্ট্যাটাসও দেখুন।

বাতিলকরণের কথা ভুলবেন না

https://badges.ninja থেকে ইস্যু করা প্রতিটি Open Badges 3.0 credential-এ W3C Bitstring Status List অনুসরণ করা একটি credentialStatus এন্ট্রি থাকে। এটি এমন একটি স্ট্যাটাস লিস্ট credential-এর দিকে নির্দেশ করে যা আপনি /certify-badge/status/<listId> থেকে আনতে পারেন। ইস্যুকারী কোনো অ্যাওয়ার্ড বাতিল করলে ওই লিস্টে একটি বিট ফ্লিপ হয়; লিস্টটি প্রায় এক মিনিট ক্যাশ থাকে, তাই বাতিলকরণ দ্রুত ভেরিফায়ারদের কাছে পৌঁছায়। লিস্টটি ডিকোড করে credential-এর statusListIndex-এর বিট পড়ুন: 1 মানে বাতিল, 0 মানে সক্রিয়। যাচাই রেফারেন্স-এ সেই বিট চেকের একটি ছোট Node উদাহরণ আছে।

একটি সম্পূর্ণ ভেরিফায়ার তিনটি কাজ করে: সিগনেচার যাচাই, মেয়াদ পরীক্ষা এবং বাতিলকরণ বিট পরীক্ষা। ইস্যুকারীর দিক থেকে বাতিলকরণ দেখতে কেমন, তা জানতে ড্যাশবোর্ডের অ্যাকশনটি অ্যাওয়ার্ড গাইড-এ আছে।

যখন এসবের কিছুই দরকার নেই

বেশিরভাগ প্রোগ্রাম মালিককে কখনো এই কোড লিখতে হবে না, আর তাতে কোনো সমস্যা নেই। প্রতিদিনের যাচাইয়ের জন্য অ্যাওয়ার্ডের পাবলিক পেজ https://badges.ninja/awards/<awardId> খুলে পড়ুন। পেজটির জন্য সাইনআপ বা কী লাগে না, এবং এটি ইস্যুকারী, ব্যাজ ও স্ট্যাটাস দেখায়। প্রাপকরা তাঁদের পাবলিক credential পেজের Download মেনু থেকে Verifiable Credential ডাউনলোড করে যেকোনো Open Badges 3.0 ওয়ালেটে ইমপোর্টও করতে পারেন।

সিগনেচার যাচাই তখন মূল্যবান হয় যখন:

  • কোনো নিয়োগকর্তা বা বিশ্ববিদ্যালয় প্রাপ্ত credential-এর যাচাই স্বয়ংক্রিয় করতে চায়;
  • আপনি এমন একটি রেকর্ড সিস্টেম বানাচ্ছেন যা credential-এর কপি সংরক্ষণ করে এবং প্রমাণ করতে হয় যে সেগুলো পরিবর্তিত হয়নি;
  • কোনো অডিটর প্রমাণ চান যে আপনার credential স্বাধীনভাবে যাচাইযোগ্য, শুধু “আমাদের ওয়েবসাইটকে বিশ্বাস করুন” নয়।

ইস্যুর জন্য ব্যবহৃত একই API কী সেটআপ এখানে লাগে না, কারণ এই সব এন্ডপয়েন্ট পাবলিক। কোড থেকে credential ইস্যু করতে চাইলে API quickstart-এ কী তৈরি করা এবং প্রথম অ্যাওয়ার্ড দেওয়ার ধাপগুলো আছে।

API Keys — empty state

দ্রুত রেফারেন্স

বিষয়মান
স্বাক্ষরিত credentialGET https://api.badges.ninja/certify-badge/award/<awardId>/vc
পড়ার জন্য স্বাক্ষরহীন JSONএকই URL, সঙ্গে ?format=json
ইস্যুকারী DIDdid:web:api.badges.ninja
পাবলিক কী/.well-known/jwks.json এবং /.well-known/did.json
অ্যালগরিদমEd25519 (EdDSA)
কী মিলহেডার kid-এর ফ্র্যাগমেন্ট JWKS kid-এর সমান
বাতিলকরণcredentialStatus যা /certify-badge/status/<listId>-এর দিকে নির্দেশ করে

শেষ কথা

Open Badge সিগনেচার যাচাই একটি ছোট, যান্ত্রিক কাজ: টোকেন আনুন, অ্যালগরিদম নির্দিষ্ট করুন, থাম্বপ্রিন্ট দিয়ে কী খুঁজুন, এবং প্রথম দুই অংশের ওপর Ed25519 সিগনেচার যাচাই করুন। মেয়াদ ও বাতিলকরণ পরীক্ষা যোগ করলে আপনার হাতে এমন একটি ভেরিফায়ার থাকে যা ইস্যুকারীর প্রকাশিত কী ছাড়া আর কাউকে বিশ্বাস করে না। এই স্বাধীনতাই একটি ডিজিটাল credential-কে PDF-এর চেয়ে মূল্যবান করে তোলে।

আপনার প্রথম যাচাইযোগ্য credential ইস্যু করতে প্রস্তুত? badges.ninja-তে বিনামূল্যে শুরু করুন — ভিজুয়াল ডিজাইনার, পাবলিক যাচাই পেজ, PDF সার্টিফিকেট, Open Badge v2.0 আউটপুট। কোনো ক্রেডিট কার্ড লাগবে না।

ব্লগে ফিরুন

সম্পর্কিত নিবন্ধ