에이전트 상태, 관계, 종속 항목, 정책 준수에 관한 질문에 답변하려면 에이전트 데이터, 트래픽 데이터, 기타 리소스 데이터를 상호 연관시키는 쿼리를 실행하면 됩니다. 결과는 탐색할 수 있는 토폴로지 그래프로 표시됩니다.
토폴로지 그래프는 다음 작업을 수행하는 데 도움이 됩니다.
- 리소스 관계 매핑: MCP 서버, 기본 인프라, 엔드포인트, 기술, ID 등 에이전트와 연결된 데이터를 시각화합니다.
- Agent Registry 등록 격차 식별: Agent Registry에 등록되지 않은 검색된 컴퓨팅 워크로드를 식별합니다.
- 정책 규정 준수 검증: Security Command Center에서 식별한 취약점과 보안 문제를 식별합니다.
- 변경사항의 영향 분석: 액세스 정책, 엔드포인트 사용자 인증 정보 또는 에이전트 리소스가 종속된 인프라의 변경사항이 미치는 영향을 평가합니다.
추천 쿼리를 실행하거나, 추천 쿼리를 맞춤설정하거나, 자체 맞춤 쿼리를 만들 수 있습니다.
시작하기 전에
설정하려는 Cloud de Confiance 프로젝트를 식별합니다.
Security Command Center에서 제공하는 보안 및 규정 준수 데이터는 Cloud de Confiance by S3NS 조직의 프로젝트에서만 사용할 수 있습니다. 프로젝트를 조직으로 마이그레이션하려면 마이그레이션 안내를 참고하세요.
쿼리할 리소스 데이터를 제공하는 서비스를 설정합니다.
빌드 출처 기록과 같은 소프트웨어 공급망 데이터를 보려면 Developer Connect 인사이트를 구성하세요.
Agent Registry에 등록된 에이전트 리소스의 데이터를 보려면 Agent Registry를 설정하고 에이전트 리소스를 등록하세요.
에이전트 트래픽을 확인하려면 AI 애플리케이션을 계측하세요.
보안 및 규정 준수 데이터를 보려면 보안 및 규정 준수 데이터에 대해 Security Command Center를 설정하세요. 조직 수준에서 Security Command Center를 활성화하고 사용하려는 기능을 구성합니다. Security Command Center의 데이터 쿼리는 프리미엄 및 엔터프라이즈 등급에서만 사용할 수 있습니다.
아직 사용 설정되지 않은 API가 있으면 App Hub, 앱 토폴로지, Cloud 애셋 인벤토리, Observability API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면
serviceusage.services.enable권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기VPC 서비스 제어 경계에서 서비스를 보호하는 경우 앱 토폴로지와 기본 데이터를 제공하는 서비스를 포함하도록 경계를 업데이트합니다. 자세히 알아보기
필요한 역할
토폴로지 그래프를 보는 데 필요한 권한을 얻으려면 관리자에게 앱 토폴로지를 사용하려는 프로젝트에 대한 앱 토폴로지 뷰어 (roles/apptopology.viewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 토폴로지 그래프를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
토폴로지 그래프를 보려면 다음 권한이 필요합니다.
-
발견된 리소스 데이터 가져오기:
apptopology.discoveredResourcesTopologies.generate -
리소스 데이터 가져오기:
apptopology.sreDomainTopologies.generate
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
쿼리 정보
앱 토폴로지 쿼리는 다음과 같은 여러 구성요소로 구성됩니다.
노드 - 검색되거나 등록된 Cloud de Confiance by S3NS 리소스입니다. 노드의 예는 다음과 같습니다.
- Compute Engine VM
- Artifact Registry의 컨테이너 이미지
- 상담사
- Cloud Monitoring 알림
- AI 애플리케이션
- 취약점
쿼리 빌더는 서비스를 기준으로 노드를 그룹화합니다.
Where 절: 노드에 적용되는 필터로, 노드의 특정 속성을 기반으로 쿼리를 구체화합니다.
연결: 두 노드 간의 방향 관계입니다. 연결은 컨텍스트를 인식하며 선택한 노드 유형에 대해서만 유효한 관계를 사용할 수 있습니다. 예를 들면 다음과 같습니다.
contained insends traffic toownsdepends on
다음 쿼리 예시는 특정 취약점이 있는 배포를 검색합니다.
질문은 조사의 주요 노드를 설정합니다.
- Agent
- Vulnerability
연결 contains은 노드 관계를 나타냅니다.
Agent contains Vulnerability
Where 절은 취약점 결과를 필터링하여 특정 CVE를 표시합니다.
Where Id = CVE-2026-24061
추천 쿼리 사용 또는 맞춤설정
앱 토폴로지에서는 변경 없이 사용할 수 있는 쿼리 제안을 제공하며, 특정 요구사항에 맞게 이러한 제안을 맞춤설정할 수도 있습니다.
Cloud de Confiance 콘솔에서 토폴로지 페이지로 이동합니다.
프로젝트 선택기에서 에이전트가 포함된 프로젝트를 선택합니다.
빠른 쿼리에서 쿼리를 클릭하여 쿼리 구성요소를 미리 봅니다.
쿼리를 사용하려면 추천 사용을 클릭합니다. 쿼리가 표시 섹션에 표시됩니다.
쿼리를 변경하려면 구성요소를 추가, 수정 또는 삭제하세요.
- 쿼리에 구성요소를 추가하려면 노드 옆에 있는 더하기 아이콘()을 클릭합니다.
- 구성요소를 삭제하려면 닫기 아이콘 을 클릭합니다.
Where절의 값을 변경하려면 값을 클릭합니다.
실행취소 를 클릭하여 변경사항을 되돌리거나 다시 실행 을 클릭하여 실행취소로 되돌린 변경사항을 다시 적용할 수 있습니다.
쿼리를 빌드하면 사용 가능한 노드, 필터, 연결이 업데이트됩니다.
쿼리 수정을 완료하면 쿼리 실행을 클릭합니다. 쿼리 결과에 Cloud de Confiance 검색된 리소스 또는 Agent Registry에 등록된 리소스가 포함된 경우 토폴로지 그래프가 표시됩니다.
문자열이나 개수와 같은 데이터 유형만 포함된 쿼리 결과에는 그래프를 사용할 수 없습니다.
결과를 바탕으로 쿼리를 수정한 다음 쿼리 실행을 클릭하여 토폴로지 그래프를 업데이트할 수 있습니다.
토폴로지 그래프를 살펴봅니다. 그래프에는 쿼리와 일치하는 리소스와 리소스 간의 관계가 표시됩니다.
- 아이콘은 노드, 검색되고 등록된 리소스, 리소스 유형을 나타냅니다.
- 선은 연결, 즉 노드 간의 관계를 나타냅니다.
다음과 같은 방법으로 토폴로지와 상호작용할 수 있습니다.
- 확대/축소하거나 노드 위치를 변경하여 시각화를 변경합니다.
- 두 노드 사이의 연결 선 위로 마우스를 가져가 연결 라벨을 확인합니다.
- 노드 또는 연결을 선택하여 정보를 확인합니다.
- 패널 전환 을 클릭하여 쿼리 패널을 숨기거나 표시합니다.
결과가 없으면 쿼리를 수정해 보세요.
맞춤 쿼리 만들기
커스텀 쿼리를 만들려면 다음 단계에 따라 새 쿼리를 시작하거나 기존 추천 쿼리를 맞춤설정하세요.
Cloud de Confiance 콘솔에서 토폴로지 페이지로 이동합니다.
프로젝트 선택기에서 에이전트가 포함된 프로젝트를 선택합니다.
쿼리 빌더에서 를 클릭하고 리소스 또는 발견 사항을 쿼리의 기본 노드로 선택한 다음 계속을 클릭합니다.
쿼리를 상세하게 조정하려면 필터 또는 연결의 전환 버튼을 클릭하여 선택한 노드에 대해 사용 설정합니다. 사용 설정한 각 필터의 값을 정의합니다.
쿼리를 변경하려면 구성요소를 추가, 수정 또는 삭제하세요.
- 쿼리에 구성요소를 추가하려면 노드 옆에 있는 더하기 아이콘()을 클릭합니다.
- 구성요소를 삭제하려면 닫기 아이콘 을 클릭합니다.
Where절의 값을 변경하려면 값을 클릭합니다.
실행취소 를 클릭하여 변경사항을 되돌리거나 다시 실행 을 클릭하여 실행취소로 되돌린 변경사항을 다시 적용할 수 있습니다.
쿼리를 빌드하면 사용 가능한 노드, 필터, 연결이 업데이트됩니다.
쿼리 수정을 완료하면 쿼리 실행을 클릭합니다. 쿼리 결과에 Cloud de Confiance 검색된 리소스 또는 Agent Registry에 등록된 리소스가 포함된 경우 토폴로지 그래프가 표시됩니다.
문자열이나 개수와 같은 데이터 유형만 포함된 쿼리 결과에는 그래프를 사용할 수 없습니다.
결과를 바탕으로 쿼리를 수정한 다음 쿼리 실행을 클릭하여 토폴로지 그래프를 업데이트할 수 있습니다.
토폴로지 그래프를 살펴봅니다. 그래프에는 쿼리와 일치하는 리소스와 리소스 간의 관계가 표시됩니다.
- 아이콘은 노드, 검색되고 등록된 리소스, 리소스 유형을 나타냅니다.
- 선은 연결, 즉 노드 간의 관계를 나타냅니다.
다음과 같은 방법으로 토폴로지와 상호작용할 수 있습니다.
- 확대/축소하거나 노드 위치를 변경하여 시각화를 변경합니다.
- 두 노드 사이의 연결 선 위로 마우스를 가져가 연결 라벨을 확인합니다.
- 노드 또는 연결을 선택하여 정보를 확인합니다.
- 패널 전환 을 클릭하여 쿼리 패널을 숨기거나 표시합니다.
쿼리에는 일부 제한사항이 적용됩니다. 결과가 없으면 쿼리를 수정해 보세요.
다음 단계
- Agent Registry에서 발견된 에이전트를 등록합니다.