CLI에서 아이덴티티 접근 리뷰하기
Teleport v18.11요약
tctl access-review는 누가 어떤 리소스에 접근할 수 있는지, 무엇이 그 접근을 부여하는지, 그리고 선택적으로 그 접근이 실제로 사용되었는지를 알려 줍니다. 모든 리뷰의 범위는 --query로 지정합니다.
tctl access-review는 누가 어떤 리소스에 접근할 수 있는지, 무엇이 그 접근을 부여하는지,
그리고 선택적으로 그 접근이 실제로 사용되었는지를 알려 줍니다. 역할 및 접근 목록 부여 내역을 리뷰하고
인증하거나, "누가 이 데이터베이스에 접근할 수 있는가"에 답하거나, 사용되지 않는 상시 권한을 찾는 데 사용합니다.
모든 리뷰의 범위는 --query로 지정합니다. --query는 Access Graph access_path 모델에 대한
SQL SELECT 문입니다. 쿼리는 리뷰가 다루는 아이덴티티와 리소스를 정의하며, 결과는 각 아이덴티티가
각 리소스에 대해 가진 접근과 그 접근이 부여되는 방식을 설명합니다. 결과에는 접근 경로만 포함되며,
접근 목록을 통해 접근 권한을 얻는 대신 접근 목록을 _리뷰_할 수 있는 사람과 같은 다른 관계는
나열하지 않습니다.
사전 요구사항#
공통 사전 요구사항과 CLI가 Access Graph에 인증하는 방법은
명령줄에서 사용하는 Identity Security를 참조합니다. 이 명령에는 Access Graph v1.30.1 이상이
필요하며, tctl access-review에는 --query가 필요합니다.
Identity Activity Center는 선택 사항입니다. 이를 사용하지 않아도 리뷰는 접근 경로와 부여 내역을 보고하지만, 활동 칼럼은 생략되며 출력에 그 이유가 표시됩니다.
접근 리뷰#
--query로 리뷰 범위를 지정합니다. 쿼리는 access_path에 대한 SQL SELECT 문이며,
WHERE 절에서 범위를 좁힙니다. 예를 들어 한 사용자가 접근할 수 있는 모든 항목을 리뷰하려면
다음과 같이 합니다.
$ tctl access-review --query "SELECT * FROM access_path WHERE identity = 'alice'"
identity는 저장된 이름 또는 별칭으로 사용자나 봇을 일치시키며, SSO 사용자의 경우 보통
사용자 이름이나 이메일입니다. resource는 이름으로 리소스를 일치시키고, identity_group은 접근을
부여하는 주체(역할, 접근 목록 또는 접근 요청)를 일치시킵니다(출력에서 Granted By로 표시됨).
=와 IN은 정확히, 대소문자를 구분하여 일치시킵니다. 정확한 이름이 확실하지 않으면 ILIKE를 사용하여
대소문자를 구분하지 않거나 접두사로 일치시킵니다.
일반적인 리뷰 패턴#
| 목표 | 쿼리 |
|---|---|
| 한 사용자가 접근할 수 있는 모든 항목 | SELECT * FROM access_path WHERE identity = 'alice' |
| 리소스에 접근할 수 있는 사용자 | SELECT * FROM access_path WHERE resource ILIKE 'prod-db%' |
| 역할이 부여하는 항목과 대상 | SELECT * FROM access_path WHERE identity_group IN ('prod-db-admin') |
| 접근 목록이 부여하는 항목과 대상 | SELECT * FROM access_path WHERE identity_group IN ('Prod Admins') |
| 역할을 통해 리소스에 접근할 수 있는 이유 | SELECT * FROM access_path WHERE resource = 'prod-db' AND identity_group IN ('prod-db-admin') |
역할과 접근 목록은 모두 identity_group 노드입니다. 텍스트 출력은 부여 주체의 종류를 표시하지 않습니다.
role과 access_list를 구분하려면 --format=json(또는 yaml)을 사용하고
granted_by[].node.sub_kind를 읽습니다. 이와 같이 부여 주체를 통해 리뷰 범위를 지정할 때는 결과가
다루는 범위와 다루지 않는 범위에 유의합니다.
쿼리 범위 이해를 참조합니다.
기본적으로 출력은 각 아이덴티티의 리소스, 확정된 접근 수준, 주요 부여 주체(Granted By 칼럼),
부여 개수를 요약합니다. --detailed를 추가하면 각 리소스를 부여별로, 그리고 각 부여가 기여하는 수준별로
나누어 표시합니다.
$ tctl access-review --query "<query>" --detailed
Granted By는 접근을 부여하는 아이덴티티 그룹(역할, 접근 목록 또는 접근 요청)이며, 쿼리에서
identity_group으로 필터링하는 대상입니다.
| 플래그 | 설명 |
|---|---|
--query |
필수. 리뷰할 아이덴티티의 범위를 지정하는 access_path에 대한 SQL SELECT 문입니다. |
--from |
이 시각 이후의 활동을 표시합니다. RFC3339, YYYY-MM-DD 또는 24h, 7d와 같은 기간을 사용할 수 있습니다. 기본값은 24시간 전입니다. |
--to |
활동의 상한입니다. 기본값은 현재입니다. |
--no-activity |
활동 조회를 건너뛰고 활동 칼럼을 숨겨 리뷰를 더 빠르게 수행합니다. --from/--to보다 우선합니다. |
--detailed |
요약 개수 대신 각 부여를 개별 접근 수준과 함께 표시합니다. |
--limit |
반환할 최대 아이덴티티 수입니다. 기본값: 50. |
--format |
text, json, yaml. |
텍스트 출력에서 *는 자동으로 만료되는 접근 또는 임시 부여를 나타냅니다.
쿼리 범위 이해#
결과는 쿼리가 생성하는 경로에서만 도출됩니다. 역할, 접근 목록 또는 기타 아이덴티티 그룹과 같은 특정 노드를 통해 리뷰 범위를 지정하면, 결과에는 해당 노드를 통과하는 경로만 표시되며 일치한 아이덴티티가 일치한 리소스에 대해 가진 모든 경로가 표시되는 것은 아닙니다.
예를 들어 다음 쿼리는 "Prod Admins 멤버십이 무엇을 누구에게 부여하는가"에 답합니다.
$ tctl access-review --query "SELECT * FROM access_path WHERE identity_group IN ('Prod Admins')"
이 쿼리는 해당 멤버 각각의 전체 접근 권한을 알려 주지 않습니다. 멤버가 다른 역할, 다른 접근 목록 또는
승인된 접근 요청을 통해 같은 리소스에 접근할 수도 있으며, 이러한 경로는 Prod Admins로 범위를 지정한
쿼리에서는 보이지 않습니다.
따라서 범위를 지정한 쿼리에서 어떤 아이덴티티가 리소스에 접근하는 것으로 나타나면, identity와
resource로 직접 범위를 지정한 후속 쿼리로 해당 아이덴티티의 해당 리소스에 대한 전체 접근 권한을
확인하는 것이 좋습니다.
$ tctl access-review --query "SELECT * FROM access_path WHERE identity = 'alice' AND resource = 'prod-server'"
이 쿼리는 alice에서 prod-server로 이어지는 모든 경로를 각 경로를 뒷받침하는 부여 내역과 함께
반환합니다. 접근 권한을 추가하거나 제거하기 전에 확인해야 할 기준 뷰입니다.
접근 활동 표시#
클러스터에 Identity Activity Center가 활성화되어 있으면
tctl access-review는 기본적으로 최근 24시간 동안의 활동 칼럼, 즉 각 접근이 얼마나 자주 사용되었는지와
마지막으로 사용된 시점을 표시합니다. --from(및 선택적으로 --to)으로 기간을 넓힙니다.
$ tctl access-review --query "<query>" --from=30d
활동 조회를 완전히 건너뛰고 누가 무엇에 접근할 수 있는지에 대한 구조 중심의 빠른 리뷰를 하려면
--no-activity를 전달합니다.
활동 횟수는 Teleport 세션 시작 이벤트에서 가져오므로, Teleport 세션(SSH, 데이터베이스, 쿠버네티스, 애플리케이션, 데스크톱)을 통해 접근한 리소스만 포함합니다. AWS, Okta, GitLab 리소스와 같이 세션 밖에서 사용된 리소스는 접근이 사용되더라도 활동 칼럼이 비어 있습니다.
AI 에이전트와 함께 tctl access-review 사용#
AI 에이전트가 이 명령을 실행하도록 하려면 해당하는 Agent Skill을 설치합니다.
$ npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-access-review
다음 단계#
문제 해결#
이 클러스터에서 access-review를 사용할 수 없음#
대개 Identity Security가 활성화되어 있지 않거나 이 클러스터에서 access-review 엔드포인트를 아직 사용할 수 없다는 의미입니다. Identity Security가 활성화되어 있는지, 그리고 클러스터가 v18.11.0 이상인지 확인합니다.
column "..." not found#
WHERE 절이 access_path에 없는 칼럼을 참조하고 있습니다. 쿼리할 수 있는 칼럼에는 identity,
resource, identity_group, source, id가 있습니다. 예를 들어 사용자는 identity_name이 아니라
identity로 필터링합니다.
접근 권한 없음#
결과가 비어 있는 경우는 실제로 "접근 권한 없음"인 경우보다 이름 불일치인 경우가 더 많습니다. =와 IN은
저장된 이름을 정확히, 대소문자를 구분하여 일치시키므로, ILIKE(예: resource ILIKE '%db%')로 다시
실행하고 출력에서 이름을 확인한 뒤 정확하게 범위를 지정합니다.