[NEWS] Zarządzanie listą scope’ów aplikacji Allegro / Managing the Allegro application scope list

Na stronie [Zarządzanie aplikacjami Allegro](https://apps.developer.allegro.pl/) **dodaliśmy możliwość wyboru i edycji scope’ów** dla danej aplikacji. Dzięki temu możesz określić, z jakich funkcjonalności Twoja aplikacja będzie korzystać. Domyślnie każda aplikacja dodana przed tą zmianą ma zaznaczone wszystkie uprawnienia. Jeśli w przyszłości wprowadzimy nowy scope, nie dodamy go automatycznie. Sam zdecydujesz, czy Twoja aplikacja powinna z niego korzystać.

Od tego momentu, jeśli podczas generowania tokena:

1. **podasz szerszy zakres niż przy deklaracji** w [Developer Apps](https://apps.developer.allegro.pl/) - aplikacja będzie miała dostęp tylko do tych funkcjonalności, które wcześniej zadeklarowałeś,
2. **nie podasz konkretnych uprawnień** - aplikacja będzie miała dostęp do wszystkich zadeklarowanych funkcjonalności,
3. **podasz węższy zakres** niż zadeklarowałeś dla danej aplikacji - dostaniesz uprawnienie tylko na te funkcjonalności, które podałeś.

**Przykład** - jeśli zadeklarowałeś dla danej aplikacji scope’y A, B, C, D i przy generowaniu tokena:

1. Podasz listę scope’ów A, B, C, D, E - token zawierać będzie zakres A, B, C, D.
2. Gdy nie podasz listy scope’ów - token zawierać będzie zakres A, B, C, D.
3. Podasz listę scope’ów B, C, D - token zawierać będzie zakres B, C, D.

**Jeśli usuniesz uprawnienie**, korzystanie z wybranej funkcji w aplikacji może zostać zablokowane dla nowo wygenerowanych tokenów.

Gdy chcesz, by **Twój token uwzględniał zmiany** (węższy lub szerszy zakres scope’ów), które zrobiłeś w [Developer Apps](https://apps.developer.allegro.pl/), to musisz wygenerować token na nowo użyj refresh tokena lub ponownie przejdź proces autoryzacji. W przypadku, gdy dodasz nowe uprawnienie, wyświetlimy użytkownikowi ekran zgody (consent screen) uwzględniający już nowy scope.

Więcej informacji o scope’ach znajdziesz [w naszym poradniku](https://developer.allegro.pl/auth/#scope-w-api-allegro).

---------------------------

On the [Allegro Application Management website](https://apps.developer.allegro.pl/), **we have added the option to select and edit the scopes** of a given application. Thanks to this, you can define which functionalities your application will use. By default, any application added before this change has all permissions checked. If we introduce a new scope in the future, we will not add it automatically. You decide for yourself whether your application should use it.

From that moment on, if during token generation:

1. **you give a wider range** than you declared in the [Developer Apps](https://apps.developer.allegro.pl/) - the application will only have access to the functionalities that you previously declared,
2. **you do not provide specific permissions** - the application will have access to all declared functionalities,
3. **you provide a narrower range** than you declared for a given application - you will only get permission for the functionalities that you have provided.

**Example** - if you have declared A, B, C, D scope for a given application and when generating the token:

1. You will provide a list of A, B, C, D, E scope - the token will contain the scope A, B, C, D.
2. When you do not provide the list of scope - the token will contain the scope A, B, C, D.
3. You will provide a list of scope B, C, D - the token will contain the scope B, C, D.

**If you remove the permission**, the use of the selected function in the application may be blocked for newly generated tokens.

When you want **your token to take into account the changes** (narrower or wider scopes) that you have made in [Developer Apps](https://apps.developer.allegro.pl/), you need to generate the new token using the refresh token or by repeating the authorization process. In case you add a new permission, we will show the user a consent screen that already includes the new scope.

More information about the scope can be found in [our guide](https://developer.allegro.pl/en/auth/#scope-in-the-allegro-api).