కంటెంట్‌కు వెళ్లు
డాక్యుమెంటేషన్ · పరిచయం

పరిచయం

Usher ఒక ఐడెంటిటీ ప్రొవైడర్: ఇది మీ యాప్‌లలోకి వ్యక్తులను సైన్ ఇన్ చేస్తుంది, వారి ఖాతాలను సురక్షితంగా ఉంచుతుంది, వారు ఎవరో మీ యాప్‌కు చెబుతుంది. ఇదంతా OpenID Connect, OAuth 2.1తో చేస్తుంది, కాబట్టి మీరు ఇప్పటికే ఉపయోగిస్తున్న లైబ్రరీలతోనే పనిచేస్తుంది.

Usher ఏమి చేస్తుంది

ఇంగ్లీషులో “usher” అంటే తలుపు దగ్గర నిలబడి రెండు పనులు చేసే వ్యక్తి. మీ టికెట్‌ను తనిఖీ చేస్తారు, మిమ్మల్ని మీ సీటు వరకు తీసుకెళ్తారు. Usher మీ యాప్ కోసం ఇవే రెండు పనులు చేస్తుంది:

  • ప్రామాణీకరణ (authentication). Usher హోస్ట్ చేసే సైన్-ఇన్ పేజీ అయిన లాబీలో, వ్యక్తులు తాము ఎవరో నిరూపిస్తారు: పాస్‌కీ, ఇమెయిల్‌లో పంపిన కోడ్, మ్యాజిక్ లింక్, సోషల్ ఖాతా లేదా పాస్‌వర్డ్‌తో.
  • అధికారీకరణ (authorisation). ఆ వ్యక్తి ఎవరో, వారు ఏమి పంచుకోవడానికి అంగీకరించారో తెలిపే టోకెన్‌లను మీ యాప్ అందుకుంటుంది, మీ API వాటిని తనిఖీ చేయగలదు.

భాగాలు

భాగంఅది ఏమిటి
లాబీహోస్ట్ చేయబడిన సైన్-ఇన్ పేజీ. వ్యక్తి ఏ యాప్‌కు వెళ్తున్నారో అది ఎప్పుడూ చూపిస్తుంది.
Usher ఖాతాఒక వ్యక్తికి ఉండేది: వారి ఇమెయిల్, పాస్‌కీలు, రెండవ ఫ్యాక్టర్‌లు, సైన్ ఇన్ అయిన పరికరాలు.
Usher Consoleమీరు ప్రాజెక్ట్‌లు, ఎన్విరాన్‌మెంట్‌లు సృష్టించే, అప్లికేషన్‌లను నమోదు చేసే, యూజర్‌లను నిర్వహించే చోటు.
SDK, కాంపోనెంట్‌లు@usher/nextjs, <SignIn />, <UserButton />లతో. SDKతో పాటు వస్తాయి.

ఇది మీ యాప్‌లో ఎలా ఇమిడిపోతుంది

మీరు సృష్టించే ప్రతి ఎన్విరాన్‌మెంట్ దాని సొంత చిరునామాలో ఉండే, దానికదే ఒక OpenID Connect ఇష్యూయర్:

ఇష్యూయర్
https://<handle>.usherid.com

సైన్ ఇన్ చేయడానికి మీ యాప్ వ్యక్తులను ఆ ఇష్యూయర్‌కు పంపుతుంది, ఒక కోడ్‌తో వారిని తిరిగి అందుకుంటుంది, ఆ కోడ్‌ను టోకెన్‌లకు మార్చుకుంటుంది. ఇది PKCEతో కూడిన ప్రామాణిక ఆథరైజేషన్ కోడ్ ఫ్లో, దానిలోని ప్రతి దశనూ ఇష్యూయర్ డిస్కవరీ డాక్యుమెంట్ వివరిస్తుంది:

డిస్కవరీ డాక్యుమెంట్
https://<handle>.usherid.com/.well-known/openid-configuration

ఎక్కడ మొదలుపెట్టాలి