보안 스키마 사용

폴더 수준에서 보안 스키마 구성하기

1

임의의 폴더를 선택하고 오른쪽의 Auth 탭을 클릭한 다음, 인증 유형으로 Security Scheme을 선택하십시오.

보안 스키마 인증 유형 선택

2

드롭다운 메뉴에서 원하는 Security Scheme을 선택하십시오.

원하는 보안 스키마 선택

3

보안 스키마로 OAuth 2.0을 선택한 경우, 필요한 Scopes를 추가로 선택할 수 있습니다.

보안 스키마 스코프 선택

폴더 수준에서 구성된 보안 스키마는 자체 인증 구성이 없는 한 해당 폴더 아래의 모든 하위 폴더와 엔드포인트에 적용됩니다.

엔드포인트 수준에서 보안 스키마 구성하기

1

임의의 엔드포인트를 선택하고 오른쪽의 Edit 탭으로 이동하십시오. Request 섹션에서 인증 유형으로 Security Scheme을 선택하십시오.

엔드포인트 수준에서 보안 스키마 구성

2

드롭다운 메뉴에서 원하는 Security Scheme을 선택하십시오.

엔드포인트에 사용할 원하는 보안 스키마 선택

3

보안 스키마로 OAuth 2.0을 선택한 경우, 필요한 Scopes를 추가로 선택할 수 있습니다.

엔드포인트 보안 스키마 스코프 선택

엔드포인트 수준에서 구성된 Auth 설정은 폴더 수준의 설정을 재정의합니다.

보안 스키마의 기본값 설정하기

보안 스키마는 인증 방법만 정의합니다. 엔드포인트를 디버깅할 때는 실제 인증 값을 계속 제공해야 합니다.

엔드포인트 디버깅 중 인증 값을 반복해서 입력하지 않도록, Apidog에서는 기본 인증 값을 설정할 수 있습니다. 설정이 완료되면 수동으로 재정의하지 않는 한 디버깅 중 이러한 기본값이 자동으로 사용됩니다. 폴더에 기본 인증 값이 구성되어 있으면 해당 폴더 아래의 모든 엔드포인트에서 이를 사용할 수 있습니다.

1

목록에서 보안 스키마를 선택하고 Default Auth Values를 설정하십시오.

기본 인증 값

2

인증 유형에 따라 값을 입력하십시오.

API Key: 키를 입력하십시오.

Basic Auth: 사용자 이름과 비밀번호를 입력하십시오.

Bearer Token: 토큰을 입력하십시오.

OAuth 2.0: 클라이언트 ID, 클라이언트 시크릿 등을 입력하십시오.

Other methods: 해당하는 값을 입력하십시오.

인증 값 상속 및 사용자 지정

보안 스키마를 사용할 때 다음 중 하나를 선택할 수 있습니다.

1. 상위 폴더에서 상속

상위 폴더 또는 루트 폴더에 정의된 보안 스키마와 기본값을 사용합니다.

보안 스키마 상속

2. 인증 값 사용자 지정

동일한 보안 스키마를 유지하되 해당 기본값을 재정의합니다.

보안 스키마 사용자 지정

여러 보안 스키마 사용하기

Apidog는 단일 엔드포인트에 여러 보안 스키마를 구성하는 기능을 지원하며, 이는 OpenAPI 사양에 정의된 여러 인증 유형 메커니즘과 일치합니다.

AND: AND로 결합된 보안 스키마는 동일한 요청에서 동시에 사용해야 합니다(곧 제공 예정).

OR: OR로 결합된 보안 스키마는 대안입니다. 주어진 컨텍스트에서 그중 하나를 사용할 수 있습니다.

Auth 설정에서 + 버튼을 사용하여 보안 스키마를 더 추가하십시오.

여러 보안 스키마 추가

OAuth 2.0 보안 스키마의 스코프 선택하기

OpenAPI 사양에 따르면 OAuth 2.0 보안 스키마를 생성할 때 가능한 모든 Scopes를 정의해야 합니다. 엔드포인트에서 이를 사용할 때는 필요한 스코프를 선택해야 합니다.

작업을 더 쉽게 하기 위해 Apidog에서는 폴더 수준에서 기본 스코프를 설정할 수 있습니다. 엔드포인트 수준에서 다른 스코프를 수동으로 설정하지 않는 한, 이러한 기본값은 폴더 내 모든 엔드포인트에 적용됩니다.

1

엔드포인트의 Auth 설정에서 OAuth 2.0을 선택하십시오.

2

Scopes 섹션에서 보안 스키마에 의해 정의된 사용 가능한 모든 스코프를 확인하고 필요한 스코프를 선택할 수 있습니다.

엔드포인트 수준에서 인증 스코프 선택

3

엔드포인트가 상위 폴더에서 스코프를 상속하는 경우, Reset the scopes to the configuration of the parent folder를 클릭하여 상위 구성으로 되돌릴 수 있습니다.

스코프 설정 재설정

OAuth 2.0 보안 스키마로 엔드포인트 디버깅하기

OAuth 2.0 보안 스키마의 기본값으로 토큰을 미리 구성할 수 있으므로, API를 디버깅할 때마다 새 토큰을 받을 필요가 없습니다.

폴더 수준에서 기본 인증 값으로 토큰 받기

1

폴더를 선택하고 Auth 탭으로 이동한 다음, OAuth 2.0 보안 스키마를 선택하고 스코프와 권한 부여 유형을 선택한 후 Get Token을 클릭하십시오.

폴더 수준에서 OAuth 2.0 토큰 받기

2

팝업 패널에서 다음을 수행하십시오.

클라이언트 ID, 클라이언트 시크릿 등을 입력하십시오.

Continue를 클릭하십시오.

OAuth 2.0 토큰 보안 스키마 테스트

3

토큰을 받은 후에는 만료 시점을 포함한 세부 정보를 확인할 수 있습니다. 이 토큰은 폴더 내 모든 엔드포인트에서 사용할 수 있습니다.

폴더에서 토큰 세부 정보 보기

엔드포인트 수준에서 기본 인증 값으로 토큰 받기

1

원하는 엔드포인트를 선택하고 Edit으로 이동한 다음, OAuth 2.0 보안 스키마를 선택하고 Get Token을 클릭하십시오.

엔드포인트 수준에서 토큰 받기

2

팝업 패널에서 다음을 수행하십시오.

클라이언트 ID, 클라이언트 시크릿 등을 입력하십시오.

Continue를 클릭하십시오.

엔드포인트 수준에서 OAuth 2.0 토큰 보안 스키마 테스트

3

인증을 완료하여 토큰을 받으십시오.

해당 토큰은 이 엔드포인트를 디버깅하는 데 사용됩니다.

토큰 세부 정보 보기

엔드포인트 디버깅에 기본 토큰 사용 또는 새 토큰 생성하기

Apidog에서 엔드포인트를 디버깅할 때 인증 토큰을 적용하는 방법은 두 가지입니다.

방법 1: 기본 인증 토큰 사용

엔드포인트를 실행할 때 Run 패널 아래의 Auth 탭으로 이동하십시오. Use Parent Default Auth Values를 선택하십시오. 상위 폴더에 구성된 기본 인증 토큰이 엔드포인트 요청에 자동으로 적용됩니다.

엔드포인트 디버깅에 기본 인증 토큰 사용

방법 2: 새 토큰 생성

1

엔드포인트를 실행할 때 Run 패널 아래의 Auth 탭으로 이동하십시오. Set Manually를 선택하십시오. Get Token을 클릭하여 토큰 생성 패널을 여십시오.

엔드포인트 디버깅을 위한 새 토큰 생성

2

팝업 패널에서 다음을 수행하십시오.

클라이언트 ID, 클라이언트 시크릿 등을 입력하십시오.

Continue를 클릭하십시오.

새 토큰 생성을 위한 정보 입력

3

인증을 완료하여 토큰을 받으십시오.

해당 토큰은 현재 엔드포인트를 디버깅하는 데 사용됩니다.

Modified at 2026-06-09 08:53:32

보안 스키마 생성

온라인 문서의 보안 스키마