가상 서버 인스턴스의 IBM Cloud® Virtual Private Cloud (VPC) 메타데이터 정보

VPC 메타데이터 서비스는 가상 서버 인스턴스에 대한 정보에 액세스하는 데 사용할 수 있는 무료 서비스입니다. 인스턴스 내에서 REST API를 통해 서비스를 호출하여 해당 인스턴스에 대한 정보를 가져올 수 있습니다. 인스턴스 외부에서는 API에 액세스할 수 없습니다. 메타데이터에 액세스하려면 먼저 ID 액세스 토큰을 생성해야 합니다. ID 토큰을 사용하여 선택적으로 모든 IAM 지원 서비스에 액세스하는 데 사용할 수 있는 IAM 토큰을 받을 수 있습니다.

메타데이터 서비스 개념

가상 서버 인스턴스에 대한 메타데이터에 프로그래밍 방식으로 액세스하고 이를 사용하여 새 인스턴스를 초기화할 수 있습니다. API 서비스에서 제공하는 메타데이터는 요청이 이루어진 인스턴스에만 관련됩니다. 인스턴스 내의 메타데이터 서비스를 사용하여 다른 인스턴스에 대한 정보를 얻거나 현재 인스턴스와 연결되어 있지 않은 리소스에 대한 정보를 얻을 수 없습니다.

액세스할 수 있는 메타데이터에는 인스턴스 이름, CRN, 리소스 그룹, 사용자 데이터는 물론 SSH 키 및 배치 그룹에 대한 정보도 포함됩니다. 서비스에서 리턴된 모든 메타데이터에 대한 자세한 정보는 메타데이터 서비스에서 리턴된 데이터 요약 을 참조하십시오.

메타데이터 서비스는 REST API와 인스턴스의 호스트 이름을 사용하여 메타데이터를 검색합니다. 메타데이터 서비스에 대한 액세스는 기본적으로 비활성화되어 있습니다. 모든 인스턴스의 메타데이터 서비스에 대한 액세스는 VPC API, CLI 또는 콘솔에서 활성화할 수 있습니다.

메타데이터 서비스에는 두 가지 구성 요소가 있습니다:

  • 신원 API: 이 서비스는 신원 토큰, 신원 인증서 및 IAM 액세스 토큰을 제공합니다. 메타데이터 정보에 액세스하고 검색하려면 ID 토큰이 필요합니다. 다른 IBM Cloud IAM 지원 서비스에 액세스하려면 ID 토큰에서 IAM 토큰을 생성할 수 있습니다. 예를 들어 인스턴스를 시작하려면 IBM Cloud Database를 호출하여 데이터베이스 서버를 설정해야 할 수 있습니다. 마지막으로, ID 인증서는 가상 서버 인스턴스와 마운트된 파일 공유 간에 전송 중 암호화를 설정하는 데 사용됩니다.

  • 메타데이터 API는 인스턴스의 메타데이터에 대한 액세스를 제공합니다. 메타데이터 서비스 API를 호출하여 인스턴스 초기화 데이터, 네트워크 인터페이스, 볼륨 연결, 공용 SSH 키 및 배치 그룹 정보를 얻을 수 있습니다.

메타데이터 사용자 워크플로우를 보여주는 그림입니다.
메타데이터 서비스의 사용자 시나리오

신원 API

ID API를 사용하면 메타데이터 서비스에 액세스하기 위한 ID 액세스 토큰을 생성할 수 있습니다. http://api.metadata.cloud.ibm.com/identity/v1/token 또는 보안 통신이 활성화된 경우 https://api.metadata.cloud.ibm.com/identity/v1/token 으로 엔드포인트를 호출하여 토큰을 생성합니다.

이 엔드포인트는 가상 서버 인스턴스 내에서 실행 중인 모든 명령, 프로세스 및 소프트웨어 애플리케이션에 액세스할 수 있습니다. 가상 서버 인스턴스 외부에서는 API 엔드포인트에 액세스할 수 없습니다.

메타데이터 서비스를 호출할 때 ID 액세스 토큰을 사용합니다. 토큰은 만기 (기본적으로 5분) 에 도달할 때까지 유효합니다. 자세한 내용은 ID 액세스 토큰 획득하기를 참조하세요.

ID 액세스 토큰에서 IAM 토큰을 생성할 수도 있습니다. 이 IAM 토큰을 사용하여 인스턴스에 링크된 IAM 신뢰 프로파일에 대한 액세스 권한 및 정책 설정을 기반으로 하는 모든 IAM 사용 서비스에 액세스할 수 있습니다. IAM 토큰 서비스 기본값에 따라 자체 만료일이 있습니다. ID 액세스 토큰에서 IAM 토큰을 생성합니다.

현재 /instance_identity/v1/token 방법을 사용 중이고 API 릴리스 버전 2025-08-26 이상을 채택하려는 경우 마이그레이션 지침에 설명된 변경 사항을 검토하세요: 2025-08-26 버전의 VPC 신원 API로 업데이트하기.

메타데이터 서비스

기존 및 새 인스턴스에서 메타데이터 서비스에 대한 액세스를 활성화하여 인스턴스에 대한 데이터를 검색할 수 있습니다. 콘솔, CLI 또는 API에서 메타데이터 서비스에 대한 액세스를 활성화할 수 있습니다.

메타데이터는 인스턴스 특정 정보를 제공하는 REST API를 호출하여 가져옵니다. 실행 중인 가상 서버 인스턴스 내에서 액세스할 수 있는 엔드포인트에 GET 요청을 합니다. 다음 엔드포인트를 사용하여 인스턴스, 키 및 배치 그룹에 대한 메타데이터를 검색할 수 있습니다:

  • https://api.metadata.cloud.ibm.com/metadata/v1/instance
  • https://api.metadata.cloud.ibm.com/metadata/v1/keys
  • https://api.metadata.cloud.ibm.com/metadata/v1/placement_groups

메타데이터에 액세스하는 데 사용할 수 있는 모든 엔드포인트에 대한 자세한 내용은 메타데이터 서비스에서 반환한 데이터 요약을 참조하세요.

메타데이터 서비스는 서비스 IP에 대한 모든 요청을 가로챈 다음 특정 서비스로 라우팅하여 이러한 요청을 처리합니다. 메타데이터 서비스에 대한 요청의 일부로 ID 액세스 토큰을 포함해야 합니다.

컴퓨팅 리소스 ID

IBM Cloud 의 신뢰할 수 있는 프로필은 특정 계정 내에서 페더레이션된 사용자 또는 컴퓨팅 리소스가 API 키 없이도 해당 계정 내에서 작업할 수 있는 게이트웨이 역할을 하는 ID입니다. 컴퓨팅 리소스 ID는 컴퓨팅 리소스에서 실행 중인 애플리케이션에 대한 세분화된 권한 부여를 위해 신뢰할 수 있는 프로필을 사용할 수 있는 기능을 말합니다.

신뢰할 수 있는 프로필은 IAM 액세스 그룹의 구성원이 될 수 있으며 액세스 권한이 할당될 수 있고 직접 액세스 권한이 할당될 수도 있습니다. 특히 신뢰할 수 있는 프로필의 일부로 구성된 속성 집합으로 식별되는 ID 또는 리소스에 대해 특정 ID로 주어진 권한 집합을 사용하여 관리 작업을 하는 데 유용합니다.

신뢰할 수 있는 프로필은 IBM Cloud Identity and Access Management (IAM) 서비스를 통해 생성됩니다. 구체적으로 관리 > 액세스(IAM) 로 이동하여 신뢰할 수 있는 프로필을 선택한 다음 프로필 만들기를 클릭하면 됩니다. 자세한 정보는 신뢰 프로파일 작성을 참조하십시오.

신뢰할 수 있는 프로필을 사용하면 컴퓨팅 리소스에 대한 서비스 ID 또는 API 키를 만들 필요가 없습니다. 애플리케이션이 각 컴퓨팅 리소스에 대한 개별 인증 없이 IBM Cloud 서비스에 액세스할 수 있습니다.

사용자 데이터

인스턴스에서 액세스하는 메타데이터에는 사용자 데이터가 포함됩니다. 사용자 데이터는 인스턴스를 프로비저닝할 때 지정한 데이터이며, 다른 인스턴스를 프로비저닝할 때 사용할 수 있습니다. (VPC 인스턴스에 대한 클라우드 초기화에서 사용할 수 있는 것과 동일한 사용자 데이터입니다.) 예를 들어 데이터베이스 소프트웨어를 로드하기 위한 정보, 작업자 노드에 대한 사용자 정의 소프트웨어 또는 인스턴스를 초기화하는 방법에 대한 결정을 내리기 위한 정보가 사용자 데이터에서 제공됩니다. 자세한 정보는 사용자 데이터 에 대한 주제를 참조하십시오.

인스턴스 내에서 액세스하는 메타데이터는 어떤 암호화 방법으로도 보호되지 않습니다. 인스턴스 및 메타데이터 서비스에 대한 액세스 권한이 있는 사용자는 잠재적으로 해당 메타데이터를 볼 수 있습니다. 예방조치로서 비밀번호 또는 고객 암호화 키와 같은 중요한 데이터는 사용자 데이터로 저장하지 마십시오.

데이터 보안

IBM에서는 사용자 데이터의 안전을 보장하기 위해 예방조치를 수행합니다. 메타데이터는 사용자에게 액세스 권한이 있는 인스턴스에서만 검색됩니다. 여러 인스턴스에 공통된 데이터는 검색되지만 다른 인스턴스의 특정 IP 주소는 노출되지 않습니다.

메타데이터 서비스의 기본 프로토콜은 HTTP 입니다. 메타데이터 서비스에 대한 호출은 호출이 시작된 컴퓨팅 호스트를 떠나기 전에 보안이 유지됩니다. 데이터가 계산 호스트에서 나가기 전에 보안 프로토콜을 사용하여 데이터를 랩핑합니다. 메타데이터 서비스에 대한 초기 호출은 HTTP 연결을 통해 이루어집니다. 호출의 목적은 메타데이터 서비스에 액세스하기 위해 ID 토큰을 획득하는 것입니다. 이러한 서비스는 링크-로컬 URL 을 사용합니다. 비보안 연결이 표시되더라도 VPC 컴퓨팅 서비스는 토큰 및 메타데이터 서비스를 보호하기 위해 추가 조치를 취합니다.

메타데이터 서비스는 HTTP 보안 프로토콜( HTTPS )을 사용하도록 구성할 수도 있습니다. 자세한 정보는 UI를 사용하여 보안 액세스 사용 을 참조하십시오.

메타데이터 서비스는 민감한 데이터를 위한 것이 아닙니다. 서비스 엔드포인트는 인스턴스의 모든 프로세스에 열려 있습니다. 이 서비스를 통해 노출되는 정보는 가상 서버 인스턴스 내에서 실행 중인 모든 애플리케이션에 공유되는 정보로 간주됩니다.

취할 수 있는 추가 보안 조치에 대한 자세한 내용은 메타데이터 서비스의 보안 모범 사례를 참조하세요.

활동 추적 이벤트

메타데이터 서비스에 API 요청을 하면 감사에 사용할 수 있는 이벤트가 트리거됩니다. 자세한 내용은 메타데이터 서비스 이벤트를 참조하세요.

다음 단계