OAuth 2.0 uygulama kaydı

OAuth 2.0 uygulamanızı kaydetmek, ona Roblox kaynaklarına erişim sağlar. Kayıt sonrasında, Roblox uygulamanıza kullanıcıların Roblox bilgilerine ve kaynaklarına erişim izni almak için kullanabileceğiniz eşsiz bir istemci kimliği ve gizli anahtar atar.

Uygulamanızı kaydedin

Bir uygulama kaydetmek için:

1. Creator Dashboard sayfasına gidin, ardından 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 ve Oluştur butonuna tıklayın.
5. İstemci Kimliği ve Gizli Anahtar'ı güvenli bir yere kopyalayın ve saklayın. Sayfayı kapattıktan sonra gizli anahtara erişiminiz kalmaz ve sadece yenisini oluşturabilirsiniz. Bir uygulamayı kaydetmeyi tamamladıktan 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. Bu bilgiler şunları içerir:

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

İzinleri ekleyin

Uygulamanızda doğru 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. Eğer profile kapsamını seçerseniz, openid kapsamını da seçmeniz gerekir.
• Belirli API'ler için izin kapsamları, örneğin, varlıkların okuma izni için asset:read. Uygulamanız için yalnızca ihtiyaç duyduğunuz en az sayıda kapsamı 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 şekillerden 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 imzalanmış 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ınız olabilir ve kullanıcıların iki site arasında kesinti olmadan geçiş yapmasını sağlayabilirsiniz.

İnceleme için gönderin

Kötü amaçlı uygulamaların topluluğa zarar verme şansını minimize etmek için, bir uygulama kaydetmek geniş bir erişilebilirlik sağlamaz. Bunun yerine, uygulama özel modda kalır ve 10 benzersiz kullanıcı ile sınırlıdı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 uygulamanın Düzenle ve Yayınla butonuna tıklayın.
3. Tüm gerekli bilgileri doldurun ve İnceleme ve Yayınla butonuna tıklayın. Beklemedeki inceleme süresi boyunca uygulama izinlerinizdeki sınırlamalarla ilgili bir mesaj görünür.
4. İnceleme için Gönder butonuna tıklayın.

Uygulama incelemeniz beklerken, geçerli inceleme isteği onaylanana veya reddedilene kadar başka bir isteği düzenleyemez veya gönderemezsiniz. Uygulamanız inceleme sırasında özel modda kalır. Uygulamanız onaylandığında, kamu moduna geçer ve geri özel moda dönemezsiniz.

Uygulamanız onaylansa da reddedilse de, 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ımlar ile 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 ile aynı adımları ve gereksinimleri izleyin.
   • Bir uygulamayı silmeyi seçtiyseniz, silmeyi onaylamak için Evet, Sil butonuna tıklayın. Bir uygulamayı sildiğinizde, 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 gerektirmemektedir. Ancak, izin kapsamlarını ekler veya değiştirirseniz, yeni izinleri almak için kullanıcılardan yetki almalı ve yeni bir token seti edinmelisiniz. Yeni kapsamlar için yetki almazsanız, uygulamanız mevcut tokenları kullanmaya devam edebilir, ancak önceki kapsamlarla sınırlı olursunuz.

Özel modda olan uygulamalar için sistem değişikliklerinizi otomatik olarak kullanıcılarınıza günceller. Kamu modundaki uygulamalar için ise, bu değişikliklerin yansıması için uygulamayı tekrar inceleme için göndermeniz gerekir. Aksi takdirde, sistem değişiklikleri topluluğa yayınlamadan kaydeder.