Zanim klient wystąpi o nowy token OAuth2, aplikacja musi być zarejestrowana w serwerze.
Register a new App requires the following information:
App Name: is the name of the Application. Example: MyApp
RedirectURI: is where the responses will be redirected. Example: http://127.0.0.1:8080
ClientId: is public information and is the ID of the client.
ClientSecret: must be kept confidential.
Opcjonalnie możesz ustawić następujące parametry:
- ExpiresIn: domyślnie 3600 sekund, co oznacza, że token wygaśnie po godzinie; możesz ustawić większą wartość, jeśli potrzebujesz.
- RefreshToken: domyślnie tokeny odświeżania są obsługiwane; jeśli nie chcesz, ustaw ten parametr na false.
Jeśli nowy klient chce uwierzytelnić się przez OAuth2, aplikacja musi najpierw zostać zarejestrowana w serwerze. Możesz użyć:
1. RegisterApp
Ta metoda wymaga nazwy aplikacji i RedirectURI i zwróci ClientId oraz ClientSecret.
2. Apps.AddApp
Ta metoda wymaga AppName, RedirectURI, ClientId i ClientSecret. Zazwyczaj używasz jej, gdy serwer ma już zarejestrowane aplikacje i chcesz je załadować przed uruchomieniem.
Obie metody robią to samo — rejestrują aplikację w serwerze, ale pierwsza jest najczęściej używana przy pierwszej rejestracji aplikacji, a druga — gdy chcesz załadować wszystkie zarejestrowane aplikacje przed uruchomieniem serwera (np. zapisane w bazie danych).