InfoGrab DocsInfoGrab Docs

CLI로 활동 조사하기

요약

tctl investigate는 Teleport Identity Security가 Teleport 및 연동 서비스에서 집계한 아이덴티티 활동 로그를 검색합니다. 공통 사전 요구사항과 CLI가 Access Graph에 인증하는 방법은 명령줄에서 사용하는 Identity Security를 참조하십시오.

tctl investigate는 Teleport Identity Security가 Teleport 및 연동 서비스에서 집계한 아이덴티티 활동 로그를 검색합니다. 웹 UI의 Investigate 화면과 같은 데이터를 사용합니다. 누가, 어디서, 언제, 무엇을 했는지 추적하는 데 사용합니다.

사전 요구사항#

공통 사전 요구사항과 CLI가 Access Graph에 인증하는 방법은 명령줄에서 사용하는 Identity Security를 참조하십시오. 이 명령에는 Access Graph v1.28.0 이상과 Identity Activity Center가 필요합니다.

패싯으로 탐색하기#

일반적인 조사는 넓게 시작하여 좁혀 나갑니다. 먼저 패싯으로 데이터의 전체 모양을 파악하고, 무엇으로 필터링할지 정한 다음, 조건에 맞는 이벤트를 가져옵니다.

tctl investigate를 실행하면 이벤트와 함께 일치하는 데이터의 패싯 요약이 반환됩니다. 이벤트를 가져오기 전에 넓은 검색을 좁히려면 패싯만 요청하십시오.

$ tctl investigate --from=24h --facets-only

패싯은 각 필드(사용자, 이벤트 유형, 리소스, 소스, IP 등)의 상위 값을 보여 주므로, 다음에 무엇으로 필터링할지 확인할 수 있습니다.

구조화된 플래그로 필터링하기#

반복 사용할 수 있는 포함 필터를 조합합니다. 어떤 필터든 앞에 exclude-를 붙이면 제외 조건이 됩니다.

$ tctl investigate --user=alice@example.com --status=failure --from=7d
$ tctl investigate --event-type=session.start --exclude-source=okta
플래그 설명
--user 사용자(사용자는 이메일, 봇은 ID)입니다. 반복 사용할 수 있습니다.
--event-type 이벤트 유형입니다(예: session.start). 반복 사용할 수 있습니다.
--resource, --resource-kind 대상 리소스와 종류(ssh, kube, …)입니다. 반복 사용할 수 있습니다.
--status success 또는 failure입니다. 반복 사용할 수 있습니다.
--source 이벤트 소스입니다. 반복 사용할 수 있습니다.
--ip, --country, --city, --region 접속 출처 필터입니다. 반복 사용할 수 있습니다.
--from, --to 시간 범위입니다. 기본값은 1d부터 now까지입니다.
--limit, --order 결과 수 제한(기본값 100)과 시간순 정렬(asc/desc)입니다.
--all-facets, --show-unmatched 패싯 출력을 확장합니다.
--format text, json, yaml.

모든 구조화된 플래그에는 대응하는 --exclude-<flag>가 있습니다. 전체 목록(AWS, GitHub, Okta, Teleport 클러스터, 토큰, 사용자 에이전트 필터)은 CLI 참조를 확인하십시오.

원시 쿼리 실행하기#

구조화된 플래그로 만들 수 없는 표현식에는 원시 Lucene 쿼리를 전달합니다. --query는 구조화된 필터 플래그와 함께 사용할 수 없습니다.

$ tctl investigate --query 'identity_id:"alice@example.com" AND NOT status:"failure"'

백엔드에 연결하지 않고 플래그 조합이 만들어 낼 쿼리를 미리 확인할 수 있습니다.

$ tctl investigate --user=alice@example.com --status=failure --print-query

위치로 필터링하기#

한 지점을 중심으로 한 반경(킬로미터) 안으로 결과를 제한합니다. 세 개의 지리 플래그를 모두 함께 지정해야 합니다.

$ tctl investigate --latitude=37.8044 --longitude=-122.2712 --radius=25

AI 에이전트와 함께 tctl investigate 사용하기#

Tip

AI 에이전트가 이 명령을 실행하도록 하려면 대응하는 Agent Skill을 설치하십시오.

$ npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-investigate

다음 단계#

문제 해결#

--query is mutually exclusive with structured filter flags#

--query 또는 구조화된 플래그(--user, --event-type, …) 중 하나만 사용하고, 둘을 함께 사용하지 마십시오. 오류에 표시된 플래그를 제거하거나, 해당 조건을 원시 쿼리에 포함하십시오.

geo filter requires all of --latitude, --longitude, and --radius#

위치 필터에는 세 플래그가 모두 필요합니다. 빠진 플래그를 지정하거나, 위치 필터 없이 검색하려면 세 플래그를 모두 제거하십시오.

CLI로 활동 조사하기

Teleport v18.11
원문 보기

요약

tctl investigate는 Teleport Identity Security가 Teleport 및 연동 서비스에서 집계한 아이덴티티 활동 로그를 검색합니다. 공통 사전 요구사항과 CLI가 Access Graph에 인증하는 방법은 명령줄에서 사용하는 Identity Security를 참조하십시오.

tctl investigate는 Teleport Identity Security가 Teleport 및 연동 서비스에서 집계한 아이덴티티 활동 로그를 검색합니다. 웹 UI의 Investigate 화면과 같은 데이터를 사용합니다. 누가, 어디서, 언제, 무엇을 했는지 추적하는 데 사용합니다.

사전 요구사항#

공통 사전 요구사항과 CLI가 Access Graph에 인증하는 방법은 명령줄에서 사용하는 Identity Security를 참조하십시오. 이 명령에는 Access Graph v1.28.0 이상과 Identity Activity Center가 필요합니다.

패싯으로 탐색하기#

일반적인 조사는 넓게 시작하여 좁혀 나갑니다. 먼저 패싯으로 데이터의 전체 모양을 파악하고, 무엇으로 필터링할지 정한 다음, 조건에 맞는 이벤트를 가져옵니다.

tctl investigate를 실행하면 이벤트와 함께 일치하는 데이터의 패싯 요약이 반환됩니다. 이벤트를 가져오기 전에 넓은 검색을 좁히려면 패싯만 요청하십시오.

$ tctl investigate --from=24h --facets-only

패싯은 각 필드(사용자, 이벤트 유형, 리소스, 소스, IP 등)의 상위 값을 보여 주므로, 다음에 무엇으로 필터링할지 확인할 수 있습니다.

구조화된 플래그로 필터링하기#

반복 사용할 수 있는 포함 필터를 조합합니다. 어떤 필터든 앞에 exclude-를 붙이면 제외 조건이 됩니다.

$ tctl investigate --user=alice@example.com --status=failure --from=7d
$ tctl investigate --event-type=session.start --exclude-source=okta
플래그 설명
--user 사용자(사용자는 이메일, 봇은 ID)입니다. 반복 사용할 수 있습니다.
--event-type 이벤트 유형입니다(예: session.start). 반복 사용할 수 있습니다.
--resource, --resource-kind 대상 리소스와 종류(ssh, kube, …)입니다. 반복 사용할 수 있습니다.
--status success 또는 failure입니다. 반복 사용할 수 있습니다.
--source 이벤트 소스입니다. 반복 사용할 수 있습니다.
--ip, --country, --city, --region 접속 출처 필터입니다. 반복 사용할 수 있습니다.
--from, --to 시간 범위입니다. 기본값은 1d부터 now까지입니다.
--limit, --order 결과 수 제한(기본값 100)과 시간순 정렬(asc/desc)입니다.
--all-facets, --show-unmatched 패싯 출력을 확장합니다.
--format text, json, yaml.

모든 구조화된 플래그에는 대응하는 --exclude-<flag>가 있습니다. 전체 목록(AWS, GitHub, Okta, Teleport 클러스터, 토큰, 사용자 에이전트 필터)은 CLI 참조를 확인하십시오.

원시 쿼리 실행하기#

구조화된 플래그로 만들 수 없는 표현식에는 원시 Lucene 쿼리를 전달합니다. --query는 구조화된 필터 플래그와 함께 사용할 수 없습니다.

$ tctl investigate --query 'identity_id:"alice@example.com" AND NOT status:"failure"'

백엔드에 연결하지 않고 플래그 조합이 만들어 낼 쿼리를 미리 확인할 수 있습니다.

$ tctl investigate --user=alice@example.com --status=failure --print-query

위치로 필터링하기#

한 지점을 중심으로 한 반경(킬로미터) 안으로 결과를 제한합니다. 세 개의 지리 플래그를 모두 함께 지정해야 합니다.

$ tctl investigate --latitude=37.8044 --longitude=-122.2712 --radius=25

AI 에이전트와 함께 tctl investigate 사용하기#

Tip

AI 에이전트가 이 명령을 실행하도록 하려면 대응하는 Agent Skill을 설치하십시오.

$ npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-investigate

다음 단계#

문제 해결#

--query is mutually exclusive with structured filter flags#

--query 또는 구조화된 플래그(--user, --event-type, …) 중 하나만 사용하고, 둘을 함께 사용하지 마십시오. 오류에 표시된 플래그를 제거하거나, 해당 조건을 원시 쿼리에 포함하십시오.

geo filter requires all of --latitude, --longitude, and --radius#

위치 필터에는 세 플래그가 모두 필요합니다. 빠진 플래그를 지정하거나, 위치 필터 없이 검색하려면 세 플래그를 모두 제거하십시오.