복합 ID
GitLab Duo Agent Platform에서 인증과 권한 부여를 위한 복합 ID 메커니즘을 설명합니다.
히스토리 GitLab 18.3에서 duo_workflow_use_composite_identity 라는 기능 플래그 와 함께 도입 되었습니다. 기본적으로 비활성화됩니다. GitLab 18.6에서 기본적으로 활성화 되었습니다. GitLab 18.8에서 일반 공개 되었습니다. 복합 ID가 GitLab Duo Agent Platform에 자동으로 포함되고 복합 ID를 켜거나 끄는 설정이 GitLab 18.9에서 제거 되었습니다. GitLab 19.3에서 duo_workflow_use_composite_identity 기능 플래그가 제거 되었습니다. 복합 ID는 두 가지 ID를 단일 토큰으로 결합하는 인증 및 권한 부여 메커니즘입니다: 서비스 계정: 실제 작업을 수행하는 에이전트. 사람 사용자: 요청을 시작한 사람. 서비스 계정은 수행하는 작업을 사람 사용자가 시작하므로 복합 ID를 가집니다. 예외는 사람 사용자 없이 실행되는 예약된 자동화 입니다. 복합 ID는 GitLab Duo Agent Platform에 자동으로 포함됩니다. 이 이중 ID 접근 방식은 중요한 문제를 해결합니다. 에이전트는 자신을 트리거한 사용자의 액세스 권한이나 서비스 계정에 부여된 액세스 권한을 넘지 않는 범위에서 동작해야 하며, 동시에 해당 작업이 사람 사용자가 직접 수행한 것이 아니라 에이전트가 수행했음을 명확히 보여주는 별개의 ID를 유지해야 합니다. 복합 ID가 중요한 이유 # 복합 ID는 다음을 보장하는 데 도움이 되기 때문에 중요합니다: 추적 가능성: 모든 에이전트 활동이 서비스 계정에 명확하게 귀속되므로, 감사 로그 및 커밋 히스토리에서 자동화된 작업을 쉽게 식별할 수 있습니다. 보안: 에이전트는 서비스 계정과 트리거한 사용자가 모두 수행할 수 있는 작업만 수행할 수 있습니다. 이 교차 액세스는 권한 상승을 방지합니다. 책임: 사람 사용자의 ID가 토큰에 내장되어, 에이전트 작업을 시작한 사람에게 연결하는 감사 추적을 만듭니다. 예를 들어 에이전트에게 코드에 대한 테스트를 만들어 달라고 요청하면, 그 결과 커밋은 서비스 계정이 사용자를 대신하여 만든 것으로 표시됩니다. 복합 ID가 사용되는 곳 # 복합 ID는 플로와 에이전트가 러너에서 실행될 때 사용됩니다. 다음이 여기에 해당합니다: 파운데이셔널 플로. 커스텀 플로. 외부 에이전트. api/v4/ai/duo_workflows/workflows 엔드포인트를 통해 시작된 모든 플로. 복합 ID는 다음에는 적용되지 않습니다. UI 및 IDE의 GitLab Duo Agentic Chat. 예약된 자동화가 실행하는 플로. 이러한 플로는 전용 서비스 계정으로 실행되며, 그 계정의 역할이 플로가 수행할 수 있는 작업의 유일한 제한입니다. 자세한 내용은 예약된 자동화의 서비스 계정 을 참고합니다. 복합 ID 작동 방식 # 요청을 인증하는 토큰은 두 가지 ID의 복합체입니다: 기본 작성자: 에이전트 또는 플로를 시작한 사람 사용자. 사람 사용자의 id 는 동적 범위 를 사용하여 토큰의 범위에 포함됩니다. 보조 작성자: 서비