# Azure Entra ID 인증 설정 가이드 이 문서는 Gem Wiki에 Azure Entra ID (구 Azure AD) OIDC 인증을 설정하는 방법을 설명합니다. ## 1. Azure Portal에서 앱 등록 ### 1.1 Azure Portal 접속 1. [Azure Portal](https://portal.azure.com)에 로그인합니다. 2. "Azure Active Directory" (또는 "Microsoft Entra ID")로 이동합니다. 3. "앱 등록" 메뉴를 선택합니다. ### 1.2 새 앱 등록 1. **새 등록** 버튼을 클릭합니다. 2. 다음 정보를 입력합니다: - **이름**: `Gem Wiki` (또는 원하는 이름) - **지원되는 계정 유형**: 조직의 요구사항에 맞게 선택 - **리디렉션 URI**: - 플랫폼: `단일 페이지 애플리케이션(SPA)` - URI: `http://localhost:5173` (개발용) - 프로덕션: `https://wiki.dahyeon.us` ### 1.3 필요한 정보 수집 앱 등록 후, 다음 정보를 메모합니다: - **Application (client) ID** (예: `12345678-1234-1234-1234-123456789abc`) - **Directory (tenant) ID** (예: `87654321-4321-4321-4321-cba987654321`) ### 1.4 API 권한 설정 1. "API 권한" 메뉴로 이동합니다. 2. 기본적으로 `User.Read` 권한이 추가되어 있습니다. 3. 추가 권한이 필요한 경우 **권한 추가** 버튼을 클릭합니다. ### 1.5 인증 설정 1. "인증" 메뉴로 이동합니다. 2. **암시적 허용 및 하이브리드 흐름**에서: - ✅ "액세스 토큰" 체크 - ✅ "ID 토큰" 체크 3. **고급 설정**에서: - ✅ "공용 클라이언트 흐름 허용" 체크 (선택사항) ## 2. 환경 변수 설정 프로젝트 루트에 `.env` 파일을 생성하고 다음 내용을 추가합니다: ```env # Azure AD Configuration VITE_AZURE_CLIENT_ID=your-client-id-here VITE_AZURE_AUTHORITY=https://login.microsoftonline.com/your-tenant-id-here VITE_AZURE_REDIRECT_URI=http://localhost:5173 VITE_AZURE_POST_LOGOUT_REDIRECT_URI=http://localhost:5173 # API Configuration VITE_API_BASE_URL=https://wiki.dahyeon.us/v1 ``` **프로덕션 환경:** ```env VITE_AZURE_CLIENT_ID=your-client-id-here VITE_AZURE_AUTHORITY=https://login.microsoftonline.com/your-tenant-id-here VITE_AZURE_REDIRECT_URI=https://wiki.dahyeon.us VITE_AZURE_POST_LOGOUT_REDIRECT_URI=https://wiki.dahyeon.us VITE_API_BASE_URL=https://wiki.dahyeon.us/v1 ``` ## 3. 백엔드 API 설정 백엔드 API에서 JWT 토큰을 검증하도록 설정해야 합니다. ### 3.1 JWT 검증 설정 백엔드에서 다음을 확인해야 합니다: - **Issuer**: `https://login.microsoftonline.com/{tenant-id}/v2.0` - **Audience**: Azure Portal에서 설정한 Application (client) ID - **JWKS URI**: `https://login.microsoftonline.com/{tenant-id}/discovery/v2.0/keys` ### 3.2 API 엔드포인트 서버 API는 다음과 같은 엔드포인트를 제공해야 합니다: - `GET /v1/pages` - 모든 페이지 조회 - `GET /v1/pages/:id` - 특정 페이지 조회 - `POST /v1/pages` - 새 페이지 생성 - `PUT /v1/pages/:id` - 페이지 업데이트 - `DELETE /v1/pages/:id` - 페이지 삭제 모든 요청은 `Authorization: Bearer {token}` 헤더를 포함해야 합니다. ## 4. 코드에서 인증 사용하기 ### 4.1 컴포넌트에서 인증 상태 확인 ```typescript import { useMsal } from '@azure/msal-react'; function MyComponent() { const { accounts } = useMsal(); const isAuthenticated = accounts.length > 0; if (!isAuthenticated) { return