기능 추가

보안 및 인증

인증은 모든 보안 시스템의 기본입니다. Lino는 API에서 Bearer 방식을 사용하여 JWT(JSON Web Tokens) 기반 인증을 지원합니다.

일반적인 인증 흐름:

1. 사용자가 로그인 수행(엔드포인트 또는 전용 페이지를 통해).
2. 사용자 정보, 역할 및 권한을 나타내는 claims가 포함된 JWT 발급.
3. 모든 API 요청은 헤더에 토큰 포함: Authorization: Bearer <token>
4. 인증 미들웨어가 토큰을 검증하고 서명과 만료를 확인.

정책 기반 권한 부여

Lino는 세분화된 권한 부여를 위해 정책(Policies)을 사용합니다:

• 각 작업은 특정 정책이 필요할 수 있음(예: People.Read, People.Create).
• 정책은 AddAuthorization을 통해 구성.
• 엔드포인트는 다음을 선언하여 보호 가능: .RequireAuthorization

Lino 프로젝트에 보안 추가

프로젝트에 보안을 추가하려면 다음을 실행:

lino features auth add

CLI 인터랙티브 마법사가 다음 설정을 요청합니다:

• 서비스 – 보안 리소스가 구성될 서비스.
• 모듈 – 보안이 설치될 특정 모듈(모듈형 서비스에만 적용).
• Access Token 수명 – 액세스 토큰의 유효 기간.
• Refresh Token 수명 – 갱신 토큰의 유효 기간.
• 사용자 식별자 유형 – UserId로 사용되는 데이터 유형 정의(int, long 또는 Guid).

이러한 설정은 인증/권한 부여 파이프라인이 자동으로 구성되어 API에서 바로 사용할 수 있으며 Blazor와 통합됩니다.

백그라운드 작업

많은 시스템에서는 다음과 같은 백그라운드 비동기 프로세스를 실행해야 합니다:

• 이메일 전송
• 리포트 생성
• 외부 시스템과의 동기화

Lino는 작업 오케스트레이터로 Hangfire를 기본적으로 지원합니다.

Hangfire의 장점

• 비동기 작업의 안정적인 실행
• 내장 모니터링 대시보드
• 반복 또는 예약 작업 지원
• 데이터베이스에 작업의 안정적인 영속성

Outbox 메시지와 이벤트 통합

비동기 통합의 일관성을 보장하기 위해 Lino는 Outbox Message 패턴을 채택합니다.

비즈니스 작업(예: 주문 생성)을 수행하면, 해당 이벤트(OrderCreated)가 도메인 상태를 저장하는 동일한 트랜잭션에서 Outbox 테이블에 저장됩니다. 백그라운드 프로세서는 Outbox 테이블을 읽고 이벤트를 메시지 시스템(RabbitMQ, Kafka 등)에 게시합니다.

Outbox의 장점:

• 원자성 → 데이터베이스와 게시된 이벤트가 동기화 상태 유지
• 신뢰성 → 실패 시에도 이벤트 손실 없음
• 확장성 → 여러 소비자가 이벤트를 처리 가능

이 모델은 분산 아키텍처에서 안전하고 안정적인 통합을 보장합니다.

이러한 추가 기능을 통해 Lino는 강력한 보안, 세밀한 접근 제어, 신뢰할 수 있는 비동기 처리를 제공하며, 현대 프로덕션 애플리케이션의 핵심 요구사항을 충족합니다.

Lino 프로젝트에 백그라운드 작업 기능 추가

비동기 처리는 알림 전송, 리포트 생성, 이벤트 게시 등 주 요청 흐름을 차단하지 않아야 하는 작업에 필수적입니다.

Lino는 단일 명령으로 백그라운드 작업 지원(라이브러리 사용)을 활성화할 수 있습니다:

lino features background-job add

CLI는 다음 구성 매개변수를 요청합니다:

• 서비스 – 백그라운드 작업 기능이 추가될 서비스
• 라이브러리 – 작업 실행 및 예약을 위한 선택된 라이브러리
• 체크 및 처리 간격 - Outbox 새 메시지를 확인할 큐 검사 간격
• 레코드 수 - 사이클당 처리할 최대 레코드 수, 병렬 처리 및 리소스 소비 제어

이러한 옵션은 시스템을 확장 가능하고 안정적으로 구성하여 백그라운드 작업의 신뢰할 수 있는 실행을 보장합니다.