మీ వెబ్‌సైట్‌లో Millida తో లాగిన్

Millida ఒక ఐడెంటిటీ ప్రొవైడర్‌గా పనిచేయగలదు: మీ సైట్‌లో ఒక విజిటర్ “Sign in with Millida” ను క్లిక్ చేసి, డేటా బదిలీని నిర్ధారించి, ఇప్పటికే ఆథెంటికేట్ అయిన స్థితిలో తిరిగి వస్తారు. ఇది OpenID Connect ద్వారా పనిచేస్తుంది — Google, Apple, లేదా Discord తో సైన్ ఇన్ చేసినట్లే — కాబట్టి ఏ రెడీమేడ్ OIDC లైబ్రరీ అయినా పనిచేస్తుంది.

ఐడెంటిటీ మాత్రమే బయటపడుతుంది: Minecraft నిక్‌నేమ్, పేరు, అవతార్, మరియు — మీరు అభ్యర్థించి, ఆ వ్యక్తి అంగీకరిస్తే — ఇమెయిల్, స్కిన్, లింక్ చేసిన Discord మరియు Telegram, మరియు ప్లాట్‌ఫారమ్‌పై రెప్యుటేషన్. బ్యాలెన్స్‌లు, లావాదేవీలు, మరియు సర్వర్‌లు అప్లికేషన్‌లకు అందుబాటులో ఉండవు.

మీరు ఏమి చేయాలి

1. ఒక అప్లికేషన్‌ను సృష్టించండి

Profile → API and webhooks → Sign in with Millida ట్యాబ్ → “Create application”.

మీకు ఇవి అవసరం:

• Name — సైన్-ఇన్ స్క్రీన్‌పై ఆ వ్యక్తి దీన్ని చూస్తారు. వేరొకరి అప్లికేషన్ పేరులో “Millida” అనే పదం నిషేధించబడింది.
• Redirect URI — నిర్ధారణ తర్వాత యూజర్‌ను ఎక్కడికి తిరిగి పంపాలి. https మాత్రమే (డెవలప్‌మెంట్ కోసం, http://localhost అనుమతించబడుతుంది). ఇది పూర్తిగా సరిపోలుతుంది: ఒక అదనపు స్లాష్ లేదా జోడించిన పారామీటర్ ఇక సరిపోలదు.
• Privacy policy link — మీకు డేటాను బదిలీ చేయడానికి ముందు ఆ వ్యక్తి దీన్ని చూస్తారు.

సృష్టించిన తర్వాత, మీరు client_id ను మరియు, సర్వర్ అప్లికేషన్ కోసం, client_secret ను పొందుతారు. సీక్రెట్ ఒకసారి మాత్రమే చూపబడుతుంది — వెంటనే దాన్ని సేవ్ చేయండి.

అప్లికేషన్ రకం: సీక్రెట్‌ను నిల్వ చేయగల బ్యాకెండ్ మీకు ఉంటే server; ఇది SPA లేదా మొబైల్ అప్లికేషన్ అయి, సీక్రెట్‌ను దాచడానికి చోటు లేకపోతే public.

2. లైబ్రరీకి ప్రొవైడర్ URL ను పేర్కొనండి

https://id.millida.net

అంతే సరిపోతుంది: లైబ్రరీ స్వయంగా https://id.millida.net/.well-known/openid-configuration ను చదివి, మిగిలిన URL‌లను కనుగొంటుంది.

3. ఆ వ్యక్తిని సైన్ ఇన్ చేయడానికి పంపండి

https://id.millida.net/oauth/authorize
  ?response_type=code
  &client_id=your_client_id
  &redirect_uri=https://your-site.ru/auth/millida/callback
  &scope=openid profile email
  &state=random_string
  &nonce=random_string
  &code_challenge=base64url(sha256(code_verifier))
  &code_challenge_method=S256

PKCE అందరికీ తప్పనిసరి, సర్వర్ అప్లికేషన్‌లతో సహా. సెషన్‌లో state ను సేవ్ చేసి, తిరిగి వచ్చినప్పుడు దాన్ని ధృవీకరించండి — ఇది లేకుండా, వేరొకరి రెస్పాన్స్ మీ సెషన్‌లోకి ఇంజెక్ట్ చేయబడవచ్చు.

4. టోకెన్‌ల కోసం కోడ్‌ను మార్చుకోండి

POST https://id.millida.net/oauth/token
Content-Type: application/x-www-form-urlencoded
Authorization: Basic base64(client_id:client_secret)

grant_type=authorization_code&code=…&redirect_uri=…&code_verifier=…

రెస్పాన్స్‌లో access_token, id_token, మరియు మీరు offline_access అభ్యర్థించినట్లయితే refresh_token ఉంటాయి.

5. ఎవరు సైన్ ఇన్ చేశారో తెలుసుకోండి

id_token ను పార్స్ చేయండి (JWKS, iss, aud, exp, nonce ఆధారంగా సంతకాన్ని ధృవీకరించండి) లేదా అభ్యర్థించండి:

GET https://id.millida.net/oauth/userinfo
Authorization: Bearer <access_token>

మీరు ఏ డేటాను అభ్యర్థించవచ్చు

ఆఫ్‌లైన్ నిక్‌నేమ్‌కు UUID ఉండదు — minecraft_uuid ఖాళీగా ఉంటుంది, మరియు minecraft_username ఖాతా నుండి నింపబడుతుంది. telegram_id ఒక స్ట్రింగ్‌గా వస్తుంది: ఒక Telegram చాట్ id JSON ఖచ్చిత సంఖ్యలో ఇమడదు, మరియు దాన్ని సంఖ్యగా పార్స్ చేస్తే చివరి అంకెలు పాడవుతాయి.

సైన్-ఇన్ పనిచేయడానికి అవసరమైనది మాత్రమే అభ్యర్థించండి: ప్రతి అదనపు అంశాన్ని ఆ వ్యక్తి సమ్మతి స్క్రీన్‌పై చదువుతారు మరియు అక్కడే తమ మనసు మార్చుకోవచ్చు.

యూజర్ ఐడెంటిఫైయర్ గురించి

ఒకే వ్యక్తికి sub ప్రతి అప్లికేషన్‌కు వేరుగా ఉంటుంది. ఇది మీ సైట్ కోసం మార్పులేనిది, కానీ ఇది ఇతర సైట్‌లలోని sub తో సరిపోలదు — దీని ద్వారా మీరు అప్లికేషన్‌ల మధ్య ఆడియన్స్‌లను సరిపోల్చలేరు.

sub ను యూజర్ కీగా నిల్వ చేయండి. ఇమెయిల్ దీనికి సరిపోదు: అది మార్చబడవచ్చు.

అప్లికేషన్ ధృవీకరణ

కొత్త అప్లికేషన్ వెంటనే పనిచేస్తుంది, కానీ సైన్-ఇన్ స్క్రీన్‌పై అది ధృవీకరించబడనిదిగా గుర్తించబడుతుంది. సైట్ సిద్ధమైనప్పుడు, డాష్‌బోర్డ్‌లో “Submit for review” ను క్లిక్ చేయండి — మేము ఒకసారి పరిశీలించి ఆ లేబుల్‌ను తొలగిస్తాము.

సాధారణ లోపాలు

“redirect_uri does not match any registered address” — చిరునామా పూర్తి స్ట్రింగ్‌గా సరిపోలుతుంది. ట్రైలింగ్ స్లాష్, స్కీమ్, మరియు పోర్ట్‌ను తనిఖీ చేయండి.

“Only code_challenge_method=S256 is supported” — PKCE తప్పనిసరి, plain అంగీకరించబడదు.

“The authorization code has already been used” — కోడ్ ఒకసారి మాత్రమే వాడగలిగేది మరియు ఒక నిమిషం పాటు జీవిస్తుంది. పునరావృత మార్పిడి లీక్‌కు సంకేతంగా పరిగణించబడుతుంది మరియు అప్లికేషన్ యాక్సెస్‌ను పూర్తిగా రద్దు చేస్తుంది.

రద్దు తర్వాత టోకెన్ పనిచేయడం ఆపేసింది — ఆ వ్యక్తి ప్రొఫైల్ భద్రతా సెట్టింగ్‌లలో అప్లికేషన్‌ను నిలిపివేశారు. ఇది ఆశించిన ప్రవర్తన: వారిని మళ్లీ సైన్ ఇన్ చేయడానికి పంపండి.

ఒక వ్యక్తి యాక్సెస్‌ను ఎలా రద్దు చేస్తారు

Profile → Security → “Connected applications” → “Revoke”. యాక్సెస్ వెంటనే ఆగిపోతుంది, మరియు జారీ చేయబడిన అన్ని టోకెన్‌లు చెల్లకుండా పోతాయి.