ASC 2019 - API Specifications Conference

OAuth 2.0 is a key standard of API security. To construct a high security API system, various standards on top of OAuth 2.0 are used, such as PKCE, OpenID Connect and FAPI. Engineers to construct API systems often use a mock of a client application to test the API system. Swagger UI is a frequently used OSS as a mock and is useful because it supports flows of OAuth 2.0 like Authorization Code Grant. However, it doesn’t support specifications such as PKCE and FAPI. It also doesn’t have useful functions for testing like calling endpoints of the authorization server (Token Introspection/Logout/UserInfo/Well-Known Endpoint) and decoding tokens (access/refresh/ID token). In the presentation, we introduce an example of high security API system using Keycloak, and our mock. At last, we discuss requirements to implement those security functions to Swagger UI and API specifications.