Secret 조회 API reference

이 사용 가이드에서는 Secrets Manager의 Public / Private Endpoint 사용 방법과 호출 방법을 설명합니다.

Endpoint 호출을 위한 사전 설정하기

Secrets Manager의 Endpoint 호출 시 필요한 사전 설정 항목을 설명합니다.

Security Group의 Outbound Rule 등록

Endpoint를 호출하기 위해 Security Group에 Outbound Rule 등록이 필요합니다.

Security Group의 Outbound Rule을 등록하려면 다음 절차를 따르세요.

1. 모든 서비스 > Security > Secrets Manager 메뉴를 클릭하세요. Secrets Manager의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Secrets Manager 메뉴를 클릭하세요. Secrets Manager 목록 페이지로 이동합니다.
3. Secrets Manager 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Secrets Manager 상세 페이지로 이동합니다.
4. Secrets Manager 상세 페이지에서 URL 정보를 확인하세요.
   • URL 항목에서 퍼블릭 / 프라이빗 URL 정보를 복사할 수 있습니다.
5. nslookup 명령어를 사용해 Security Group에 등록할 IP를 확인하세요.

nslookup <호출할 endpoint url>

6. Security Group > Security Group 목록에서 접근 제어를 설정하려는 VM의 Security Group을 선택하세요. Security Group 상세 페이지로 이동합니다.
7. Security Group 상세 > 규칙 탭에서 규칙 추가 버튼을 클릭하세요. 규칙 추가 창이 나타나면 아래 정보를 입력해 규칙을 추가합니다.

   항목	상세 설명
   대상 입력 방법	CIDR 선택
   대상 주소	nslookup으로 조회된 IP 주소 입력
   유형	목적지 포트/Type 선택 후 프로토콜 정보 입력 프로토콜 중 TCP 선택, TCP 목적지 포트에 443 입력
   방향	Outbount 규칙 선택
   설명	Secrets Manager Public / Private Endpoint 호출 규칙 입력

   표. Security Group의 규칙 추가 입력 항목
8. Security Group 규칙 목록에 입력한 규칙이 추가되었는지 확인하세요.

Secrets Manager의 접근 제어 등록

Secrets Manager의 퍼블릭/프라이빗 접근 제어를 등록할 수 있습니다.

Secrets Manager의 접근 제어 항목을 설정하려면 다음 절차를 따르세요.

1. 모든 서비스 > Security > Secrets Manager 메뉴를 클릭하세요. Secrets Manager의 Service Home 페이지로 이동합니다.
2. Service Home 페이지에서 Secrets Manager 메뉴를 클릭하세요. Secrets Manager 목록 페이지로 이동합니다.
3. Secrets Manager 목록 페이지에서 상세 정보를 확인할 자원을 클릭하세요. Secrets Manager 상세 페이지로 이동합니다.
4. Secrets Manager 상세 페이지에서 퍼블릭 접근 제어의 수정 아이콘을 클릭해 Public Endpoint 접근 허용 IP를 추가하세요.
   • 퍼블릭 접근 제어 수정 팝업 창에서 IP를 입력하고 추가 버튼을 클릭하세요. 추가가 완료되면 확인 버튼을 클릭하세요.
   • 보안을 위해 단일 IP 추가를 권장하며, 최대 10개까지 등록할 수 있습니다.
   • 0.0.0.0/24 - 0.0.0.0/32 대역을 등록할 수 있지만 보안에 취약할 수 있으니 주의하세요.
5. Secrets Manager 상세 페이지에서 프라이빗 접근 제어의 수정 아이콘을 클릭해 Private Endpoint 접근 허용 VM을 추가하세요.
   • 프라이빗 접근 제어 수정 팝업 창에서 접근을 허용할 리소스를 선택하고 추가 버튼을 클릭하세요. 추가가 완료되면 확인 버튼을 클릭하세요.
   • 사용 설정을 하지 않으면 동일 리전의 모든 서브넷 리소스에 접근할 수 있습니다.

Secrets Manager API 호출하기

Secrets Manager의 API 호출 방법을 설명합니다.

Secrets Manager의 URL 정보 확인

모든 서비스 > Security > Secrets Manager > Secrets Manager 상세 페이지에서 URL 정보를 확인하세요.

• URL 항목에서 퍼블릭 / 프라이빗 URL 정보를 복사할 수 있습니다.

Secrets Manager 조회 API

get /v1/secret

Description

Secret 값 조회

Parameters

Responses

Example HTTP request

Request path

/v1/secret?secretId={secretId}

Request header

"AccessKey = 341g54421b5d67a1gf2b30f1a5415e75",
"SecretKey = 87d5eec6-998h-4933-e865-fd837495je28"

Example HTTP response

Response 200

{
  "status": "success",
  "data": {
    "key": "value"
  },
  "timestamp": "2026-01-20T09:21:18.92730172"
}