Для определения аутентификации в спецификации OpenAPI 2.0 используются два ключевых слова:
securityDefinitions
security
securityDefinitions
описывает тип защиты (например, Basic, API-ключ и т. Д.), А security
применяет его ко всем или отдельным операциям. Без security
, securityDefinitions
не имеет никакого эффекта.
Если все операции используют обычную аутентификацию, примените security
на корневом уровне:
{
"swagger": "2.0",
"securityDefinitions": {
"basicAuth": {
"type": "basic"
}
},
"security": [
{
"basicAuth": []
}
],
...
}
Если в конкретной операции используется базовая аутентификация, примените security
к этой конкретной операции:
{
"swagger": "2.0",
"securityDefinitions": {
"basicAuth": {
"type": "basic"
}
},
"paths": {
"/foo": {
"get": {
"security": [
{
"basicAuth": []
}
],
...
}
}
},
...
}
Дополнительная информация: Базовая аутентификация (OpenAPI 2.0)