1장. 기본 인증
HTTP 기본 인증은 웹 리소스에 대한 액세스 제어를 적용하는 최소 리소스 요청 기술 중 하나입니다. HTTP 기본 인증을 사용하여 Quarkus 애플리케이션 끝점을 보호할 수 있습니다. Quarkus에는 기본 인증을 위한 기본 제공 인증 메커니즘이 포함되어 있습니다.
기본 인증은 HTTP 헤더의 필드를 사용하며 HTTP 쿠키, 세션 식별자 또는 로그인 페이지에 의존하지 않습니다.
1.1. 인증 헤더 링크 복사링크가 클립보드에 복사되었습니다!
웹 브라우저와 같은 HTTP 사용자 에이전트는 Authorization 헤더를 사용하여 각 HTTP 요청에 사용자 이름과 암호를 제공합니다. 헤더는 Authorization: Basic <credentials > 로 지정됩니다. 여기서 credentials는 콜론으로 결합된 사용자 ID와 암호의 Base64 인코딩입니다.
예제:
사용자 이름이 Alice 이고 암호가 secret 인 경우 HTTP 인증 헤더는 Authorization: Basic 입니다. 여기서 QWxpY2U6c2U6c2VjcmV0은 QWxpY2U6c2VjcmV0 Alice:secret 문자열의 Base64 인코딩 표현입니다.
기본 인증 메커니즘은 전송된 인증 정보에 대한 기밀성 보호를 제공하지 않습니다. 인증 정보는 전송 시 Base64로 인코딩되며 어떤 방식으로든 암호화되거나 해시되지 않습니다. 따라서 기밀성을 제공하려면 HTTPS로 기본 인증을 사용합니다.
기본 인증은 모든 웹 브라우저와 대부분의 웹 서버에서 이해하는 잘 지정되고 간단한 챌린지 및 응답 체계입니다.
1.2. 기본 인증 사용 제한 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에서는 HTTP 기본 인증을 사용하여 Quarkus 애플리케이션을 보호하는 몇 가지 제한 사항을 간략하게 설명합니다.
| 제한 | 설명 |
|---|---|
| 인증 정보가 일반 텍스트로 전송됨 | 인증 정보가 노출되지 않도록 기본 인증에 HTTPS를 사용합니다. 요청이 HTTP를 통해 Quarkus로 전달되므로 로드 밸런서가 HTTPS를 종료하면 인증 정보를 일반 텍스트로 노출할 위험이 증가합니다. 또한 멀티 홉 배포에서 HTTPS를 클라이언트와 첫 번째 Quarkus 끝점 간에만 사용하고 인증 정보가 HTTP를 통해 다음 Quarkus 엔드포인트로 전파되는 경우 인증 정보를 노출할 수 있습니다. |
| 인증 정보는 각 요청과 함께 전송됨 | 기본 인증에서는 사용자 이름과 암호를 각 요청과 함께 전송하여 인증 정보를 노출할 위험이 높아야 합니다. |
| 애플리케이션 복잡성 증가 | Quarkus 애플리케이션은 사용자 이름, 암호 및 역할이 안전하게 관리되는지 확인해야 합니다. 그러나 이 프로세스에서는 애플리케이션에 상당한 복잡성이 발생할 수 있습니다. 사용 사례에 따라 사용자 이름, 암호 및 역할 관리를 특수 서비스에 위임하는 다른 인증 메커니즘이 더 안전해질 수 있습니다. |
1.3. Quarkus에서 기본 인증 구현 링크 복사링크가 클립보드에 복사되었습니다!
기본 인증을 사용하여 Quarkus 애플리케이션을 보호하는 방법에 대한 자세한 내용은 다음 리소스를 참조하십시오.
1.4. 역할 기반 액세스 제어 링크 복사링크가 클립보드에 복사되었습니다!
Quarkus에는 일반적인 보안 주석 @RolesAllowed,@DenyAll,@PermitAll on REST 엔드포인트 및 CDI 빈을 기반으로 하는 RBAC(역할 기반 액세스 제어)를 허용하는 기본 제공 보안이 포함되어 있습니다. 자세한 내용은 웹 끝점의 Quarkus 권한 부여 가이드를 참조하십시오.
1.5. 프로그래밍 방식으로 기본 인증 설정 링크 복사링크가 클립보드에 복사되었습니다!
io.quarkus.vertx.http.security.HttpSecurity CDI 이벤트를 사용하면 아래 예제와 같이 프로그래밍 방식으로 기본 인증 메커니즘을 구성할 수 있습니다.
package org.acme.http.security;
import io.quarkus.vertx.http.security.HttpSecurity;
import jakarta.enterprise.event.Observes;
public class HttpSecurityConfiguration {
void configure(@Observes HttpSecurity httpSecurity) {
httpSecurity.basic("QuarkusTestRealm");
}
}
- 1
- 기본 인증을 활성화하고
QuarkusTestRealm인증 영역을 사용합니다.
SmallRye OpenAPI 확장을 사용하여 OpenAPI 스키마 문서를 생성하는 경우, quarkus.http.auth.basic 구성 속성을 사용하여 빌드 중에 기본 인증을 활성화해야 합니다.