Apidog는 API 요청을 위한 다양한 인증 방법을 제공하여 통합을 보호하고 보호된 리소스에 접근할 수 있도록 지원합니다. 이 페이지에서는 지원되는 모든 인증 유형과 Apidog에서 이를 구성하는 방법에 대한 포괄적인 참고 자료를 제공합니다.요청의 Authorization 섹션에 있는 Type 메뉴에서 인증 유형을 선택하실 수 있습니다. 인증은 요청, 폴더 또는 컬렉션 수준에서 적용할 수 있으므로 API 워크스페이스 전반에서 자격 증명을 관리하는 방식에 유연성을 제공합니다.인증 유형 비교#
| 유형 | 사용 사례 | 보안 수준 | 일반적인 적용 분야 |
|---|
| 상위 항목에서 상속 | 상위 폴더/컬렉션의 인증 재사용 | 다양함 | 공유 인증을 사용하는 요청 구성 |
| 인증 없음 | 공개 엔드포인트 | 없음 | 상태 확인, 공개 데이터 |
| API Key | 간단한 토큰 기반 인증 | 중간 | 내부 API, 기본 통합 |
| Bearer Token | 토큰 기반 인증(JWT 등) | 중간-높음 | 최신 API, 마이크로서비스 |
| JWT Bearer | 자체 생성 JWT 토큰 | 높음 | 사용자 지정 JWT 구현 |
| Basic Auth | 사용자 이름/비밀번호 | 낮음-중간 | 레거시 시스템, 간단한 인증 |
| Digest Auth | 암호화된 사용자 이름/비밀번호 | 중간 | Basic Auth보다 향상된 보안 |
| OAuth 1.0 | 위임된 권한 부여(레거시) | 중간 | Twitter API, 레거시 서비스 |
| OAuth 2.0 | 최신 위임 권한 부여 | 높음 | Google, GitHub, Microsoft API |
| Hawk Authentication | HMAC 기반 인증 | 높음 | 특수 보안 API |
| NTLM | Windows 인증 | 중간 | Microsoft 환경 |
| Akamai EdgeGrid | Akamai CDN 인증 | 높음 | Akamai 서비스 |
상위 항목에서 상속#
"상위 항목에서 상속"은 Apidog의 기본 인증 유형입니다. 요청의 인증 유형이 "상위 항목에서 상속"으로 설정되어 있으면 해당 요청은 상위 폴더의 인증 구성을 상속하며, 루트 폴더까지 계속 상속합니다. 이를 통해 폴더 수준에서 인증을 한 번 구성하고 모든 하위 요청에 자동으로 적용할 수 있습니다.
인증 없음#
인증이 필요하지 않은 경우 Apidog는 어떠한 권한 부여 정보도 포함하지 않습니다. 인증되지 않은 요청의 경우 Authorization 탭의 Type 드롭다운에서 No Auth를 선택하기만 하면 됩니다.사용자 지정 방식으로 인증을 처리하는 엔드포인트
API Key#
API 키 인증의 경우 요청 헤더 또는 쿼리 매개변수에 키-값 쌍을 제공합니다. Type 옵션에서 API Key를 선택하고 키 이름과 값을 입력한 다음, 이를 Headers 또는 Query Params에 추가하도록 선택합니다.Apidog는 필요한 정보를 요청 헤더 또는 URL 쿼리 문자열에 자동으로 추가합니다.보안을 강화하려면 API 키를 요청에 하드코딩하지 말고 환경 변수에 저장하십시오. 이렇게 하면 버전 관리 또는 공유 워크스페이스에서 실수로 노출되는 것을 방지할 수 있습니다.
Bearer Token#
JSON Web Tokens(JWT)와 같은 Bearer token 인증은 요청 헤더에 액세스 키를 사용합니다. Type 목록에서 Bearer Token을 선택하고 Token 필드에 API 키를 입력하십시오.Apidog는 다음 형식으로 Authorization 헤더에 토큰을 추가합니다."Bearer" 이외의 사용자 지정 접두사를 사용하려면 키 이름을 "Authorization"으로 지정하여 API Key 옵션을 사용하십시오.
JWT Bearer#
Apidog는 애플리케이션 내에서 직접 JWT 토큰 생성을 지원합니다. Type 옵션에서 JWT Bearer를 선택하십시오.Location: 토큰을 Request Header 또는 Query Param에 추가합니다.
Algorithm: SHA를 사용하는 HS, RS, ES 또는 PS 변형 중에서 선택합니다.
Secret/Key: 필요한 시크릿 또는 개인 키를 입력합니다.
Payload: JSON 형식으로 페이로드 데이터를 입력합니다.
Basic Auth#
Basic Auth는 검증된 자격 증명을 요청과 함께 전송하는 방식입니다. Type 메뉴에서 Basic Auth를 선택하고 API 사용자 이름과 비밀번호를 입력하십시오.Apidog는 다음 형식으로 자격 증명의 Base64 인코딩 문자열이 포함된 Authorization 헤더를 포함합니다.Basic <Base64 encoded username and password>
Basic Auth는 자격 증명을 Base64 인코딩으로 전송하며, 이는 쉽게 디코딩될 수 있습니다. Basic Auth를 사용할 때는 항상 HTTPS를 사용하고, 프로덕션 환경에서는 OAuth 2.0과 같은 더 안전한 대안을 고려하십시오.
기타 권한 부여 유형#
Apidog는 다음과 같은 고급 권한 부여 방법도 지원합니다.NTLM - Windows NT LAN Manager 인증 