Swagger-Editor und Session-Cookies

Question

Nach this document, konnte ich verwenden:

components: 
    securitySchemes: 
    cookieAuth: 
     type: apiKey 
     in: cookie 
     name: JSESSIONID 

Um ein session cookie zu definieren. Aber wenn Sie zu the editor gehen Linie 577 in: "header"-in: "cookie" zu ändern, tadelt der Editor mit:

Schema Fehler bei securityDefinitions['api_key'].in sollte einen der zulässigen Werte AllowedValues ​​gleich: header, query.

Wie muss ich eine Session-Cookie-basierte Authentifizierung definieren?

Answer 1

Die Cookie-Authentifizierung ist eine OpenAPI 3.0-Funktion und wird in OpenAPI 2.0 nicht unterstützt. Ihre Spezifikation ist OpenAPI 2.0, wie von securityDefinitions angezeigt. Sie können die 2.0- und 3.0-Syntax nicht mischen. Sie müssen Ihre Spezifikation umschreiben oder in das OpenAPI 3.0-Format konvertieren.

Das heißt, Swagger Editor und Swagger UI unterstützen derzeit nicht die Autorize-Funktion für OpenAPI 3.0-Spezifikationen. Überprüfen Sie die OAS 3.0 Support Backlog für Updates.