문서로 돌아가기핵심 개념

권한

Okou가 할 수 있는 일을 커넥터별로 제어 — 기본값, 승인, 감사, 취소.

최종 업데이트 2026년 9월 17일 · 3 min read

커넥터 접근은 서로 분리된 세 개의 층으로 이루어집니다. 구성원의 연결, 에이전트의 인가, 그리고 그 에이전트에 부여된 이름 있는 권한입니다. 서비스를 연결했다고 해서 모든 에이전트에게 모든 동작이 조용히 허용되는 것은 아닙니다.

연결, 인가, 권한

무엇을 통제하나
연결그 서비스에 어떤 구성원 계정 또는 자격 증명을 쓸 수 있는지.
에이전트 인가연결된 그 서비스를 어떤 에이전트가 쓸 수 있는지.
권한 부여그 에이전트가 어떤 이름 있는 동작을 요청할 수 있는지, 그리고 얼마 동안인지.

구성원별 자격 증명을 쓰는 서비스에서는 각자 자기 계정을 연결합니다. 공유 에이전트라도 그것을 실행하는 구성원의 연결 계정과 부여 내역을 통해 동작합니다. 동료의 받은편지함이나 토큰, 비공개 채팅 기록을 물려받지 않습니다.

접근 부여하기

에이전트가 갖고 있지 않은 커넥터 권한이 필요해지면 Okou가 권한 요청을 띄웁니다. Allow 또는 Deny를 고르기 전에 커넥터, 에이전트, 권한 이름, 사유를 확인하세요.

허용한 권한에는 제품에서 제공하는 기간 중 하나를 적용할 수 있습니다.

  • Allow for 1h
  • Allow for 24h
  • Allow for 7d
  • Allow always

기간이 정해진 부여가 만료되면 에이전트는 다시 요청해야 합니다. 권한 하나를 거부해도 계정 연결이 끊기거나 무관한 권한이 사라지지는 않습니다.

에이전트의 현재 커넥터 접근은 해당 에이전트의 인가 설정에서 관리합니다. 커넥터 접근 화면에서는 어떤 에이전트가 인가됐는지, 권한 상태가 허용·거부·혼합 중 무엇인지 볼 수 있습니다.

자격 증명 처리

OAuth 토큰과 직접 입력한 비밀 값은 플랫폼에 저장됩니다. 커넥터 요청에서는 방화벽이 네트워크 경계에서 자격 증명을 주입합니다. 비밀 값이 환경 변수 형태로 에이전트 코드에 노출되지 않습니다.

API 키, OAuth 토큰, 비밀번호, 클라이언트 시크릿을 채팅, 에이전트 지침, 워크플로 지침, 첨부 파일에 붙여 넣지 마세요. 대신 커넥터의 연결 흐름을 사용하세요.

구성원이 커넥터 연결을 해제하면 이후 Run에서 그 연결이 사라집니다. 에이전트 인가를 제거하면 그 에이전트는 커넥터를 쓸 수 없게 되고, 인가된 다른 에이전트는 그대로 유지됩니다.

승인의 경계

실제로 강제되는 경계는 커넥터의 이름 있는 권한 부여입니다. 모든 이메일, 게시물, 결제, 인프라 변경, 삭제가 언제나 같은 방식으로 멈출 것이라는 보장을 포괄적인 동작 범주에 기대지 마세요.

사람이 반드시 검토해야 하는 작업이라면:

  1. 읽기 또는 초안 권한만 부여하고, 커넥터가 따로 제공한다면 최종 쓰기·전송 권한은 거부하세요.
  2. 검토가 필요하다는 점을 에이전트나 워크플로 지침에 명시하세요.
  3. 마지막 동작은 사람에게 남기세요. 예를 들어 전송이나 적용 대신 Gmail 초안이나 변경 제안을 만들게 합니다.

상위 서비스 쪽 통제도 함께 쓰세요. 범위를 좁힌 API 키, 최소 권한 OAuth 스코프, 저장소 권한, 분리된 운영 자격 증명 같은 것들입니다.

채팅, 로그, 관리자 가시성

구성원은 자기 채팅 스레드에 접근합니다. 에이전트나 워크플로를 공개해도 그 구성원의 비공개 채팅 기록이나 커넥터 자격 증명이 공개되지는 않습니다. 대화나 산출물은 명시적인 공유 기능을 통해서만 공유하세요.

워크스페이스 관리자는 청구와 용량 관리를 위한 구성원별 사용량 집계를 볼 수 있습니다. 이것이 다른 구성원의 비공개 채팅 내용을 자동으로 들여다보는 권한을 주지는 않습니다.

자기 채팅 안에서는 활동 화면이 Run의 보이는 순서, 커넥터 활동, 산출물, 상태, 오류를 기록합니다. 요청한 커넥터 동작이 실제로 실행됐는지, 성공했는지 확인할 때 쓰세요.

점검 목록

  • 커넥터가 의도한 구성원 계정에 연결되어 있나?
  • 의도한 에이전트가 인가되어 있나?
  • 이번 작업에 필요한 권한만 허용되어 있나?
  • 영구로 두는 대신 1시간, 24시간, 7일 뒤에 만료되게 할 수 있나?
  • 워크플로가 되돌릴 수 없거나 외부로 나가는 동작을 사람이 검토하는 단계에 두고 있나?
  • 상위 자격 증명을 더 좁힐 수 있나?

다음으로 볼 것

  • 채팅 경계 안에서 무슨 일이 벌어지는지는 Chat.
  • 카탈로그와 각 커넥터가 할 수 있는 일은 Connectors.
  • 조직 단위 권한 설정은 For teams.