Spring Security

Spring Security Authorization API

The Authorization API from Spring Security — 1 operation(s) for authorization.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.spring.io/spring-security/reference/servlet/oauth2/index.html
📖
Documentation
https://docs.spring.io/spring-authorization-server/docs/current/reference/html/
📖
GettingStarted
https://docs.spring.io/spring-authorization-server/docs/current/reference/html/getting-started.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/spring-security/refs/heads/main/openapi/spring-security-authorization-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/spring-projects/spring-authorization-server

Other Resources

🔗
OAuth2 Client Documentation
https://docs.spring.io/spring-security/reference/servlet/oauth2/client/index.html
🔗
OAuth2 Resource Server
https://docs.spring.io/spring-security/reference/servlet/oauth2/resource-server/index.html
🔗
Authorization Server
https://spring.io/projects/spring-authorization-server

OpenAPI Specification

spring-security-authorization-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Spring Server Authorization API
  description: Spring Authorization Server is a framework providing implementations of OAuth 2.1 and OpenID Connect 1.0 specifications. It exposes standard protocol endpoints for token issuance, token introspection, JWKS publication, device authorization, and OpenID Connect session management.
  version: 1.3.0
  contact:
    name: Spring Security Team
    url: https://spring.io/projects/spring-authorization-server
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost:9000
  description: Default authorization server port
tags:
- name: Authorization
paths:
  /oauth2/authorize:
    get:
      operationId: authorizationRequest
      summary: OAuth2 Authorization Request
      description: Initiates the OAuth 2.1 authorization code flow with PKCE
      tags:
      - Authorization
      parameters:
      - name: response_type
        in: query
        required: true
        schema:
          type: string
          enum:
          - code
      - name: client_id
        in: query
        required: true
        schema:
          type: string
      - name: redirect_uri
        in: query
        schema:
          type: string
          format: uri
      - name: scope
        in: query
        schema:
          type: string
      - name: state
        in: query
        schema:
          type: string
      - name: code_challenge
        in: query
        schema:
          type: string
      - name: code_challenge_method
        in: query
        schema:
          type: string
          enum:
          - S256
      responses:
        '302':
          description: Redirect to login or consent
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT