Giới thiệu
Usher là một nhà cung cấp danh tính: Usher đăng nhập cho người dùng vào ứng dụng của bạn, giữ an toàn cho tài khoản của họ, và cho ứng dụng biết họ là ai. Usher làm tất cả những việc này bằng OpenID Connect và OAuth 2.1, nên hoạt động với các thư viện bạn đang dùng.
Usher làm gì
Một người soát vé (usher) làm hai việc ở cửa: kiểm tra vé của bạn, và đưa bạn đến chỗ ngồi. Usher làm đúng hai việc đó cho ứng dụng của bạn:
- Xác thực. Người dùng chứng minh họ là ai tại Lobby, trang đăng nhập do Usher lưu trữ, bằng mã khóa, mã gửi qua email, liên kết đăng nhập, tài khoản mạng xã hội hoặc mật khẩu.
- Ủy quyền. Ứng dụng của bạn nhận các token cho biết người đó là ai và họ đã đồng ý chia sẻ những gì, và API của bạn có thể kiểm tra các token đó.
Các thành phần
| Thành phần | Là gì |
|---|---|
| Lobby | Trang đăng nhập được lưu trữ sẵn. Trang luôn nêu tên ứng dụng mà người dùng sắp đến. |
| Tài khoản Usher | Thứ mỗi người sở hữu: email, mã khóa, yếu tố thứ hai và các thiết bị đang đăng nhập. |
| Usher Console | Nơi bạn tạo dự án và môi trường, đăng ký ứng dụng và quản lý người dùng. |
| SDK và thành phần | @usher/nextjs, với <SignIn /> và <UserButton />. Sẽ có khi SDK ra mắt. |
Usher khớp với ứng dụng của bạn như thế nào
Mỗi môi trường bạn tạo là một bên phát hành OpenID Connect riêng, tại một địa chỉ riêng:
Bên phát hành
https://<handle>.usherid.comỨng dụng của bạn đưa người dùng đến bên phát hành đó để đăng nhập, và nhận họ trở lại cùng một mã để đổi lấy token. Đó là luồng mã ủy quyền chuẩn với PKCE, và từng bước của luồng được mô tả trong tài liệu khám phá của bên phát hành:
Tài liệu khám phá
https://<handle>.usherid.com/.well-known/openid-configurationBắt đầu từ đâu
Bắt đầu nhanh: Next.jsThêm đăng nhập vào một ứng dụng Next.js dùng App Router.
Bắt đầu nhanh: thư viện OIDC bất kỳCác thiết lập mà mọi client OpenID Connect cần.
Khái niệmKhông gian làm việc, dự án, môi trường, bên phát hành và token.
Bảo mậtCách các môi trường được giữ tách biệt, và cách thông tin bí mật được niêm phong.