1장. OpenAPI 서비스에 대한 인증

서버리스 논리에서는 OpenAPI 사양 파일에 정의된 보안 스키마를 사용하여 OpenAPI 서비스 작업을 보호할 수 있습니다. 이러한 체계는 워크플로우 내에서 호출되는 작업에 대한 인증 요구 사항을 정의하는 데 도움이 됩니다.

보안 체계는 OpenAPI 문서의 securitySchemes 섹션에 선언됩니다. 각 스키마는 HTTP Basic, API 키 등과 같이 적용할 인증 유형을 지정합니다.

워크플로우에서 보안 작업을 호출할 때 이러한 정의된 체계를 참조하여 필요한 인증 구성을 확인합니다.

"securitySchemes": {
  "http-basic-example": {
    "type": "http",
    "scheme": "basic"
  },
  "api-key-example": {
    "type": "apiKey",
    "name": "my-example-key",
    "in": "header"
  }
}

OpenAPI 파일에서 보안 스키마를 정의하지만 작업에 대한 보안 요구 사항이 포함되지 않은 경우 기본적으로 생성기를 구성하여 생성할 수 있습니다. 이러한 기본값은 명시적으로 정의된 요구 사항 없이 작업에 적용됩니다.

해당 스키마를 구성하려면 quarkus.openapi-generator.codegen.default-security-scheme 속성을 사용해야 합니다. default-security-scheme 속성은 런타임이 아닌 코드 생성 시에만 사용됩니다. 이 값은 http-basic-example 또는 api-key-example:과 같은 securitySchemes 섹션에서 사용 가능한 모든 체계와 일치해야 합니다.

$ quarkus.openapi-generator.codegen.default-security-scheme=http-basic-example