정훈's 프로그래밍

1. NuGet 패키지 관리자 추가(.Net Framework 9.0 버전인 경우)Swashbuckle.AspNetCore 2. Program.cs 설정// --------------------------------------------------------------------------// Swagger/OpenAPI 문서 및 UI 생성 서비스 추가// (Swashbuckle.AspNetCore 패키지에서 제공)// --------------------------------------------------------------------------builder.Services.AddSwaggerGen(c =>{ c.SwaggerDoc("v1", new OpenApiInfo { Title = "M..

ASP.NET Core Web API 프로젝트 생성1. Visual Studio를 실행한다.2. ASP.NET Core 웹 API 를 선택한 후 "다음" 버튼을 클릭합니다. 3. 프로젝트를 빌드(Ctrl + Shift + F5) 합니다.4. 프로젝트를 실행(Ctrl + F5)합니다.5. 호출https://localhost:7059/openapi/v1.json 1회차: ASP.NET Core Web API 핵심 개념 1회차: ASP.NET Core Web API 핵심 개념ASP.NET Core Web API 란?ASP.NET Core Web API는 C#으로 RESTful한 백엔드 API 서버를 쉽게 만들 수 있는 프레임워크입니다. REST(Representational State Transfer)는웹..

ASP.NET Core Web API 란?ASP.NET Core Web API는 C#으로 RESTful한 백엔드 API 서버를 쉽게 만들 수 있는 프레임워크입니다. REST(Representational State Transfer)는웹에서 리소스(자원)를 HTTP 프로토콜을 통해 주고받기 위한 설계 원칙입니다. 결론ASP.NET Core Web API는 프레임워크이다.무엇을 위한 프레임워크? = RESTful 한 백엔드 API를 만들기 위한 프레임워크이다. 참고RESTful 에서 ful은 접미사로써 "~을 충분히 가진" 이라는 의미로 사용된다.즉 REST 설계 원칙을 충분히 따르는 API 라는 의미로 사용된다. API란?API(Application Programming Interface)프로그램과 프로그..

.NET 9.0 부터 Swagger 패키지가 제거 되었다.필요시 수동으로 Swagger 패키지를 추가해 주어야 한다. .NET 8.0 기본 URLhttps://localhost:7188/swagger/index.html .NET 9.0 기본 URLhttps://localhost:7005/openapi/v1.jsonorhttps://localhost:7005/swagger/index.html Swagger 패키지 추가# Swagger UI를 위해 필요dotnet add package Swashbuckle.AspNetCore Swagger 설정(Program.cs)// --------------------------------------------------------------------------// S..

IActionResult 유형HTTP 상태 코드설명일반적인 사용 예시Ok()200 OK요청이 성공적으로 처리되었음을 나타냅니다. 주로 조회(GET) 요청 성공 시 데이터와 함께 반환됩니다.return Ok(data); (데이터 조회 성공)CreatedAtAction()201 Created리소스(자원)가 성공적으로 생성되었음을 나타냅니다. 생성된 리소스의 URI와 함께 해당 리소스의 본문(Body)을 반환하는 것이 RESTful 관례입니다.return CreatedAtAction(nameof(GetById), new { id = newResourceId }, newResourceObject); (새로운 사용자 등록 성공)NoContent()204 No Content요청은 성공적으로 처리되었지만, 반환할 본..

내장된 유효성 검사 특성 외에 사용자 정의 유효성 검사 규칙을 추가하는 방법은 크게 두 가지가 있습니다.사용자 정의 유효성 검사 특성(Custom Validation Attribute):가장 일반적인 방법이며, 단일 속성에 대한 유효성 검사를 정의할 때 [Required], [StringLength]처럼 속성 위에 어노테이션 형태로 붙여 사용할 수 있습니다. 재사용성이 높습니다.ValidationAttribute 클래스를 상속받아 구현합니다.IValidatableObject 인터페이스 구현:모델(클래스) 수준의 유효성 검사를 정의할 때 사용합니다. 여러 속성의 값 조합에 따라 유효성 검사 결과가 달라지는 경우에 적합합니다. (예: 시작 날짜가 종료 날짜보다 빠르지 않아야 한다.)NoReservedUser..

public class MyModel{ // 컴파일러에게 null이 될 수 있음을 알림. // 하지만 런타임 시에는 이 속성이 필수임을 [Required]로 강제. [Required] public string? RequiredField { get; set; } // 컴파일러에게 null이 될 수 있음을 알림. // 런타임 시에도 null을 허용함 (필수 아님). public string? OptionalField { get; set; } // 컴파일러에게 null이 될 수 없음을 알림. (경고 발생 가능성 있음) // 런타임 시에는 필수임을 강제. [Required] public string AnotherRequiredField { get; se..

비유: 공항 보안 검색대와 탑승 게이트승객 (Client): HTTP 요청을 보내는 사용자.보안 검색대 (app.UseAuthentication()): 승객의 신분증(JWT 토큰)을 확인하여 '이 사람이 누구인지'를 인증하는 곳.탑승 게이트 (app.UseAuthorization()): 신분증(인증)이 확인된 승객이 '이 비행기(보호된 리소스)를 탈 수 있는 자격(권한)이 있는지'를 확인하는 곳.탑승권 ([Authorize] 속성): 특정 비행기에 탑승하기 위해 필요한 자격(예: 퍼스트 클래스 승객, 특정 목적지 승객)을 나타내는 표식.[Authorize] 속성 처리 과정 (단계별 설명)[Authorize] 속성이 붙은 API 엔드포인트에 요청이 들어오면, ASP.NET Core는 다음 단계를 거쳐 요청..

JWT 기반의 토큰 인증을 구현할 때는1. 표준 HTTP 헤더 이름(Authorization)2. OAuth 2.0 프레임워크 표준 인증 스킴(Bearer)이 필수적으로 필요하다. // 인증을 위한 헤더 이름과 BearerAuthorization: Bearer yourstrongkeyvalueover32

Program.cs 수정: SwaggerGen에 JWT 인증 추가Program.cs 파일을 열고 builder.Services.AddSwaggerGen() 부분에 다음 설정을 추가합니다.Program.cs (Swagger 인증 설정 추가)// Program.csusing System.Text;using Microsoft.AspNetCore.Authentication.JwtBearer;using Microsoft.IdentityModel.Tokens;using Microsoft.OpenApi.Models; // OpenApiSecurityScheme, OpenApiSecurityRequirement 사용을 위해 필요using Microsoft.AspNetCore.Authorization; // 이미 있다면..