HandyCafe Docs
owner it-admin

OAuth Ayarları

OAuth Ayarları kategorisi, cihaz akışı kimlik doğrulamasını yapılandırır ve üyelerin mevcut sosyal hesaplarını kullanarak istemci bilgisayarlara giriş yapmalarını sağlar. Bu, kullanıcıların kimlik bilgilerini paylaşılan bir bilgisayarda yazmak yerine ayrı bir cihazda (telefonları) kimlik doğrulaması yaptığı kiosk ve halka açık ortam senaryoları için tasarlanmış olan Cihaz Yetkilendirme İzni'ni (RFC 8628) uygular.

Ana Anahtar

OAuth Girişini Etkinleştir anahtarı, tüm OAuth sistemini kontrol eder. Devre dışı bırakıldığında, istemci kilit ekranlarında OAuth giriş seçeneği görünmez. Etkinleştirildiğinde, yapılandırılmış sağlayıcılar üye girişi için kullanılabilir hale gelir.

Kafe Adı

OAuth kimlik doğrulama bağlamında gösterilen kafenizin bir görüntüleme adı. Üyelerin telefonlarında yetkilendirme istemini gördüklerinde doğru işletmeye giriş yaptıklarını doğrulamalarına yardımcı olur.

Kredisi Olmadan Girişe İzin Ver

Etkinleştirildiğinde, üyeler cüzdan bakiyeleri sıfır olsa bile OAuth üzerinden giriş yapabilir. Bu, ücretsiz gezinmeye izin vermek isteyen kafeler veya üyelerin ön ödemeli kredi yerine kasada ödeme yaptığı yerler için kullanışlıdır.

Devre dışı bırakıldığında, üyelerin OAuth girişini tamamlamak için pozitif bir cüzdan bakiyesine sahip olmaları gerekir.

Sağlayıcı Yapılandırması

HandyCafe beş OAuth sağlayıcısını destekler. Her sağlayıcı bağımsız olarak yapılandırılır:

Google

Alan Açıklama
Etkinleştirme anahtarı Google girişini aç veya kapat
İstemci Kimliği Google Cloud Console projenizden OAuth 2.0 İstemci Kimliği
İstemci Sırrı Karşılık gelen istemci sırrı
JSON içe aktarma İstemci Kimliği ve İstemci Sırrı alanlarını otomatik doldurmak için Google formatında bir kimlik bilgileri JSON dosyası yükleyin

Facebook

Alan Açıklama
Etkinleştirme anahtarı Facebook girişini aç veya kapat
İstemci Kimliği Facebook Geliştirici uygulamanızdan Uygulama Kimliği
İstemci Sırrı Facebook Geliştirici uygulamanızdan Uygulama Sırrı

Apple

Alan Açıklama
Etkinleştirme anahtarı Apple girişini aç veya kapat
İstemci Kimliği Apple Geliştirici hesabınızdan Hizmetler Kimliği
İstemci Sırrı Oluşturulan istemci sırrı (JWT tabanlı)

X (Twitter)

Alan Açıklama
Etkinleştirme anahtarı X girişini aç veya kapat
İstemci Kimliği X Geliştirici Portalı'ndan OAuth 2.0 İstemci Kimliği
İstemci Sırrı Karşılık gelen istemci sırrı

Discord

Alan Açıklama
Etkinleştirme anahtarı Discord girişini aç veya kapat
İstemci Kimliği Discord Geliştirici Portalı'ndan Uygulama Kimliği
İstemci Sırrı Karşılık gelen istemci sırrı

Sağlayıcıyı Ayarlama

  1. Sağlayıcının platformunda bir geliştirici uygulaması oluşturun (yapılandırma alanlarının yanında her sağlayıcının geliştirici konsoluna bağlantılar mevcuttur).
  2. Uygulamayı, uygulanabilir olduğunda Cihaz Yetkilendirme İzni akışı için yapılandırın.
  3. İstemci Kimliği ve İstemci Sırrı'nı HandyCafe'deki ilgili alanlara kopyalayın.
  4. Sağlayıcı anahtarını etkinleştirin.
  5. Ayarları kaydedin.

Özellikle Google için, Google Cloud Console'dan kimlik bilgileri JSON'unu dışa aktarabilir ve her iki alanı otomatik doldurmak için JSON içe aktarma düğmesini kullanabilirsiniz.

Yapılandırmayı Test Etme

OAuth ayarlarınızı kaydettikten sonra:

  1. Sunucuya bağlı bir istemci bilgisayara gidin.
  2. İstemci kilit ekranında OAuth giriş seçeneğini arayın.
  3. Yapılandırılmış bir sağlayıcı seçin ve giriş işlemini başlatın.
  4. İstemci ekranında bir cihaz kodu ve QR kodu görünecektir.
  5. Telefonunuzla QR kodunu tarayın veya görüntülenen URL'yi ziyaret edip kodu girin.
  6. Telefonunuzda kimlik doğrulamasını tamamlayın.
  7. Sunucu, belirteci almak için sorgular ve yapılandırmanıza bağlı olarak ya girişi otomatik onaylar ya da onay için yöneticiye bir istek gönderir.
  8. Onaylandıktan sonra, üye hesabı oluşturulur veya bağlanır ve istemci oturumu başlar.

Tam cihaz akışı giriş süreci için OAuth Giriş belgelerine bakın.