OAuth 2.0 uygulama kaydı

OAuth 2.0 uygulamanızı kaydetmek, onun Roblox kaynaklarına erişmesini sağlar. Kayıttan sonra, Roblox uygulamaya kullanıcıların Roblox bilgilerine ve kaynaklarına erişim izni almak için kullanabileceğiniz benzersiz bir istemci kimliği ve gizli anahtar atar.

Uygulamanızı kaydedin

Bir uygulamayı kaydetmek için:

1. Yaratıcı Kontrol Paneli'ne gidin, OAuth 2.0 Uygulamaları sayfasına gidin.
2. Uygulama Oluştur butonuna tıklayın.
3. Geçerli ve küresel olarak benzersiz bir Uygulama Adı girin.
4. Roblox Hizmet Şartları'nı okuyun ve kabul edin, ardından Oluştur butonuna tıklayın.
5. İstemci Kimliği ve Gizli Anahtar'ı güvenli bir yerde kopyalayın ve saklayın. Sayfayı kapattıktan sonra, gizli anahtara erişiminiz kalmaz ve yalnızca yeni bir tane oluşturabilirsiniz. Bir uygulamayı kaydettikten sonra, uygulamanın diğer özelliklerine erişmeye ve düzenlemeye devam edebilirsiniz.
6. Uygulamanızı yapılandırmak için Düzenlemeye Devam Et butonuna tıklayın; bu, aşağıdaki bölümlerde açıklanmıştır.

Genel bilgileri yapılandırın

Uygulamanızı kaydettiğinizde, genel bilgilerini yapılandırmalısınız; bunlar arasında:

• Roblox topluluğundaki herkesin görebileceği bir açıklama.
• Uygulamanız için bir küçük resim. Önerilen dosya boyutu en az 150x150 piksel.
• Uygulamanızın giriş noktası olarak bir Giriş Bağlantısı, örneğin uygulamanızın web sitesi ana sayfası.
• Kullanıcıların uygulamanızı yetkilendirmeden önce okuyabilecekleri bir Gizlilik Şartları URL'si ve bir Hizmet Şartları URL'si. Her URL HTTPS olmalı ve en fazla 256 karakter olmalıdır.

İzinleri ekleyin

Uygulamanızda uygun erişim kontrolü ve güvenliği sağlamak için İzin Kapsamları eklemelisiniz. İki tür izin kapsamı mevcuttur:

• Kimlik doğrulama için Kimlik Kapsamları, örneğin kullanıcı kimlikleri için openid ve tam profiller için profile. profile kapsamını seçerseniz, openid kapsamını da seçmelisiniz.
• Belirli API'ler için API'ye özgü izin kapsamları, örneğin varlıkların okuma izni için asset:read. Uygulamanız için ihtiyaç duyduğunuz minimum kapsam sayısını seçin.

Yönlendirme URL'leri ekleyin

Yönlendirme URL'leri, kullanıcıların uygulamanızı yetkilendirdikten sonra yönlendirildiği yeniden giriş noktalarıdır. Yönlendirme URL'lerinizin aşağıdaki gereksinimleri karşıladığından emin olun:

• Tüm yönlendirme URL'leri aşağıdaki formlardan birinde olmalıdır:

  • Düz HTTPS, örneğin: https://www.example.com.`
  • Yerel hata ayıklama amaçları için HTTP veya HTTPS (kendinden imzalı sertifika) ile localhost üzerindeki yollar, örneğin:

    • http://localhost:80
    • https://localhost:80
  • Belirli uygulamalar veya amaçlar için özel şemalar, örneğin:

    • my-app-scheme:/
    • my-app-scheme://foo/bar/...
    • my-app://action?param1=value1&param2=value2
• Bir yönlendirme URL'sinin maksimum uzunluğu 256 karakterdir.
• En fazla 10 yönlendirme URL'si ekleyebilirsiniz. Birden fazla yönlendirme URL'si ile test ortamları oluşturabilir ve kullanıcıların iki site arasında kesinti olmadan geçiş yapmalarını sağlayabilirsiniz.

İnceleme için gönderin

Kötü niyetli uygulamaların topluluğa zarar verme olasılığını en aza indirmek için, bir uygulama kaydetmek onu geniş bir şekilde erişilebilir hale getirmez. Bunun yerine, 10 benzersiz kullanıcı ile sınırlı özel modda kalır. Bu mod, ekibiniz içinde test ve hata ayıklama için faydalıdır.

Uygulamanızın kullanıcı tabanını genişletmek istiyorsanız, inceleme için göndererek kamu modunda yayınlamanız gerekir:

1. OAuth 2.0 uygulamaları sayfasına gidin.
2. Yayınlamak istediğiniz uygulama için Düzenle ve Yayınla butonuna tıklayın.
3. Gerekli tüm bilgileri doldurun, demo videosu ve açıklama dahil, ardından İnceleme ve Yayınla butonuna tıklayın. Bekleyen inceleme süresi boyunca uygulama izinlerinizle ilgili sınırlamaları belirten bir mesaj görünür.
4. İnceleme için Gönder butonuna tıklayın.

Gönderiminiz için aşağıdaki bilgiler gereklidir:

• 1 dakikadan uzun olmayan ve aşağıdaki gereksinimleri karşılayan bir kamu Demo Video bağlantısı:

  • Kullanıcının oturum kapalı olduğu bir başlangıç ile başlar ve OAuth onay penceresini tetikleyen tam kullanıcı eylemini, örneğin Roblox ile Giriş Yap butonuna tıklamayı gösterir. Video, yönlendirme ile uygulamanıza geri dönerken tüm yetkilendirme akışını göstermelidir; yönlendirmeden sonra orijinal uygulamanızdaki içeriği de içermelidir.
  • Gönderiminizle sağladığınız aynı kayıt detaylarını gösterir.
• Uygulamanızın seçilen kategoride neden yer aldığını ve talep edilen izin kapsamlarını nasıl kullandığını açıklayan bir gerekçe.

Uygulama incelemeniz beklemede iken, mevcut inceleme talebiniz onaylanana veya reddedilene kadar başka bir talep edemez veya düzenleyemezsiniz. Uygulamanız inceleme sırasında özel modda kalır. Uygulamanız onaylandığında, kamu moduna geçer ve geri özel moda döndüremezsiniz.

Uygulamanız onaylansın veya reddedilsin, inceleme tamamlandığında sonucu bildiren bir e-posta bildirimi alırsınız.

Uygulamanızı düzenleyin ve silin

Uygulamanız inceleme altında değilse, aşağıdaki adımlarla uygulamanızı düzenleyebilir veya silebilirsiniz:

1. OAuth 2.0 uygulamaları sayfasına gidin.

2. İstediğiniz uygulama için Düzenle veya Sil butonuna tıklayın.

   • Bir uygulamayı düzenlemeyi seçtiyseniz, kayıt adımlarını ve gereksinimlerini izleyin.
   • Bir uygulamayı silmeyi seçtiyseniz, silmeyi onaylamak için Evet, Sil butonuna tıklayın. Bir uygulamayı sildikten sonra, onu geri almanız mümkün değildir.

Uygulamanızın genel bilgilerini veya yönlendirme URL'lerini değiştirmek, kullanıcıların uygulamayı yeniden yetkilendirmesini gerektirmez. Ancak, izin kapsamlarını ekler veya değiştirirseniz, yeni izinler için kullanıcılarınızdan yetkilendirme almanız ve yeni bir token seti edinmeniz gerekir. Yeni kapsamlar için yetkilendirme almazsanız, uygulamanız mevcut token'ları kullanmaya devam edebilir, ancak önceki kapsamlarla sınırlı kalır.

Özel modda olan uygulamalar için sistem, düzenlemelerinizi kullanıcılarınızla otomatik olarak günceller. Kamu modundaki uygulamalar için, bu değişiklikleri yansıtmak için uygulamayı tekrar inceleme için gönderin. Aksi takdirde, sistem, yayımlanmamış değişiklikleri sizin için kaydeder, ancak bunları topluluğa sunmaz.