작가의 말

2020년 3월경, 마이크로서비스의 권한 및 정책 부분을 설계하기 위해 기술 검토를 하던 중 처음으로 OPA를 접했다. 그 전에는 OPA를 쿠버네티스 환경에서 일부 검증을 할 때 사용할 수 있는 기술이라고 단편적으로 알고 있었다. 그러나 조사할수록 쿠버네티스 환경뿐만 아니라 마이크로서비스 기반 애플리케이션의 권한이나 정책을 구현할 때에도 범용으로 사용 가능한 기술임을 확실하게 느낄 수 있었다.
OPA를 적용하면서 OPA를 자세히 다룬 책이 있는지도 찾아봤지만 책의 한 장이나 부록으로 몇 페이지 다루는 책은 있어도 필요한 내용을 충분히 다룬 책은 찾을 수 없었다. 그래서 OPA 활용에 필요한 내용을 충분히 알려주는 책을 기획하게 됐다. 항상 최신 클라우드 기술에 관련된 책들은 해외에서 먼저 출판되는 사례가 많은데 OPA는 해외에서 책이 출판되기 전에 국내에 소개하겠다는 작은 목표를 세웠다.
처음에는 마이크로서비스 환경에서 애플리케이션의 정책/권한 부분에만 집중하려고 했다. 하지만 쿠버네티스 환경에서도 널리 활용되는 기술이므로 관련 내용을 꼭 포함하면 좋겠다는 의견을 주신 분이 많아 관련 내용을 보강했다. 결과적으로 옳은 의견이었고, 의견 주신 분들께 감사드린다.
OPA를 접하고 가장 놀라웠던 점은 커뮤니티 버전과 상용 버전의 기능이 차별화되는 일반적인 오픈소스들과 달리 OPA의 핵심 코드뿐만 아니라 OPA와 함께 사용할 수 있는 좋은 도구들도 함께 오픈소스로 공개된다는 점이었다. 이뿐만 아니라 OPA를 사용하다가 해결이 잘 되지 않는 문제가 있다면 Styra사에서 운영하는 OPA 슬랙 채널에서 물어보면 친절한 답변을 얻을 수 있을 것이다. 지면을 빌어 OPA와 관련 도구들을 자유롭게 사용할 수 있도록 공개해 준 Styra사에 감사를 전하고 싶다.
마이크로서비스 아키텍처의 관점에서 OPA를 논하자면, OPA는 정책/권한이라는 중요하고 특별한 도메인을 담당하는 기술이라고 할 수 있다. 마이크로서비스 아키텍처를 구성하는 모든 도메인에서 도메인 전용 언어(DSL)를 정의한다면 혼란스럽겠지만 정책이라는 도메인은 전용의 DSL을 가질 자격이 충분할 만큼 중요한 도메인이다. 정책의 별도 분리를 통해 서비스가 비즈니스 요건에 따라 계속 정책 변경을 요구하더라도 유연한 대처가 가능하다.
또 보안의 관점에서 보면 흔히 암호화와 통신 프로토콜 등에 우선 집중하게 되지만 많은 보안 사고는 정책의 설정이 잘못돼 발생한다. 수년 전 미국 트럼프 대통령의 당선 과정에서 문제가 됐던 캠브리지 애널리티카 사건의 경우도 페이스북의 보안 프로토콜이 해킹 당한 문제가 아닌 정보의 접근 권한이 잘못 설정된 문제였다.
클라우드 네이티브의 관점에서 일단 OPA 자체가 Go 언어로 개발돼 단일 바이너리로 컴파일되는 쿠버네티스 환경에서 컨테이너로 동작하기에 효율적인 형태로 개발됐다. OPA를 Go 클라이언트 라이브러로 사용할 수도 있고, 사이드카로 파드에 컨테이너와 함께 패키징할 수도 있으며, 별도의 REST 서버로도 동작시킬 수 있다. 또 정책을 번들로 패키징해서 여러 서비스에 효율적으로 동기화할 수 있는 수단도 제공한다.
클라우드 네이티브 애플리케이션과 마이크로서비스 아키텍처는 2~3년 전만해도 복잡하기만 하고 실용적이지 않다는 의심도 많이 받았지만, 현재는 그런 단계를 지나 안정적으로 정착되고 대세가 되고 있는 것 같다. 독자들이 OPA를 계속 배우다 보면 Policy as Code 개념을 배우고 있다는 것을 깨닫게 될 것이다. 결국 마이크로서비스와 클라우드 네이티브 환경에 적합한 권한 관리는 이런 형태일 수밖에 없겠다는 느낌도 받을 것이다.
책을 쓰는 과정에서 알 수 없는 버그를 만나 OPA 소스 코드를 살펴보기도 하고, 공식 문서의 내용과 다른 부분에 혼란스럽기도 했으며 자바를 위한 간단한 웹어셈블리 SDK도 만들어 봤다. 이런 힘든 과정을 마치고 책을 출판할 수 있었던 이유는 OPA가 유용한 기술인 이유도 있지만 무엇보다 배우고 적용해 보는 과정이 재밌고 흥미로웠기 때문이다.
독자들도 이러한 흥미를 느낄 수 있을 때까지 처음의 낯섦과 지루함을 조금만 견딜 수 있다면 많은 것을 얻을 수 있을 것으로 기대한다. 그 과정에서 이 책이 도움이 되기를 바란다.

1장. OPA 소개
__OPA 개요
__OPA의 특징
____OPA의 장점
________정책을 코드로 통합
________형식의 유연성
________REPL 및 플레이그라운드 지원
________테스트 및 성능 측정의 용이성
________정책 번들 지원
________많은 프로젝트에 적용돼 검증됨
________빠른 기능 개발 속도
________문서화의 범위가 넓음
____OPA의 단점
________전용 정책 언어 Rego의 생소함
________프로그래밍 언어 지원의 제약
________데이터베이스 등 외부 저장소 미지원
________문서화의 디테일 부족
__OPA 사용 사례
________사용자 권한 관리
________시스템 정책 및 제약사항 관리
________API 게이트웨이 보안
________CI/CD 자동화를 위한 검사 도구
________서비스 수준 정책 관리
________정책의 통합 관리
__OPA 관련 기술 및 개념 정리
________인증
________권한 부여 혹은 인가
________감사
________RBAC
________ABAC
________JWT
________OAuth 2.0
________OpenID Connect 1.0
__OPA 사용해 보기
__정리


2장. OPA 설치 및 사용
__OPA 설치
____리눅스 환경
____맥 OS 환경
____윈도우 환경
____설치 확인
__Visual Studio Code 및 OPA 플러그인 설치
____Visual Studio Code 설치
____vscode-opa 플러그인 설치
__기본적인 vscode-opa 사용 방법
__정리


3장. Rego
__Rego 개요
__Rego 언어 문법 개요
__레일로드 다이어그램
__Rego 모듈
____모듈
____패키지
____임포트
____정책
__기본 요소
____스칼라값
________숫자
________문자열
____복합값
________객체
________배열
________집합
____포괄식
________객체 포괄식
________집합 포괄식
________배열 포괄식
__변수 및 참조
____변수
____참조
____순회
__규칙
____값 할당
____값 할당의 특성
____완전한 규칙
____규칙 집합
____else문
____규칙의 기본값
____규칙의 예
____부분 규칙
____함수
____구문
____some문
____with문
____표현식
____not문
____중위 연산자 및 중위 연산자 포함식
____집합 연산자
____동등성 연산자
________할당 연산자
________비교 연산자
________단일화 연산자
____주석
____예약된 이름
__그렇다면 main은?
__정리


4장. 내장 함수
__숫자 관련 함수
____반올림, 내림, 올림
____절댓값
____특정 범위의 정수 배열 생성
__비트 연산
__타입 관련 함수
____타입 이름
____타입 확인
____타입 변환
__집계 함수
____count 함수
____sum, product, max, min 함수
____all, any 함수
__복합값 관련 함수
____배열 관련 함수
____집합 관련 함수
____객체 관련 함수
________object.get
________object.remove
________object.union
________object.filter
________json.filter
________json.remove
__문자열 관련 함수
____문자열 검사
________contains
________indexof
________startswith, endswith
____문자열 포맷
________sprintf
________format_int
________대소문자 변환
____문자열 조작
________concat
________split
________substring
________replace
________strings.replace_n
____문자열 공백 제거
________trim_space
________trim, trim_left, trim_right
________trim_prefix, trim_suffix
__정규식 관련 함수
____regex.is_valid
____regex.match
____regex.split
____regex.globs_match
____regex.template_match
____regex.find_n
____regex.find_all_string_submatch_n
__Glob 관련 함수
____Glob 패턴
____Glob 매칭
____이스케이프 처리
__HTTP 관련 함수
__JWT 관련 함수
____JWT 디코딩 함수
____JWT 서명 검증
__정리


5장. OPA를 사용한 정책 구현
__기본 시나리오
____시스템 정의
____입력 스키마 정의
____데이터 정의
____정책 작성
____정책 테스트
____디버깅을 위한 쿼리 추적
__API가 다중 권한을 요구하는 시나리오
____데이터 정의
____정책 작성
____정책 테스트
__공개 API를 추가한 시나리오
____데이터 정의
____정책 작성
____정책 테스트
__권한 계층 구조를 지원하는 시나리오
____데이터 정의
____정책 작성
____정책 테스트
__API 계층 구조를 지원하는 시나리오
____데이터 정의
____정책 작성
____정책 테스트
__정리


6장. OPA 번들
__OPA 번들 생성
____OPA 번들 수동 생성
____OPA 번들 도구
__OPA 번들의 서명
____HMAC을 이용한 번들 서명 및 검증
____비대칭 키 서명을 이용한 번들 서명 및 검증
____번들 서명 파일만 생성
__정리


7장. OPA 통합
__OPA REST API 서버
____HTTPS로 OPA 서버 실행
__OPA REST API 서버 설정
____OPA 설정 파일의 구조
____REST 서버 시작 시 OPA 설정 적용
__도커 및 쿠버네티스 환경에서 실행
____도커 환경에서 실행
____쿠버네티스 환경에서 실행
__Go 클라이언트 라이브러리로 애플리케이션에 통합
__OPA와 외부 데이터를 연동하는 방법
____JWT에 기반한 방법
____Input 오버로딩
____번들
____푸시
____평가 시 폴링
____데이터베이스를 활용해서 정책 정보 관리하기
__정리


8장. 모니터링
__프로메테우스를 통한 OPA 서버 모니터링
____OPA에서 제공하는 메트릭 정보
____프로메테우스를 통한 모니터링
____단일 쿼리 성능 모니터링
__OPA 서버 헬스체크
__OPA 서버 상태 정보 및 결정 로그
____OPA 상태 정보
____OPA 결정 로그
____OPA 결정 로그 마스킹
____상태 정보 및 결정 로그 수집을 위한 서버 구현
____상태 정보 및 결정 로그 파티션 설정
__정리


9장. 쿠버네티스 환경에서 OPA 활용
__OPA 게이트키퍼
____OPA 게이트키퍼 개요
____OPA 게이트키퍼 설치 및 제거 방법
____OPA 게이트키퍼 제약사항 템플릿
____OPA 게이트키퍼 제약사항
____OPA 게이트키퍼 동작 확인
____OPA 게이트키퍼 CRD 관련 명령
__OPA 게이트키퍼 정책 라이브러리
____일반 템플릿
____PSP 템플릿
__OPA 게이트키퍼 설정
____데이터 복제 설정
____네임스페이스 열외 처리
____웹훅 설정
__쿠버네티스 환경에서 사용 가능한 그 외의 도구들
____Conftest
____테라폼에서 OPA 활용
____opa-kafka-plugin
____opa-envoy-plugin
__정리


10장. OPA 확장
__OPA 내장 함수
____OPA 내장 함수 구현
____OPA 내장 함수 통합
__OPA 플러그인
____OPA 플러그인 구조
____플러그인 예제
____플러그인 버전 설정
____특별한 OPA 플러그인들
__정리


11장. OPA와 웹 어셈블리
__OPA의 웹 어셈블리 활용
____웹 어셈블리 개요
____웹 어셈블리 지원을 통해 기대할 수 있는 장점
____OPA 웹 어셈블리를 사용하기 위한 요구사항
____npm-opa-wasm을 통한 OPA 웹 어셈블리 모듈 적용
__자바를 위한 OPA 웹 어셈블리 SDK 작성
____웹 어셈블리 SDK 요구사항
____자바 SDK 인터페이스 정의
____웹 어셈블리 런타임 연동
____SDK API 구현
____OPA 웹 어셈블리 자바 SDK 사용 예제
__OPA 웹 어셈블리 SDK와 내장 함수
____SDK에서 구현해야 할 내장 함수 확인
____SDK를 통해 호출할 내장 함수 목록 초기화
____내장 함수 구현 예시
____사용자 내장 함수 구현
__정리