IT LAB

[Spring Security] 8-1. OAuth2 Resource Server

noahkim_ — Fri, 15 May 2026 18:00:55 +0900

1. OAuth2 Resource Server

보호된 자원을 관리하는 서버
✅ 보호된 자원의 요청에 대한 인증 과정을 담당함

Protect Access with an OAuth2 Access Token

구분	설명	검증
JWT	자체 서명 토큰	public key 사용
Opaque Token	토큰 내용을 알 수 없는 토큰	인정 서버의 introspection 엔드포인트에 확인 요청

설정) JWT

spring:
  security:
    oauth2:
      resourceserver:
        jwt:
          issuer-uri: https://my-auth-server.com

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth.anyRequest().authenticated())
            .oauth2ResourceServer(oauth2 -> oauth2.jwt());
            
        return http.build();
    }

    @Bean
    public JwtDecoder jwtDecoder() {
        return JwtDecoders.fromIssuerLocation("https://my-auth-server.com");
    }
}

설정) Opaque Token

spring:
  security:
    oauth2:
      resourceserver:
        opaquetoken:
          introspection-uri: https://my-auth-server.com/oauth2/introspect
          client-id: my-client-id
          client-secret: my-client-secret

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth.anyRequest().authenticated())
            .oauth2ResourceServer(oauth2 -> oauth2.opaqueToken());
        
        return http.build();
    }

    @Bean
    public OpaqueTokenIntrospector opaqueTokenIntrospector() {
        return new SpringOpaqueTokenIntrospector(
            "https://my-auth-server.com/oauth2/introspect",
            "my-client-id",
            "my-client-secret");
    }
}

Protect Access with a custom JWT

발급된 Access Token을 검증하는 방법
✅ BearerTokenAuthenticationFilter + JwtAuthenticationProvider (NimbusJwtDecoder)

설정) Custom Access Token 검증

spring:
  security:
    oauth2:
      resourceserver:
        jwt:
          public-key-location: classpath:my-public-key.pub

공개키만 등록하면 됨 (NimbusJwtDecoder)

[gRPC] Status Codes

noahkim_ — Fri, 17 Apr 2026 23:38:32 +0900

1. Status Code

gRPC 호출은 마지막에 status 하나를 클라이언트에게 돌려줌
보통 code, description으로 구성됨

2. 자주 쓰이는 코드

코드	의미	생성주체	재시도 관점	예시
OK	성공	서버/라이브러리	재시도 불필요	정상 저장
CANCELLED	호출 취소	주로 호출자/서버 컨텍스트	보통 자동 재시도 아님	클라이언트 취소, 서버에서 cancel 감지
DEADLINE_EXCEEDED	정해진 시간 안에 응답 못 받음	라이브러리에서 자주 생성	상황 따라 가능	3.5초 deadline 초과
INVALID_ARGUMENT	입력값 자체가 잘못됨	애플리케이션이 직접	같은 요청 재시도 의미 없음	빈 content, 잘못된 roomId 형식
NOT_FOUND	대상 없음	애플리케이션이 직접	상태 바뀌기 전엔 의미 없음	채팅방 없음
ALREADY_EXISTS	이미 존재함	애플리케이션이 직접	보통 의미 없음	같은 메시지 중복 생성
FAILED_PRECONDITION	현재 상태상 실행 불가	애플리케이션이 직접	상태 수정 전 재시도 의미 없음	이미 나간 유저가 전송
ABORTED	동시성 충돌/트랜잭션 중단	애플리케이션이 직접	상위 작업 재시도 후보	낙관적 락 충돌
RESOURCE_EXHAUSTED	리소스 부족	라이브러리/애플리케이션 둘 다 가능	보통 백오프 후 가능	quota 초과, 큐 포화
UNIMPLEMENTED	미구현/미지원	라이브러리/서버	재시도 의미 없음	없는 RPC 호출
INTERNAL	내부 오류	라이브러리/서버	보통 바로 재시도 비추천	직렬화/불변식 깨짐
UNAVAILABLE	현재 서비스 사용 불가	라이브러리에서 자주 생성	백오프 후 재시도 후보	서버 다운, 연결 실패
UNAUTHENTICATED	인증 실패	라이브러리/애플리케이션	자격 증명 수정 후	토큰 없음/유효하지 않음
PERMISSION_DENIED	권한 없음	애플리케이션	권한 없으면 의미 없음	해당 방 쓰기 권한 없음
UNKNOWN	알 수 없는 오류	라이브러리/서버	상황 따라 다름	예외가 애매하게 변환됨

출처

gRPC - Status Codes

[gRPC] Deadlines

noahkim_ — Fri, 17 Apr 2026 22:44:16 +0900

1. Deadline

클라이언트가 "이 시각 이후에는 더 이상 응답을 기다리지 않겠다" 라고 정하는 시간
✅클라이언트는 이 시각이 넘으면 호출을 포기하고 실패로 간주함

필요성

분산 시스템에서는 서버가 느려지거나 네트워크가 밀림으로 인한 지연이 발생할 수 있음
⚠️ 만약 deadline이 없다면, 클라이언트가 계속 대기하게 되어 지연이 전체 시스템에 전파될 수 있음

2. Client

DEADLINE_EXCEEDED 상태

deadline 초과 시, 클라이언트가 호출에 대해 받는 상태

3. Server

CANCELLED 상태

서버에서 작업 중 deadline 시간을 초과할 경우, 계속 하던 작업을 자동 취소함
✅ 단, 작업중인 것은 롤백하는 코드를 작성해줘야 함

4. Propagation

gRPC 요청이 체이닝 형식일 경우, 뒤에 받는 요청의 deadline은 앞 요청의 deadline으로부터 남은 시간으로 전파됨

출처

gRPC - Deadlines

[Tomcat 11] 1. Architecture

noahkim_ — Thu, 16 Apr 2026 02:24:33 +0900

1. Architecture

Tomcat Server
└── Service
    ├── Connector (HTTP / AJP)   ← 요청을 받는 입구
    └── Engine                   ← 요청 처리 총괄
        ├── Host (www.site.com)
        │   ├── Context (/)      
        │   ├── Context (/chat)
        │   └── Context (/admin)
        └── Host (api.site.com)
            ├── Context (/)
            └── Context (/v1)

구성 요소	정의	역할
Server	톰캣의 전체 인스턴스이자 최상위 컨테이너	여러 Service를 담고 전체 서버를 관리함
Service	Connector와 Engine을 묶는 중간 단위	특정 통신 입구들과 실제 처리 엔진을 연결함
Connector	클라이언트와 통신하는 입구	HTTP/AJP 요청을 받아 톰캣 내부로 전달하고, 처리된 응답을 다시 클라이언트에 반환함
Engine	요청을 실제 처리 파이프라인으로 넘기는 중심 처리부	여러 Connector에서 들어온 요청을 받아 내부 처리 흐름으로 전달함
Host	도메인 단위를 톰캣 내부에서 구분하는 가상 호스트	어떤 도메인 요청인지 구분해 알맞은 웹앱 영역으로 연결함
Context	웹 애플리케이션 하나	실제 실행되는 개별 웹앱을 의미함

2. Request Process

Endpoint

apache tomcat 11 architecture

Acceptor: 연결 받음
Poller: 연결이 읽을 준비가 되었는지 확인. 처리 시점이 되면 작업 단위 생성 (SocketProcessor)
Executor(Worker): 작업을 thread pool에 제출
Worker Thread: pool안의 스레드가 작업 수행
Processor: HTTP 요청 파싱/처리 시작

출처

Tomcat - Architecture

[Tomcat 11] 2. Connector

noahkim_ — Wed, 15 Apr 2026 20:58:30 +0900

1. HTTP 1.1 Connector

특정 TCP 포트에서 연결을 받아서, 요청을 처리를 하게 하는 입구 (Engine으로 넘겨 처리함)
non-async 요청 1개당 worker thread 1개를 처리 동안 점유함

2. Attributes

Common Attributes

속성	설명	의미
protocol	어떤 HTTP connector 구현을 사용할지 정하는 설정	현재 톰캣이 NIO 기반으로 동작하는지 이해하는 기준
asyncTimeout	비동기 요청의 기본 timeout 시간	async 요청이 오래 걸릴 때 timeout 원인 해석 가능
maxParameterCount	요청에서 허용할 최대 파라미터 개수	파라미터 폭주나 비정상 요청으로부터 서버 보호
maxPartCount	multipart 요청에서 허용할 최대 part 개수	파일 업로드 요청이 메모리를 과하게 쓰는 상황 방지
maxPostSize	파라미터로 변환될 POST body의 최대 크기	과도하게 큰 요청 본문 제한
port	Connector가 연결을 기다리는 TCP 포트 번호	어떤 포트가 현재 요청 입구인지 식별 가능

Standard Implementation

속성	설명	의미
maxThreads	동시에 요청을 처리할 worker thread 최대 수	동시 요청 처리 상한을 결정
maxConnections	동시에 받아들여 유지할 수 있는 연결 최대 수	thread가 부족해도 Tomcat이 붙잡아둘 수 있는 연결 상한
acceptCount	maxConnections를 넘었을 때 OS backlog queue에서 대기 가능한 연결 수	과부하 시 마지막 대기 구간의 크기
executor	외부 Executor를 사용할지 여부	내부 thread pool을 쓸지, 외부 공유 executor를 쓸지 결정
minSpareThreads	항상 유지하려는 최소 thread 수	요청이 갑자기 와도 바로 처리할 수 있는 최소 준비 상태 유지
threadsMaxIdleTime	여분 thread를 idle 상태로 얼마나 유지할지	부하 감소 후 thread를 언제 줄일지 결정
connectionTimeout	연결 수락 후 요청 라인을 얼마나 기다릴지	느린 클라이언트 때문에 connection이 오래 묶이는 상황 제어
connectionUploadTimeout	업로드 중 사용할 timeout	대용량 업로드 시 timeout 동작 구분 가능
disableUploadTimeout	업로드용 긴 timeout 사용 여부	업로드 시 일반 요청과 다른 timeout 정책 적용 여부 결정
keepAliveTimeout	keep-alive 연결에서 다음 요청을 얼마나 기다릴지	요청은 적은데 connection 수가 많은 상황 설명 가능
maxKeepAliveRequests	한 연결에서 재사용 가능한 요청 수	keep-alive 연결의 수명을 제한
maxHeaderCount	요청에서 허용할 최대 header 개수	비정상 요청 방어 및 헤더 폭주 제한
maxHttpRequestHeaderSize	요청 라인 + 헤더의 최대 크기	헤더가 클수록 request당 heap 사용이 커지는 원인 파악 가능
processorCache	Processor 객체 재사용 캐시 크기	성능 향상과 GC 부하 사이의 균형점
executorTerminationTimeoutMillis	connector 종료 시 내부 executor가 thread 종료를 기다리는 시간	종료/정지 시 thread 정리 behavior 이해 가능
threadPriority	request-processing thread의 우선순위	thread 실행 우선순위 조정 가능
useVirtualThreads	내부 executor에서 virtual thread 사용 여부	플랫폼 thread 대신 virtual thread 기반 처리 여부를 결정

Java TCP socket attributes

NIO specific configuration

NIO2 specific configuration

출처

Tomcat - The HTTP Connector

[리눅스 마스터] 6-2. 쉘

noahkim_ — Tue, 10 Mar 2026 11:55:30 +0900

1. 분기문

코드) if

a=10

if [ $a -gt 5 ]; then
    echo "a는 5보다 크다"
fi

read a

if [ $a -gt 0 ]; then
    echo "양수"
elif [ $a -eq 0 ]; then
    echo "0"
else
    echo "음수"
fi

표) 조건 연산자

연산자	의미
-eq	같다
-ne	같지 않다
-gt	크다
-lt	작다
-ge	크거나 같다
-le	작거나 같다

2. 산술 연산

코드) $(( ))

echo $((a-b))

3. 문자열

head

텍스트 파일이나 표준 입력의 앞부분을 출력하는 명령어

표) 주요 옵션

옵션	의미
-n	출력할 줄 수 지정
-c	출력할 문자 수 지정

tail

파일이나 입력 데이터의 마지막 부분을 출력

표) 주요 옵션

옵션	의미
-n	마지막 n줄 출력
-c	마지막 n 문자(바이트) 출력
-f	파일 변경을 계속 추적 (로그 확인)

sed

텍스트 스트림을 읽으면서 수정, 삭제, 출력하는 명령어
✅ 줄 선택, 줄 삭제, 문자열 치환

표) 주요 옵션

기능	명령어
문자열 치환	s
줄 출력	p
줄 삭제	d
특정 줄 선택	줄 번호

코드) sed

sed -n '5p' # 5번째 줄 출력
sed -n '5,10p' # 5~10번째 줄 출력
sed -n '5,10p' # 5~10번째 줄 출력

sed '3d' # 3번째 줄 삭제

sed 's/apple/orange/' # apple -> orange 치환 (첫번째 한개만)
sed 's/apple/orange/g' # apple -> orange 치환 (모든 apple 치환)
sed 's/^ *//' # 공백 제거

cut

특정 부분을 잘라내는 명령어

표) 주요 옵션

옵션	설명
-c	문자 위치 기준 추출
-f	필드 기준 추출
-d	필드 구분자 지정

표) -d 구분자 규칙

상황	cut 동작
구분자가 없는 줄	줄 그대로 출력
구분자가 있고 필드 존재	해당 필드 출력
구분자가 있고 필드 없음	출력 없음

코드) cut

cut -c 1

cut -c 2,7

cut -c 2-7

cut -c 13-

cut -f 1-3 # CSV 파일 (구분자: ", ")에서 1~3번째 레코드 가져오기

cut -d " " -f 4 # 공백을 기준으로 단어를 나누고 4번쨰 단어 출력

uniq

연속된 중복 줄을 세거나 개수를 세는 명령어

코드) uniq

uniq -c # 중복된 줄 함께 출력 (ex. 2 abc)
uniq -i # 대소문자 구분 안함
uniq -u # 유일하게 나온 문자만 출력

tr

문자열 치환

코드) tr

tr '()' '[]'

tr -d 'a-z' # 소문자 삭제

tr -s ' ' # 공백들을 하나의 공백으로 압축

sort

문자열 정렬

코드) sort

sort -r # 역순 정렬
sort -n # 숫자 정렬
sort -k2 -n # 두번째 컬럼 기준 정렬
sort -u # 중복 제거
sort -t$'\t' -k2 -nr # 탭을 구분자로 두번째 컬럼 기준 역순정렬

pasted

여러 줄의 데이터를 한 줄로 붙이는 명령어
기본적으로 탭을 구분자로 출력됨

코드) paste

paste -s # 여러줄을 한줄로
paste - - -  # 3개당 한줄씩 출력
paste -d ';' # ';'를 구분자로 출력

[MySQL][SQL] 8. TCL

noahkim_ — Sun, 8 Mar 2026 19:23:51 +0900

1. TCL

데이터베이스에서 트랜잭션의 실행 흐름을 제어하는 SQL 명령어

2. 명령어

명령어	설명	특징
START TRANSACTION	트랜잭션 시작
COMMIT	변경 사항을 확정	트랜잭션 종료 (Rollback 불가)
ROLLBACK	변경 사항 취소	- 트랜잭션에서 수행한 내용 모두 취소됨 - 트랜잭션이 비정상 종료되면 자동 롤백됨
SAVEPOINT	트랜잭션 내 특정 지점 지정	이 지점을 기준으로 부분 롤백이 가능함
ROLLBACK TO SAVEPOINT	지정된 지점으로 되돌림	트랜잭션 실행 중 오류로 인해 재실행 시, 전체 롤백이 아닌 부분롤백으로 계산량을 줄일 수 있음

예시

START TRANSACTION;

INSERT INTO tc_test VALUES('a');
INSERT INTO tc_test VALUES('b');
INSERT INTO tc_test VALUES('c');

SELECT * FROM tc_test;
-- 결과 : a, b, c

SAVEPOINT f1;

INSERT INTO tc_test VALUES('d');
INSERT INTO tc_test VALUES('e');
INSERT INTO tc_test VALUES('f');

SELECT * FROM tc_test;
-- 결과 : a, b, c, d, e, f

ROLLBACK TO f1;

SELECT * FROM tc_test;
-- 결과 : a, b, c

COMMIT;

3. 트랜잭션 오류

상황별 동작

상황	트랜잭션 상태	롤백 범위	SAVEPOINT 사용 여부
SQL 실행 중 일반 오류	트랜잭션 유지	해당 SQL만 실패	✅ (선택적으로)
사용자가 ROLLBACK 실행	트랜잭션 종료	전체 롤백	❌
사용자가 ROLLBACK TO SAVEPOINT 실행	트랜잭션 유지	지정 지점 이후만 롤백	✅
DB 연결 종료 / 서버 crash	트랜잭션 종료	전체 자동 롤백	❌

출처

MySQL - Transactional and Locking Statements

[MySQL][SQL] 7. DCL

noahkim_ — Sun, 8 Mar 2026 19:14:03 +0900

1. DCL

사용자 계정과 권한을 제어하는 SQL 명령어
mysql 시스템 스키마의 권한 테이블에 반영됨

2. 명령어

Grant

사용자 또는 역할에 데이터베이스 객체에 대해 권한을 부여하는 명령어
✅ Grant Option: 자신이 가진 권한을 다른 사용자에게 다시 부여할 수 있음

표) Scope

Scope	예시
Global	GRANT ALL PRIVILEGES ON *.* TO 'admin'@'localhost';
Database	GRANT SELECT ON sales_db.* TO 'user1'@'localhost';
Table	GRANT SELECT, INSERT ON sales_db.orders TO 'user1'@'localhost';
Column	GRANT SELECT(name, price) ON sales_db.products TO 'user1'@'localhost';
Routine	GRANT EXECUTE ON PROCEDURE calc_salary TO 'user1'@'localhost';

예시) Grant 기본 문법

GRANT privilege_list ON scope TO 'user'@'host';

예시) "Grant Option" 키워드

GRANT SELECT ON mydb.* TO 'teamlead'@'localhost' WITH GRANT OPTION;

Revoke

사용자 또는 역할에 데이터베이스 객체에 대해 권한을 회수하는 명령어

예시) Revoke 기본 문법

REVOKE privilege_list ON scope FROM 'user'@'host';

출처

MySQL - Account Management Statements

[MySQL][SQL] 5. Set Operation

noahkim_ — Sat, 7 Mar 2026 02:20:44 +0900

1. 합집합

UNION

두 개 이상의 Select 결과를 합쳐서 하나의 결과 집합으로 만드는 연산자 (중복 제거)
✅ 위 → 아래 순서로 합침
✅ 컬럼 개수, 컬럼 타입, 컬럼 순서가 맞아야 함

코드) Union

(
SELECT column1, column2
FROM table1
)

UNION

(
SELECT column1, column2
FROM table2;
)

UNION ALL

두 개 이상의 Select 결과를 합쳐서 하나의 결과 집합으로 만드는 연산자 (중복 포함)
✅ 성능이 Union보다 빠름
✅ 컬럼 개수, 컬럼 타입, 컬럼 순서가 맞아야 함

코드) Union All

(
SELECT column1, column2
FROM table1
)

UNION ALL

(
SELECT column1, column2
FROM table2;
)

2. 교집합

INTERSECT

두 쿼리 결과의 공통 행만 반환

코드) Intersect

SELECT * FROM A
INTERSECT
SELECT * FROM B;

3. 차집합

EXCEPT

코드) Except

SELECT * FROM A
EXCEPT
SELECT * FROM B;

출처

MySQL - Set Operations with UNION, INTERSECT, and EXCEPT

[MySQL][SQL] 4. Subquery

noahkim_ — Thu, 5 Mar 2026 15:16:04 +0900

1. Subquery

SQL 문 안에 포함된 또 다른 SELECT 문
✅ 결과 기반 처리 (다른 쿼리 결과를 조건으로 사용)
✅ 중첩 가능

종류

구분	정의	특징
Nested Subquery	WHERE 절 내부에 작성되는 서브쿼리	조건 필터링에 사용, 여러 행 반환 가능
Scalar Subquery	하나의 값만 반환하는 서브쿼리	반환값 1행 1열, 여러 값 반환 시 오류
FROM Subquery	FROM 절에 작성되는 서브쿼리	가상 테이블 생성, alias 필수, JOIN 가능
Correlated Subquery	외부 쿼리의 값을 사용하는 서브쿼리	외부값 참조, 행마다 실행, 성능이 JOIN보다 느릴 수 있음

코드) Nested Subquery

SELECT *
FROM employees
WHERE department_id IN (
    SELECT department_id
    FROM departments
);

코드) Scalar Subquery

SELECT name,
       (SELECT AVG(salary) FROM employees) AS avg_salary
FROM employees;

코드) FROM Subquery

SELECT *
FROM (
    SELECT department_id, AVG(salary) avg_sal
    FROM employees
    GROUP BY department_id
) t
WHERE avg_sal > 5000;

코드) Correlated Subquery

SELECT *
FROM employees e
WHERE salary > (
    SELECT AVG(salary)
    FROM employees
    WHERE department_id = e.department_id
);

2. 연산자

연산자	설명
=	단일 값 비교
IN	여러 값 비교
ANY	조건 중 하나
ALL	모든 조건
EXISTS	존재 여부

코드) IN

SELECT *
FROM employees
WHERE salary IN (
    SELECT salary
    FROM employees
    group by employee_id
    having max(salary) > 100000
);

코드) ANY

SELECT *
FROM employees
WHERE salary > ANY (
    SELECT salary
    FROM employees
);

한 샐러리가 어떤 샐러리보다 큰 경우가 있으면 참

코드) ALL

SELECT *
FROM employees
WHERE salary >= ALL (
    SELECT salary
    FROM employees
);

모든 샐러리보다 큰 샐러리는 참 (최대값)

코드) EXISTS

SELECT *
FROM employees e
WHERE EXISTS (
    SELECT 1
    FROM departments d
    WHERE e.department_id = d.id
);

상관 서브쿼리 사용 (바깥 쿼리의 값을 참조)

출처

MySQL - Subqueries