지원 세션

​

지원 세션이란

• 세션 gateway: troubleshooter에 내장된 인증 API입니다. POST /v1/clctl/session/enable, POST /v1/clctl/session/disable, GET /v1/clctl/session/status를 제공합니다. 모든 호출에는 이메일이 연산자 허용 목록에 등록된 단기 OIDC ID 토큰이 필요합니다.
• 로컬 세션 파일: Linux VM 설치 환경에서 root 액세스로 호스트에 기록됩니다.

​

세션 활성화 및 비활성화

CONNECTOR_NAMESPACE='clicklink'   # init 시 선택한 커넥터 네임스페이스
kubectl -n "${CONNECTOR_NAMESPACE}" port-forward statefulset/clicklink-connector-troubleshooter 8443:8443

clicklink clctl troubleshoot session enable \
  --gateway-url http://localhost:8443 \
  --duration 4h \
  --reason "<ticket reference>"

clicklink clctl troubleshoot session status --gateway-url http://localhost:8443
clicklink clctl troubleshoot session disable --gateway-url http://localhost:8443

sudo clicklink clctl troubleshoot session enable --duration 4h --reason "<ticket reference>"
sudo clicklink clctl troubleshoot session status
sudo clicklink clctl troubleshoot session disable

clicklink clctl troubleshoot gateway trust \
  --gateway-url https://<vm-host>:8443 \
  --gateway-fingerprint <sha256-fingerprint>

​

세션 만료

​

연산자 허용 목록

• Kubernetes: values 오버레이에서 clctl.gateway.allowedOperators를 설정하십시오. 차트가 이 목록을 ConfigMap에 렌더링하므로, values를 변경하고 helm upgrade를 실행하면 파드를 재시작하지 않고도 허용 목록을 교체할 수 있습니다.
• Linux VM: 허용 목록은 /etc/clicklink/allowed-operators.txt에 저장되며, 제공한 연산자 이메일을 바탕으로 clicklink clctl init이 작성합니다.

​

세션 중 연산자가 수행할 수 있는 작업

​

감사 로그

{
  "timestamp": "2026-06-22T22:30:00.123456789Z",
  "command_id": "11111111-2222-4333-8444-555555555555",
  "submitted_by": "<org-id>",
  "command_type": "sql",
  "command_text": "SELECT database, table, active, count() FROM system.parts GROUP BY ALL",
  "instance_id": "analytics",
  "status": "completed",
  "duration_ms": 42,
  "output_lines": 12
}

CONNECTOR_NAMESPACE='clicklink'   # the connector namespace you chose at init
kubectl -n "${CONNECTOR_NAMESPACE}" exec statefulset/clicklink-connector-troubleshooter -- \
  /clicklink clctl troubleshoot audit tail

​

민감 정보 삭제

​

관련 페이지

• Architecture: 커넥터가 설정하는 모든 연결과 세션 관련 데이터 흐름을 설명합니다.
• 구성: gateway, 허용 목록 및 민감 정보 삭제 설정을 설명합니다.
• FAQ: 취소, 감사 및 데이터 egress 관련 질문에 간략히 답변합니다.