Bir istemci tarafından yeni bir OAuth2 talep edilmeden önce, Uygulamanın sunucuda kaydedilmesi gerekir.
Yeni bir Uygulama kaydetmek aşağıdaki bilgileri gerektirir:
App Name: Uygulamanın adıdır. Örnek: MyApp
RedirectURI: yanıtların yönlendirileceği yerdir. Örnek: http://127.0.0.1:8080
ClientId: herkese açık bir bilgidir ve istemcinin kimliğidir.
ClientSecret: gizli tutulmalıdır.
İsteğe bağlı olarak aşağıdaki parametreleri ayarlayabilirsiniz:
- ExpiresIn: varsayılan olarak 3600 saniyedir, dolayısıyla token 1 saat içinde sona erer; ihtiyacınız varsa daha büyük bir değer ayarlayabilirsiniz.
- RefreshToken: varsayılan olarak yenileme token'ları desteklenir; istemiyorsanız bu parametreyi false olarak ayarlayın.
Yeni bir istemci OAuth2 kullanarak kimlik doğrulaması yapmak isterse, önce Uygulamanın sunucuda kaydedilmesi gerekir; şunları kullanabilirsiniz:
1. RegisterApp
Bu metot, App Name ve RedirectURI gerektirir ve bir ClientId ile ClientSecret döndürür.
2. Apps.AddApp
Bu metot AppName, RedirectURI, ClientId ve ClientSecret gerektirir. Genellikle bu metodu, bir sunucuda önceden oluşturulmuş bazı Uygulamalar olduğunda ve bunları sunucu başlatılmadan önce yüklemek istediğinizde kullanabilirsiniz.
Her iki metot da aynı işi yapar, Uygulamayı sunucuda kaydeder; ancak birincisi Uygulama ilk kez kaydedildiğinde, ikinci metot ise tüm kayıtlı uygulamaları sunucuyu başlatmadan önce yüklemek istediğinizde (örneğin veritabanında kayıtlı oldukları için) en kullanışlısıdır.