Μετάβαση στο περιεχόμενο
Τεκμηρίωση · Εισαγωγή

Εισαγωγή

Το Usher είναι πάροχος ταυτότητας: συνδέει τους χρήστες στις εφαρμογές σας, κρατά τους λογαριασμούς τους ασφαλείς και λέει στην εφαρμογή σας ποιοι είναι. Τα κάνει όλα αυτά με OpenID Connect και OAuth 2.1, οπότε λειτουργεί με τις βιβλιοθήκες που ήδη χρησιμοποιείτε.

Τι κάνει το Usher

Ένας ταξιθέτης κάνει δύο δουλειές στην πόρτα: ελέγχει το εισιτήριό σας και σας οδηγεί στη θέση σας. Το Usher κάνει τις ίδιες δύο δουλειές για την εφαρμογή σας:

  • Έλεγχος ταυτότητας. Οι χρήστες αποδεικνύουν ποιοι είναι στο Lobby, τη φιλοξενούμενη σελίδα σύνδεσης του Usher, με κλειδί πρόσβασης, κωδικό μέσω email, μαγικό σύνδεσμο, λογαριασμό κοινωνικού δικτύου ή συνθηματικό.
  • Εξουσιοδότηση. Η εφαρμογή σας λαμβάνει διακριτικά που λένε ποιος είναι ο χρήστης και τι συμφώνησε να μοιραστεί, και το API σας μπορεί να τα ελέγξει.

Τα κομμάτια

ΚομμάτιΤι είναι
Το LobbyΗ φιλοξενούμενη σελίδα σύνδεσης. Ονομάζει πάντα την εφαρμογή στην οποία πηγαίνει ο χρήστης.
Λογαριασμός UsherΑυτό που έχει ένας άνθρωπος: το email του, τα κλειδιά πρόσβασης, τους δεύτερους παράγοντες και τις συνδεδεμένες συσκευές.
Usher ConsoleΕκεί δημιουργείτε έργα και περιβάλλοντα, καταχωρίζετε εφαρμογές και διαχειρίζεστε χρήστες.
SDK και στοιχεία@usher/nextjs, με <SignIn /> και <UserButton />. Έρχεται με το SDK.

Πώς ταιριάζει στην εφαρμογή σας

Κάθε περιβάλλον που δημιουργείτε είναι ξεχωριστός εκδότης OpenID Connect, σε δική του διεύθυνση:

Εκδότης
https://<handle>.usherid.com

Η εφαρμογή σας στέλνει τους χρήστες σε αυτόν τον εκδότη για να συνδεθούν και τους παίρνει πίσω με έναν κωδικό που ανταλλάσσει με διακριτικά. Αυτή είναι η τυπική ροή κωδικού εξουσιοδότησης με PKCE, και κάθε βήμα της περιγράφεται στο έγγραφο ανακάλυψης του εκδότη:

Έγγραφο ανακάλυψης
https://<handle>.usherid.com/.well-known/openid-configuration

Από πού να ξεκινήσετε