Saaja portaal

Saaja portaal on iseteeninduspiirkond aadressil badges.ninja/me, kus igaüks, kellele on antud märk, saab sisse logida (kontot pole vaja), sirvida iga badges.ninja kaudu saadud tõendit ja koostada avaliku profiili nende jagamiseks.

See on väljastaja töölauast eraldiseisev kogemus:

Sihtgrupp	URL	Autentimine
Väljastaja (kes märke annab)	/dashboard	Päris konto (e-post + parool / SSO)
Saaja (kes märke teenib)	/me	Maagiline link e-posti teel — kontot pole, parooli pole
Igaüks (kontrollijad)	/awards/<guid>, /verify/<guid>, /u/<handle>	Puudub — täielikult avalik

Miks paroolita?

Saajad ei peaks pidama meeles veel üht sisselogimist lihtsalt selleks, et vaadata märke, mis neile on antud. Selle asemel saadame neile ühekordse lingi e-posti teel.

Kuidas saajad sisse logivad

1. Sisesta oma e-post

Ava badges.ninja/me. Leht näitab ühte e-posti välja:

Sisesta e-posti aadress, mis märgid sai, ja klõpsa Saada mulle sisselogimislink.

Me vastame sõnumiga "kontrolli oma postkasti", olenemata sellest, kas sellele aadressile on tunnistusi olemas. See hoiab ära lekkimise, kas antud e-post on platvormi kaudu kunagi ükskõik milliselt väljastajalt märki saanud.

2. Ava maagiline link

Kui tunnistused sellele aadressile on olemas, saad e-kirja pealkirjaga "Sign in to your Badges Ninja portal" ühe nupuga:

Open my portal

Link kehtib 24 tundi ja toimib ainult korra. Kui see aegub enne klõpsamist, lihtsalt taotle uut — karistust pole.

3. Oled sees

Lingil klõpsamine avab badges.ninja/me?token=…. Leht vahetab tokeni 1-tunnise seansi tokeni vastu (salvestatakse ainult brauseri sessionStorage-sse, kunagi mitte küpsistesse) ja suunab sinu märgiseinale. Seanss aegub, kui sulged vahekaardi või pärast tundi tegevust, kumb saabub esimesena.

Märgisein

Kui oled sisse logitud, näitab portaal:

• Sinu handle üleval (nt badges.ninja/u/jane-3a4f) — automaatselt soovitatud sinu e-posti kohaliku osa põhjal koos 4 juhusliku tähemärgiga unikaalsuse tagamiseks. Klõpsa Muuda, et valida midagi paremat.
• Ruudustik igast märgist, mis on sinu e-postile antud badges.ninja kaudu, uuemad eespool, visuaalselt rühmitatud kaartide kaupa.
• Kaardipõhised toimingud:
  • Ava — mine avalikule tunnistuse lehele (samale, mida näevad väljastajad/kontrollijad).
  • Peida profiililt / Näita profiilil — lülita, kas see märk ilmub sinu avalikule profiilile (/u/<handle>). Tunnistus ise jääb kehtima; sa lihtsalt kureerid, mida avalikult loetletakse.

Lehendamine

Tunnistused laaditakse 50 korraga. Kui sul on rohkem, ilmub alla nupp Laadi veel; me lehendame taustal stabiilse kursoriga, nii et järjekord ei nihku kerides.

Välja logimine

Päises olev nupp Logi välja eemaldab seansi tokeni sessionStorage-st. Vahekaardi sulgemine teeb sama automaatselt.

Sinu avalik profiil

Kui sul on handle, näeb igaüks, kes külastab badges.ninja/u/<handle>, puhast sinu märkide ruudustikku koos sinu kuvanime ja märkide arvuga, pluss märkidepõhiseid kaarte, mis klõpsates avavad avaliku tunnistuse lehe.

Avalik profiil näitab ainult neid märke, mida sa pole peitnud. Sa ei pea sisse logima, et jagada oma /u/<handle> URL-i — see on täielikult avalik leht, mis kuulub sulle.

Handle'i valimine

Handle'id peavad olema 3–20 tähemärki, ainult a-z 0-9 _ -. Need on suur- ja väiketähtede tundetud ja globaalselt unikaalsed badges.ninja-s. Kui soovitud handle on võetud, saad selge veateate ja saad valida midagi muud.

Sa võid oma handle'i igal ajal portaalist muuta — uus muutub kohe kanooniliseks URL-iks ja vana muutub kellegi teise poolt võetavaks. Olemasolevad jagamislingid, mille oled saatnud (/u/old-handle), ei suuna ümber — need ütlevad lihtsalt "Profiili ei leitud".

Andmete eemaldamine (GDPR)

Portaali allosas on link Eemalda mu andmed Badges Ninjast. See teeb järgmist:

1. Asendab sinu e-posti igas saadud tunnistuses läbipaistmatu räsiga (nt removed:5f3a8b9c…). Tunnistus ise jääb puutumatuks (assertion JSON ja märgi pilt), et sa ei kehtetaks tõendit — väljastajatel jääb sinu märk endiselt alles —, kuid sa muutud leidmatuks: sinu e-posti otsimine mis tahes portaalis ei anna tulemusi ja sinu /me sisselogimine ei leia enam tunnistusi.
2. Kustutab sinu profiiliteabe rea, nii et /u/<handle> tagastab 404 ja handle muutub kellegi teise jaoks vabaks.

See on pöördumatu. Vajad uut portaali seanssi (st uut maagilist linki) ainult siis, kui muudad meelt enne puhastamise lõppu.

Mida see EI tee

• See ei kustuta tunnistusi. Väljastajal, kes need sinule andis, on endiselt kirje. Open Badges v2 assertsioonid (JSON-failid aadressil /awards/<guid>) jäävad kontrollimise eesmärkidel kehtima — selline on spetsifikatsioon.
• Kui soovid, et väljastaja tunnistuse tegelikult kustutaks (mitte lihtsalt sinu e-posti sellest eemaldaks), võta väljastajaga otse ühendust.

Sageli küsitud

Mu sõber ütleb, et teenis märgi, aga see ei ilmu

Kaks võimalust:

1. Väljastaja kasutas teist e-posti. Paljud väljastajad annavad tunnistuse tööandja e-postile; proovi sisse logida ka sellega.
2. Tunnistus on saaja portaali funktsioonist vanem. Me täidame e-postid tagantjärele nende tunnistuste jaoks, millele see oli seatud, kuid väga vanad tunnistused võisid olla välja antud ilma saaja e-postita (~99% platvormi ajaloolistest tunnistustest). Neid saab vaadata ainult otse /awards/<guid> URL-i kaudu.

Kas saan importida märke Credly / Accredible / teistelt platvormidelt?

Mitte veel. Portaal näitab praegu ainult badges.ninja kaudu välja antud märke. Ristväljastaja-liitmine ("Open Badges Backpacki" mudel) oli Open Badgese peamine eesmärk 2010. aastate alguses, kuid laiem ökosüsteem liikus LinkedIn-i kui de-facto liitjana. Me ei plaani sellel pinnal konkureerida.

Kas saan lisada märgi oma LinkedIn-i profiilile?

Jah — igal avalikul tunnistuse lehel (/awards/<guid>) on nupp Lisa LinkedIn-i profiilile, kui väljastaja on seadistanud oma LinkedIn-i organisatsiooni ID. Nupp kasutab LinkedIn-i Add-to-Profile süvalinki, nii et märk satub otse sinu Certifications osasse ilma käsitsi kopeerimata.

Kas mu vaatamiste arv on mulle nähtav?

Iga tunnistuse leht jälgib vaatamisi, jagamisi, allalaadimisi ja LinkedIn-i lisamise klõpse. Väljastajad näevad neid arve oma töölaual; saajad näevad neid avalikul tunnistuse lehel. Credly tavapäraselt vaataja identiteeti ei salvestata — ainult arvud.

Kui kaua maagiline link kehtib?

24 tundi. Pärast seda taotle uut — kiiruspiiranguid pole, karistusi pole.

Kui kaua kehtib seanss?

1 tund sisselogimisest. Lehe värskendamine selle akna sees hoiab seansi elus; vahekaardi sulgemine lõpetab selle.

Kas keegi teine näeb mu peidetud märke?

Ei. Peidetud märgid filtreeritakse avaliku /u/<handle> vaate välja. Need on nähtavad ainult sulle, kui oled portaali sisse logitud.

Kas saan oma märke alla laadida?

Jah — ava ükskõik milline märk portaalist, seejärel kasuta avaliku tunnistuse lehe nuppe Lae alla PNG (Open Badges küpsetatud) või Lae alla PDF-tunnistus. Mõlemad on allkirjastatud ja kontrollitavad Open Badges v2 spetsifikatsiooniga.

Kuidas see väljastajate jaoks välja näeb

Saajate poolt portaalile ligipääsemine ei muuda väljastaja jaoks midagi — tunnistuste tabel väljastaja töölaual töötab täpselt samamoodi. Portaal on puhtalt lisav.

Kui oled väljastaja, kes seda loeb, ega pole veel LinkedIn-i organisatsiooni ID-d seadistanud, tee seda kohe: Väljastajate haldamine → LinkedIn-i profiilile lisamine. See on platvormi "jagamismäära" suurim hoob.

Tehnilised üksikasjad (uudishimulikele)

Platvormi integraatoritele / Open Badgesi sõpradele

• Autentimismudel: olekuta HMAC-tokenid. Maagilise lingi kasulik koormus on { kind: "magic", email, exp } allkirjastatud serveripoolse saladusega, mida rotaseeritakse AWS Secrets Manageri kaudu (recipient/keys:tokenSecret). Kontrollimisel loome { kind: "session", email, exp } tokeni. Ei ühtegi DB-tuge seansitabelit.
• E-posti otsing: päringud GSI-le RECIPIENT_EMAIL_LC-TIMESTAMP autasude tabelis. E-post normaliseeritakse enne salvestamist ja otsimist väiketähtedeks.
• Avalik profiil: iga profiili rida salvestab EMAIL_LC, nii et /u/<handle> saab loetleda autasusid ka siis, kui saaja ei ole sisse logitud. Peidetud autasud filtreeritakse serveripoolselt.
• GDPR-unustamine: kirjutab iga sobiva autasurida RECIPIENT_EMAIL_LC ümber removed:<random>-iks ja eemaldab RECIPIENT_EMAIL tavalise teksti atribuudi DynamoDB UPDATE kaudu. Profiilirida kustutatakse.
• Otspunktid (ei Cognito; maagilise-lingi autentimine):
  • POST /me/auth/request { email } — saadab maagilise lingi e-postiga
  • POST /me/auth/verify { token } — tagastab seansi tokeni
  • GET /me — profiil + esimene autasude leht (Bearer)
  • GET /me/awards?lastEvaluatedKey=… — lehendatud (Bearer)
  • PUT /me/handle { handle } — määra/muuda handle'i (Bearer)
  • PUT /me/awards/{guid}/visibility { hidden: bool } — lülita peidetus (Bearer)
  • POST /me/auth/forget — GDPR-eemaldamine (Bearer)
  • GET /u/{handle} — avalik profiil (autentimiseta)