본문으로 건너뛰기

테넌트

테넌트는 A2Flow의 최상위 조직 경계입니다. 거의 모든 레코드는 정확히 하나의 테넌트에 속하고, 일부 항목은 의도적으로 모든 테넌트의 상위에 있으며, 어떤 요청도 한 테넌트에서 다른 테넌트로 넘어가지 않습니다. 테넌트 레코드 자체를 만들고 편집하는 일은 관리자 작업으로, 테넌트에서 다룹니다. 이 페이지에서는 이 경계가 그 밖의 모든 것에 어떤 의미를 갖는지 설명합니다.

테넌트의 범위​

범위포함되는 항목
테넌트 범위에이전트 스킬, 워크플로와 그 디자인 세션, 작업 템플릿, 워크플로 실행과 그 워크플로 세션, 승인, 시크릿, MCP 서버, 도구 모의, 태그, 사용자 그룹, 그리고 대부분의 사용자
플랫폼 범위테넌트 레코드 자체, 시스템 설정, 슈퍼 관리자 계정, 초기 생성되는 시스템 사용자

사용자는 최대 하나의 테넌트에 속합니다. 사용자 그룹은 정확히 하나의 테넌트에 속하며, 그래서 그룹은 정의상 플랫폼 범위 역할인 슈퍼 관리자를 절대 부여할 수 없습니다(유효 역할 참조). Default 테넌트는 첫 시작 시 초기 생성되며, 초기 생성된 admin 사용자가 여기에 속합니다. 초기 생성된 root 사용자는 플랫폼 범위이며 테넌트가 전혀 없습니다.

각 테넌트는 자체 ID 공급자를 연결할 수도 있어, 직원이 비밀번호 대신 회사 계정으로 로그인합니다. 이 연결은 테넌트에 속하며, 다른 테넌트의 ID 공급자가 이 테넌트에 로그인시킬 수는 없습니다. 싱글 사인온을 참조하세요.

테넌트는 시스템의 LLM 대신 자체 LLM, 즉 슈퍼 관리자나 테넌트 자체 관리자가 입력한 모델과 API 키로 에이전트를 실행할 수도 있습니다. 테넌트의 LLM을 참조하세요.

테넌트 경계​

테넌트 범위의 모든 읽기와 쓰기는 호출자의 테넌트 안에서 처리되며, 다른 테넌트에만 있는 레코드는 HTTP 403이 아니라 HTTP 404로 보고됩니다. 이 경계는 레코드의 존재를 알리지 않고 숨깁니다. 이는 API에 전달한 ID뿐 아니라 URL에 입력한 워크플로 ID에도 똑같이 적용되며, 그렇기 때문에 테넌트를 넘나드는 참조로는 해당 레코드가 실제로 있는지 절대 확인할 수 없습니다.

레코드를 반환하지도, 없는 척하지도 않는 유일한 읽기는 이름 일괄 확인입니다. POST /api/v1/users/resolve-names는 호출자의 테넌트 밖에 있는 사용자를 응답에서 제외하여 UI가 원시 ID를 대신 표시하게 합니다. 다만 모든 테넌트 안에서 정당하게 레코드를 소유하는 두 가지 계정 유형에는 레이블을 붙입니다. 이름 일괄 확인을 참조하세요.

테넌트로 작업하기​

플랫폼 범위의 슈퍼 관리자는 자신의 테넌트가 없지만, 살펴볼 만한 거의 모든 항목은 어느 한 테넌트에 속합니다. 슈퍼 관리자에게만 보이는 앱 헤더의 테넌트 전환기에서 어떤 테넌트로 작업할지 고릅니다. 이 선택은 새로 고침 후에도 유지되며, 관리 섹션과 채팅을 포함한 모든 곳에 적용됩니다. 테넌트를 선택하지 않으면 테넌트 범위의 요청은 HTTP 403으로 거부됩니다.

테넌트를 전환해도 역할은 바뀌지 않습니다. 슈퍼 관리자는 어떤 테넌트를 선택했든 모든 역할 게이트를 계속 우회합니다.

전환기는 자신의 테넌트가 없는 호출자에게만 나타납니다. 테넌트 범위 사용자는 항상 자신의 테넌트로 범위가 고정되며, 전환기가 설정하는 X-Tenant-Id 헤더는 이들에게 완전히 무시됩니다. 이 헤더를 직접 보내도 아무 권한도 얻지 못하므로 클라이언트에서 경계를 벗어날 수 없습니다.

모든 테넌트​

전환기에는 모든 테넌트 옵션도 있어서, 읽기 전용 관리 목록 페이지와 상세 페이지에서 모든 테넌트의 데이터를 한꺼번에 볼 수 있습니다. 이 옵션이 활성화되면 이 페이지들의 맨 왼쪽에 테넌트 열(과 이에 대응하는 필드)이 추가되어 서로 다른 테넌트의 행을 구별할 수 있습니다.

다른 사용자로 대리 로그인하는 동안에는 모든 테넌트 선택이 보류됩니다. 페이지는 해당 사용자의 테넌트를 선택한 것처럼 동작하고 테넌트 열은 표시되지 않습니다. 대리 로그인을 중지하면 다시 적용됩니다.

선택읽기쓰기채팅 기록에이전트 엔드포인트
자신의 테넌트(암묵적, 모든 테넌트 범위 사용자)자신의 테넌트자신의 테넌트자신의 테넌트✅
하나의 테넌트(슈퍼 관리자)해당 테넌트해당 테넌트해당 테넌트✅
모든 테넌트(슈퍼 관리자)모든 테넌트❌ 403모든 테넌트❌ 403
선택 없음(슈퍼 관리자)❌ 403❌ 403❌ 403❌ 403

"채팅 기록"은 GET /workflows/{id}/messages와 GET /workflow-executions/{id}/messages를 말합니다. 따라서 다른 테넌트의 워크플로나 실행을 검토하는 슈퍼 관리자는 그 대화도 읽을 수 있습니다. 이런 채팅을 구동하는 에이전트 엔드포인트(POST .../agent)는 쓰기이므로 항상 구체적인 테넌트 하나를 선택해야 합니다. 모든 테넌트를 선택한 상태에서는 워크플로 ID가 테넌트와 관계없이 확인되므로, 이때는 디자인 세션 자체의 역할 검사가 테넌트 경계를 대신합니다. 디자인 세션을 참조하세요.