İçeriğe geç
Belgeler · Tanıtım

Tanıtım

Usher bir kimlik sağlayıcısıdır: insanların uygulamalarınıza girişini sağlar, hesaplarını güvende tutar ve uygulamanıza onların kim olduğunu söyler. Bunların hepsini OpenID Connect ve OAuth 2.1 ile yapar; bu yüzden zaten kullandığınız kütüphanelerle çalışır.

Usher ne yapar?

Usher, İngilizcede “yer gösterici” demektir ve bir yer gösterici kapıda iki iş yapar: biletinizi kontrol eder ve sizi yerinize götürür. Usher da uygulamanız için aynı iki işi yapar:

  • Kimlik doğrulama. İnsanlar kim olduklarını, Usher’ın barındırdığı giriş sayfası olan Lobby’de kanıtlar: geçiş anahtarıyla, e-postayla gönderilen kodla, sihirli bağlantıyla, sosyal hesapla ya da parolayla.
  • Yetkilendirme. Uygulamanız, kişinin kim olduğunu ve neyi paylaşmayı kabul ettiğini söyleyen belirteçler alır; API’niz de bunları denetleyebilir.

Parçalar

ParçaNedir?
LobbyBarındırılan giriş sayfası. Kişinin gittiği uygulamayı her zaman adıyla söyler.
Usher hesabıBir kişinin sahip olduğu şey: e-postası, geçiş anahtarları, ikinci faktörleri ve giriş yapılmış aygıtları.
Usher ConsoleProje ve ortam oluşturduğunuz, uygulama kaydettiğiniz ve kullanıcıları yönettiğiniz yer.
SDK ve bileşenler<SignIn /> ve <UserButton /> ile birlikte @usher/nextjs. SDK ile geliyor.

Uygulamanıza nasıl yerleşir?

Oluşturduğunuz her ortam, kendine ait bir adreste ayrı bir OpenID Connect yayıncısıdır:

Yayıncı
https://<handle>.usherid.com

Uygulamanız insanları giriş yapmaları için bu yayıncıya gönderir ve onları, belirteçlerle değiştireceği bir kodla geri alır. Bu, PKCE ile standart yetkilendirme kodu akışıdır ve her adımı yayıncının keşif belgesinde tanımlanır:

Keşif belgesi
https://<handle>.usherid.com/.well-known/openid-configuration

Nereden başlamalı?