# Проектирование безопасности API

В рамках процесса проектирования API необходимо указать, какие потребители могут получать доступ к вашему API (аутентификация) и какие действия им разрешено выполнять (авторизация).

Вы можете просто определить общие параметры безопасности для всего API или выбрать более детальную политику с особыми параметрами безопасности для критически важного ресурса.

Возможно, вы также захотите указать, что определенные операции свободно доступны без аутентификации.

Контракты API могут обрабатывать все эти случаи с помощью основных типов безопасности:

* Базовая аутентификация
* Аутентификация Bearer
* Дайджест-аутентификация
* OAuth 1.0
* OAuth 2.0
* OpenID Connect
* Пользовательский / ключ API
* Сквозная передача

Аутентификация с помощью файлов cookie не поддерживается.

## Создание схемы безопасности

Создайте схему безопасности, которая будет использоваться глобально в вашей версии API или в отдельных элементах.

1. Перейдите на страницу общей информации вашего API.
2. Прокрутите страницу вниз до раздела Схемы безопасности и нажмите Добавить, чтобы создать новую схему.
3. Введите Имя и выберите Тип в раскрывающемся списке.
4. Необязательно: Введите описание.
5. Введите другие параметры, специфичные для выбранного типа.

   ![Пример определения схемы безопасности.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/shows_OAuth2_security_scheme.png)

Ваша схема безопасности создана, теперь вы можете использовать ее в глобальных настройках вашего API или в конкретных ресурсах и операциях.

## Определение безопасности вашего API

Определите схемы безопасности для вашего API, ресурсов и операций.

1. Перейдите на страницу общей информации вашего API.
2. В разделе Глобальная безопасность добавьте свои схемы безопасности и выберите те, которые вы хотите применить глобально к своей версии API.

   ![В этом примере API Petstore защищен с помощью petstore_auth с областью действия write:pets.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/designer_security.png)
3. Выберите ресурс и укажите схемы безопасности, которые вы хотите применить ко всем операциям своего ресурса.

   Кроме того, вы можете выбрать операцию, чтобы настроить для нее индивидуальные параметры безопасности. ![В этом примере метод Find Pets by tags защищен с помощью petstore_auth.](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/designer_security_2.png)