로그인브리핑 예약

챕터 2.2

에디션의 내부 구조

하나의 제품에서 Community와 Enterprise가 빌드되는 방식, 런타임에 라이선스가 기능 그룹을 활성화하는 방식, Community 설치 환경에서 Enterprise 페이지를 표시하는 방식, 그리고 이것이 풀(Pull)하는 이미지와 개발하는 확장 기능에 의미하는 바를 설명합니다.

이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

읽는 시간 17분

values 파일의 두 줄이 설치본에서 실행할 에디션을 결정합니다:

# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
  enabled: true

두 값은 서로 일치해야 합니다. edition: community과(와) enterprise.enabled: true을(를) 함께 설정하면 차트는 "edition=community but enterprise.enabled=true: they must agree" 오류와 함께 중단됩니다. edition을(를) community 또는 enterprise 이외의 값으로 설정하면 NEXUS_EDITION_INVALID 오류와 함께 중단됩니다. 이 두 값은 설치 시 가져올 이미지를 선택합니다. 이후 해당 이미지가 무엇을 활성화할지는 런타임에 기능 그룹 단위로 처리되는 라이선스의 소관입니다.

이 장에서는 에디션에 포함된 내용, 하나의 제품이 두 개의 빌드로 나뉘는 방식, 실행 중인 서비스 내부에서 라이선스가 어떻게 허용 또는 거부로 전환되는지, 그리고 자체 기능을 구축할 때 이것이 무엇을 의미하는지 자세히 살펴봅니다. 1.6장 '알기 쉽게 설명한 에디션 및 라이선스'가 구매자의 관점을 다룬다면, 이 장은 엔지니어의 관점을 다룹니다.

에디션 매트릭스

이 장의 모든 내용은 에디션 매트릭스라는 단일 파일에서 비롯됩니다. 이 파일은 97개의 기능을 나열하고 각각에 티어를 부여합니다. Adverant는 오픈소스 코드와 비공개 코드 간의 경계뿐만 아니라 라이선스 카탈로그 및 콘솔의 메뉴 규칙도 이 파일에서 생성합니다. 매트릭스가 변경되면 이 모든 요소가 함께 변경됩니다.

에디션은 세 가지가 있습니다.

에디션 라이선스 실행 환경
Community Apache-2.0, 오픈소스, 무료 자체 하드웨어 또는 Adverant 클라우드
Team Adverant Enterprise 라이선스 Adverant 클라우드: Community 및 Team 세트
Enterprise 기능 그룹별 Adverant Enterprise 라이선스 자체 하드웨어 또는 Adverant 클라우드

설치본은 두 가지 중 하나로 실행되며, 차트의 edition 값은 community 및 enterprise만 허용합니다. Team은 클라우드 전용 에디션이며 Enterprise는 Team 세트도 포함하므로, 자체 하드웨어에서는 Team 기능(모든 레코드 옆에 도킹된 작업 패널, 공유 노트북, 조직의 메모리 정책 등)이 Enterprise와 함께 제공됩니다.

Enterprise 자체는 계층화되어 있습니다. Enterprise 베이스는 비공개 코어로, 다중 조직 및 사업부, SAML(Security Assertion Markup Language) 및 디렉터리 동기화를 통한 단일 로그인(SSO) 강제 적용, 4-아이즈(four-eyes) 승인이 포함된 사용자 지정 역할, 장기 감사 보존, 데이터 보호, 운영자 페이지 및 클러스터 관리를 포함합니다. 베이스 위에는 각각 별도로 라이선스가 부여되는 애드온과 도메인 팩이 자리 잡습니다. 표의 첫 번째 애드온인 대규모 AI 게이트웨이(AI Gateway at scale)는 AI(인공지능) 라우터의 부하를 여러 복제본과 공급자에 분산합니다.

애드온 추가 필요 항목
대규모 AI 게이트웨이 베이스
모델 팩토리 베이스
아이디어 베이스
통화 및 음성 베이스
메일 베이스
타사 협업 및 정보 장벽 베이스
노트북 스튜디오 베이스
지도 및 GeoAI 베이스
데이터 커넥터 베이스
에이전트 간 통신 베이스
의사결정 룸 및 봉인된 기록 베이스
수익 운영(RevOps) 베이스
스토어프론트 / 화이트 라벨 베이스
Nexus Edge 베이스
모바일 앱 베이스
워크포스 베이스; 엣지 디바이스의 에이전트에는 Nexus Edge도 필요하며, 휴대폰을 통한 승인에는 모바일 앱도 필요합니다
쉴드 베이스
샌드박스 베이스
품질 (NexusQA) 베이스

10개의 도메인 팩이 있습니다:

  • 보험
  • 은행 및 결제
  • 자본 시장 및 자산 관리
  • 정부 및 공공 부문
  • 헬스케어
  • 생명 과학
  • 핵심 인프라 및 에너지
  • 국방 및 안보
  • 법률 및 전문 서비스
  • 물류 및 해운

모든 팩에는 Enterprise 베이스가 필요하며, 그중 5개에는 애드온도 필요합니다. 보험(Insurance) 팩에는 의사결정 룸(Decision rooms)과 봉인된 레코드(sealed records)가 필요합니다. 자본 시장 및 자산 관리(Capital markets and asset management) 팩도 마찬가지입니다. 법무 및 전문 서비스(Legal and professional services) 팩에는 이 두 가지와 메일(Mail)이 추가로 필요합니다. 물류 및 해운(Logistics and maritime)에는 지도 및 GeoAI(Map and GeoAI)가 필요합니다. 국방 및 보안(Defence and security) 팩에서 플랫폼 알림을 사용하려면 Nexus Edge도 필요합니다. 모든 팩의 휴대폰 화면에는 모바일 앱(Mobile apps)도 필요합니다. 각 팩에 포함된 내용은 1.7장 '도메인 팩 및 산업군'에서 설명합니다.

기능 그룹

라이선스가 지정하는 단위는 기능 그룹입니다. 기능 그룹은 Community 기본 계층(floor), Team 세트, Enterprise 베이스, 애드온별 그룹, 팩별 그룹을 합쳐 총 32개입니다. 모든 기능은 정확히 하나의 그룹에 속하므로, "Enterprise base, Map and GeoAI, Logistics and maritime"이 명시된 라이선스는 해당 설치본에서 실행할 수 있는 기능을 정확하게 규정합니다.

티어 기능
Community 36
Team 6
Enterprise 베이스 18
애드온 23
도메인 팩 14

부여 범위

라이선스가 필요한 각 기능에는 권한 부여가 어디에 귀속되는지를 나타내는 부여 범위(grant scope)가 있습니다.

  • 테넌트 범위는 사람들이 작업하는 영역인 아이디어(Ideas), 메일(Mail), 수익 운영(Revenue operations) 및 각종 팩을 포괄합니다. 라이선스를 통해 설치본에서 이러한 기능을 사용할 수 있게 되면, 이후 조직별 및 사업부별로 기능을 켜거나 끌 수 있습니다. 새로운 조직은 결코 "모든 기능이 켜진" 상태를 상속받지 않습니다.
  • 배포 범위는 설치본 전체에 속하는 다섯 가지 요소, 즉 아티팩트 가져오기를 포함하는 라이선스 가져오기, Enterprise 제공 형태, 운영자 페이지, 클러스터 관리 및 Nexus Edge를 포괄합니다.

Community 기능에는 부여 범위가 전혀 없습니다. 라이선스가 필요하지 않기 때문입니다.

관리자는 조직이나 부서에 대해 라이선스가 허용하는 범위를 좁힐 수 있습니다. 하지만 설치본 내부에서 누구도 그 범위를 넓힐 수는 없습니다.

여섯 개의 띠로 이루어진 수직 스택입니다. 아래에서부터 순서대로: "기본 계층(모든 에디션에 포함, 유료 제한 없음)", "Community, Apache-2.0", "@adverant/nexus-spi, 유일한 공유 인터페이스"라는 라벨이 붙은 굵은 이중선, "Enterprise 기본, 비공개 모듈", "애드온(19개), 각각 별도 라이선스 부여", "도메인 팩(10개)". 오른쪽에는 "서명된 라이선스 문서" 상자가 있으며, 여기서 뻗어 나온 화살표는 "각 비공개 모듈 내부에서 확인됨"이라는 라벨과 함께 상위 세 개의 띠를 가리킵니다. Community 띠 왼쪽에는 "Community 이미지: 오픈 소스 전용"이라는 참고 사항이 있습니다.
유일한 권한 기준인 라이선스 문서와 계층 구조로 이루어진 에디션.

하나의 제품, 두 개의 빌드

Nexus 코드베이스는 하나입니다. Community 빌드는 그 오픈소스 내보내기(export) 버전이며, Enterprise 빌드는 해당 내보내기 버전에 비공개 모듈을 더한 것입니다.

경계 목록(boundary list)은 추적되는 모든 파일을 특정 에디션에 할당합니다. 주로 파일이 구현하는 기능을 지정하는 방식으로 이루어지며, 파일의 에디션은 해당 기능의 티어를 따릅니다. 즉, Community 기능은 Community 파일이 되고, Team, 베이스, 애드온 또는 팩에 속하는 모든 것은 Enterprise 파일이 됩니다. 어느 에디션에도 포함되지 않는 파일은 그 이유와 함께 나열됩니다. 한 가지 규칙이 이 모든 것에 우선하여 적용됩니다. 모든 모듈의 데이터베이스 마이그레이션은 두 에디션 모두에 포함됩니다. 따라서 Community 데이터베이스와 Enterprise 데이터베이스는 동일한 스키마를 가지며, 설치본을 한 에디션에서 다른 에디션으로 전환하는 것은 활성화되는 대상을 변경하는 것일 뿐 마이그레이션할 데이터는 없습니다.

Community 내보내기 버전에는 Apache-2.0 헤더와 NOTICE 파일이 포함되며, 내부의 모든 패키지는 Apache-2.0 라이선스를 따릅니다. 단, 자체 라이선스(MIT, BSD 등)를 유지하며 원본 그대로 복사되는 서드파티 코드와 자체 MIT 라이선스를 유지하는 일부 소프트웨어 개발 키트(SDK) 및 명령줄 인터페이스(CLI) 패키지는 예외입니다. Enterprise 빌드는 Adverant Enterprise 라이선스에 따라 라이선스가 부여됩니다. 해당 약관은 서면 라이선스에 따라 그 라이선스에 명시된 기간, 배포 및 기능 그룹에 한해서만 사용을 허용합니다. 역공학 금지 조항은 상호운용성을 위해 소프트웨어를 연구하고 디컴파일할 수 있도록 EU 법률이 부여하는 권리를 명시적으로 보장합니다.

라이선스 경계선

Enterprise 코드는 오직 하나의 패키지, 즉 서비스 공급자 인터페이스(SPI)인 @adverant/nexus-spi을(를) 통해서만 Community에 접근합니다. 이는 Apache-2.0 라이선스를 따르며, 자체적인 런타임 로직 없이 인터페이스와 타입 가드만 보유합니다.

내보내기 항목 설명
RouteModule 라이선스가 부여된 라우트 모듈: ID, 기능 그룹, 읽는 본문(body) 및 register(app, ctx)
SpiApp 모듈이 접근하는 호스트 HTTP 앱의 영역: use
SpiContext 호스트가 모듈에 전달하는 항목: 제품 게이트 및 범위 가드, 라이선스 리더, 범위 지정 쿼리 풀, 업스트림 주소, 플랫폼 클라이언트
SpiRuntime 호스트가 모듈에 전달하는 플러그인 SDK(소프트웨어 개발 키트) 값
SpiPlane 라이선스가 부여된 플레인이 추가하는 화면 그룹 및 화면 읽기 권한
ScreenModule 콘솔의 라이선스가 부여된 화면 그룹: 라우트, 화면 및 메뉴
GrantCheck 라이선스가 부여된 모듈이 자체 기능 그룹에 대해 실행하는 검사

빌드 과정의 검사가 이 경계선을 강제합니다. Enterprise 코드 내부에서 Community 패키지 범위(@adverant/ 및 @adverant-nexus/)로부터 가져오기를 수행하면, 대상이 @adverant/nexus-spi이거나 Enterprise 패키지가 아닌 한 빌드에 실패합니다. 저장소 외부로 벗어나는 상대 경로 가져오기, 저장소 외부를 가리키는 file:, link: 또는 workspace: 종속성, Community 저장소를 지정하는 Git URL, 그리고 저장소 외부를 가리키는 Go replace도 마찬가지로 빌드에 실패합니다. 경계선 너머의 결합은 네트워크 프로토콜이나 시작 시 로드되는 모듈을 통해 이루어지며, 결코 소스를 공유하지 않습니다. 심지어 SPI는 플러그인 SDK의 타입 선언에 대해 고정된 자체 복사본을 보유합니다. SDK는 경계선이 허용하지 않는 Community 패키지이므로, 호스트가 모듈에 SDK의 런타임 값을 대신 전달하기 때문입니다.

빌드 프로필

콘솔과 BFF(프론트엔드용 백엔드)는 이미지 내부의 코드 분류를 확정하는 빌드 프로필을 사용하여 컴파일됩니다. Community 프로필은 Community 코드를 보유하고, Enterprise 프로필은 Community 코드와 Enterprise 코드를 모두 보유합니다. 각 구성 요소는 자신의 프로필이 설치본의 에디션에 없는 코드를 보유하고 있을 경우 시작을 거부합니다. BFF는 PROFILE_OUTSIDE_EDITION을(를) 통해 이를 알리고 대신 배포해야 할 이미지 이름을 제시합니다. 이미지 태그를 변경하는 방법으로는 Community 설치본에 Enterprise 콘솔을 올릴 수 없습니다.

왼쪽에는 내부에 작은 "edition matrix" 상자를 포함한 "Nexus source" 상자가 있음. "boundary list"라는 라벨이 붙은 화살표가 두 개로 갈라짐. 위쪽 화살표는 "Community export (Apache-2.0)"를 거쳐 "Community images"로 이어짐. 아래쪽 화살표는 "Enterprise build"로 이어지며, 이 상자는 "Community export"와 "closed modules" 상자로부터도 화살표를 받아 "Enterprise images"를 생성함. 비공개 모듈과 Community 내보내기 사이에는 "licence line: @adverant/nexus-spi only"라는 라벨이 붙은 펜스가 있음. 두 이미지 상자 아래의 작은 참고 문구에는 "same database schema"라고 적혀 있음.
하나의 소스 트리가 두 개의 에디션이 되는 방식.

라이선스가 기능 그룹을 활성화하는 방식

라이선스는 서명된 문서입니다. Adverant는 두 개의 독립적인 키로 모든 라이선스에 서명하며, 설치본의 다른 어떤 요소도 라이선스 부여 대상을 결정하지 않습니다. 라이선스는 콘솔의 라이선스 페이지를 통해 가져오거나, nexusctl licence import <file>을(를) 사용하거나, https://<hosts.auth>/api/v1/installation/licence(으)로 문서를 POST 요청하여 가져올 수 있습니다. 라이선스는 결코 차트 값이나 마운트된 파일 형태로 제공되지 않습니다. 2.13장 '라이선스'에서 가져오기 및 갱신, 그리고 라이선스가 거치는 각 상태를 다룹니다.

핵심적인 검사는 각 비공개 모듈 내부에서 응답하기 전에 해당 모듈 자체의 기능 그룹에 대해 실행됩니다. 이는 SPI의 GrantCheck 계약입니다:

type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;

오픈소스 코드에 작성된 검사는 단순히 삭제될 수 있기 때문에, 이 검사는 비공개 모듈 내부에 존재합니다. 위조된 라이선스는 라이선스가 없는 것으로 간주됩니다. 라이선스에 명시되지 않은 기능 그룹에 속한 모듈은 LICENCE_LOCKED(으)로 응답합니다.

모듈 자체도 검사를 받습니다. nexus-keys는 릴리스의 서명된 부품 매니페스트와 이에 서명한 키를 보유합니다. 시작 시점과 매일 밤 03:53 UTC에 이 매니페스트를 기준으로 컴파일된 모든 모듈을 검사합니다. 서명이 일치하지 않는 모듈은 절대 로드되지 않으며, 대체되었을 기존 서명된 복사본이 계속 실행됩니다. 운영자 페이지에는 MODULE_SIGNATURE_INVALID와(과) 함께 표시됩니다.

컴파일된 부품
컴파일된 부품
컴파일된 부품 페이지에는 라이선스가 부여된 각 모듈이 기능 그룹, 버전 및 서명 검사 결과와 함께 나열됩니다. 검사에 실패한 변경된 복사본은 거부 배너로 표시되며, 서명된 복사본이 계속 실행됩니다.

모듈 검사 위에는 각 사용자에게 기능이 표시되는 방식을 결정하는 디스플레이 계층이 있습니다. 이 계층은 라이선스의 부여 권한을 조직의 요금제 및 사용자의 역할과 결합하며, 모든 컨트롤은 최종적으로 네 가지 상태 중 하나가 됩니다.

상태 사용자에게 표시되는 형태
권한 있음(Entitled) 정상적으로 표시되는 컨트롤
티저(Teaser) 자물쇠 아이콘과 함께 회색으로 비활성화된 컨트롤; 열면 기능에 대한 설명과 활성화할 수 있는 주체를 안내함
숨김(Hidden) 아무것도 표시되지 않음; 다른 사람의 개인 메일함과 같이 해당 사용자의 역할이 존재 자체를 알아서는 안 되는 항목에만 사용됨
코드와 함께 거부됨(Refused with a code) 허용되지 않은 작업을 시도할 때 코드를 명시하여 표시되는 거부 배너

라이선스 또한 만료일이 다가오고 지남에 따라 자체적인 상태를 가집니다. 모든 상태에서 두 가지 규칙이 유지됩니다. 라이선스는 실행 중인 작업을 절대 중단시키지 않으며, 보안 수정 사항은 절대 보류되지 않습니다.

Community에서 Enterprise 페이지를 표시하는 방식

Community 설치본은 제품의 형태를 그대로 유지합니다. 메뉴에는 Enterprise와 동일한 항목들이 있으며, Enterprise 전용 항목(아이디어, 의사결정, 메일, 통화, 타사, 에이전트, 정책, 규정 준수)은 자물쇠 아이콘과 함께 회색으로 표시됩니다. 에디션이 완전해 보이도록 숨기는 것은 아무것도 없으며, 성가시게 구매를 독촉하지도 않습니다.

잠긴 항목을 열면 티저가 표시됩니다. 아이디어(Ideas)의 경우 "아이디어는 Enterprise의 일부입니다"라는 문구와 함께 아이디어의 기능을 설명하는 한 단락이 이어진 후, "활성화할 수 있는 사람: Adverant의 라이선스를 통한 귀하의 관리자"라고 표시됩니다. 그리고 "관리자에게 문의"와 "기능 알아보기"라는 두 개의 버튼을 제공합니다. 가격은 표시되지 않습니다. 페이지를 열어도 아무것도 로드하거나 전송하지 않으며, 안내 문구는 한 번만 표시됩니다.

보유하지 않은 기능
보유하지 않은 기능
Community의 잠긴 영역은 이를 활성화할 수 있는 주체와 Community가 이미 제공하는 기능을 안내합니다. 해당 항목은 자물쇠와 함께 회색으로 메뉴에 남아 있으므로, 두 에디션에서 제품의 외형은 동일하게 유지됩니다.

Enterprise 전용 페이지의 주소를 직접 입력하더라도 유용한 화면으로 연결됩니다. Community 콘솔은 자신이 보유하지 않은 페이지의 주소를 알고 있으며, 해당 주소로 접근하면 메뉴가 있는 일반 프레임 내부의 에디션 페이지로 이동시킵니다. 이 페이지는 잠긴 기능 배너를 표시합니다:

LICENCE_LOCKED
This page is part of Nexus Enterprise. This installation runs Nexus Community,
so the page is not here and nothing was read.
- To use it, the installation needs Nexus Enterprise: an administrator can ask Adverant about it
- Every page this installation holds is in the menu

코드는 참조용이며, 문장은 이를 읽는 사용자를 위한 것입니다.

기본 계층(The floor)

어떤 에디션이나 어떤 라이선스 상태에서도 결코 유료 장벽(paywall)으로 막히지 않는 기능들이 있습니다. 관리 및 보안 기본 기능, 테넌트 분리, 데이터 내보내기, 로그아웃, 그리고 모든 거부 화면이 이에 해당합니다. Community 설치본은 이 모든 기능을 갖추고 있습니다. 라이선스가 만료된 Enterprise 설치본도 이를 그대로 유지합니다. 즉, Enterprise 아티팩트 제공은 중단되지만 Community 기본 계층과 데이터 내보내기 기능은 남습니다. 데이터는 언제든 밖으로 내보낼 수 있습니다.

Community에서 Enterprise로
Community에서 Enterprise로
Community 설치본에서 라이선스를 가져오면 실제 작업이 일어나기 전에 가져올 항목, 변경되는 사항 및 유지되는 사항을 보여줍니다. 버튼에는 "가져오기 및 활성화(Fetch and switch on)"라고 표시되며, 이 버튼을 누르기 전까지는 아무것도 가져오지 않습니다.

에디션별 이미지

릴리스의 모든 이미지는 차트의 이미지 잠금(image lock) 파일에 다이제스트별로 나열되며, 잠금 파일 자체는 하나의 에디션에 귀속됩니다. 차트는 렌더링하는 각 이미지를 잠금 파일 및 사용자가 요청한 에디션과 대조하여 검사합니다. Community 설치는 Community 이미지만 가져옵니다. 다른 것을 요청하면 "a community install takes only community images"라는 메시지와 함께 중단됩니다. Enterprise 잠금 파일은 Community 이미지와 Enterprise 빌드를 모두 보유합니다.

이는 이미지를 가져오는 위치와 관련하여 중요합니다. Community 이미지는 registry.adverant.ai/nexus/<service>@sha256:…에 공개되어 있습니다. Enterprise 이미지는 동일한 레지스트리에서 풀 토큰(pull token)을 사용하여 가져오며, 이 토큰은 Adverant 계정의 "풀 토큰 및 설치 명령(Pull tokens and install commands)" 페이지에서 얻을 수 있습니다. Community 설치본은 이 토큰이 전혀 필요하지 않으며, 단 1바이트의 비공개 코드도 보유하지 않습니다.

업그레이드 경로는 기존 설치본을 그대로 유지합니다. Community 관리자가 Enterprise 라이선스를 가져오면, 콘솔은 이를 읽고 검증한 후 가져올 부품(라이선스가 지정하는 컴파일된 모듈, 팩 및 애드온)과 그 크기를 표시합니다. 각 부품은 Adverant 릴리스 키와 대조하여 검사되며, 기능 그룹이 한 번에 하나씩 활성화됩니다. 스키마가 이미 동일했기 때문에 사용자와 파일은 그대로 유지되며 워크플로와 채널도 마찬가지입니다. 2.7장 'Enterprise 설치 및 라이선스 적용'에서는 Kubernetes 환경에서의 과정을 안내하며, 망분리(air-gapped) 사이트의 경우 2.10장 '망분리 설치'에서 설명하는 대로 미디어에서 동일한 부품을 가져옵니다.

제공 형태와 보호 등급

Nexus는 매트릭스에서 SKU(재고 관리 단위)라고 부르는 6가지 제공 형태로 출시됩니다. Edge를 제외한 5가지는 하나의 서명된 번들을 공유하며, 패키징 방식과 라이선스가 전달되는 방식에서 차이가 있습니다.

SKU 설명 라이선스 전달 방식
saas Adverant 클라우드 구독과 함께 발급됨
onprem-connected 자체 Kubernetes에 Helm으로 배포 설치본이 아웃바운드 연결을 통해 가져옴
airgap 동일한 번들을 오프라인으로 가져옴 연 1회 서명된 사용량 명세서와 함께 파일로 가져옴
self-serve-image 자체 클라우드 계정의 머신 이미지 이미지 자체에는 Community 및 평가판 라이선스만 포함되어 있으며, 클라우드 스토어를 통해 구매한 라이선스를 포함하여 라이선스가 발급되면 Enterprise 모듈이 전달됨
appliance 등재 제조업체(manufacturer of record)인 주문자 상표 부착 생산자(OEM)가 구축한 하드웨어 Enterprise 라이선스; 어플라이언스는 제공 형태 중 하나임
edge 위성 및 드론, 또는 선박 및 차량에 탑재되는 페이로드인 Nexus Edge 플랫폼 또는 플릿당 하나의 라이선스, 장기 유효, 오프라인 상태에서 유효함

보호는 제공의 또 다른 측면이며, 이에 대해서는 솔직하게 짚고 넘어갈 필요가 있습니다. 코드가 귀하가 통제하는 하드웨어에서 실행되기 시작하면, 어떤 기술로도 코드를 읽을 수 없게 만들 수는 없습니다. 따라서 Adverant는 코드를 보호 등급으로 분류하고 각 제공 형태에 대해 각 등급이 어디까지 전달될 수 있는지 결정합니다. 네 가지 수준이 있습니다:

등급 의미
P1, 배포되지 않음 로직은 Adverant에서 실행되며, 설치본은 서명된 클라이언트를 보유합니다.
P2, 봉인됨 접근할 수 없는 하드웨어 상에서 로그인할 수 없는 기밀 가상 머신(VM)으로 실행됩니다.
P3, 강화된 네이티브 코드 컴파일되고 심볼이 제거(stripped)되며 라이선스 보유자별로 빌드됩니다. 코드를 해독하는 데 드는 비용을 몇 시간에서 몇 주 단위로 높입니다.
P4, 읽을 수 있음 오픈소스와 마찬가지로 일반적인 JavaScript 또는 TypeScript입니다.
보호 등급 Adverant 클라우드 연결된 온프레미스 망분리(Air-gap) Nexus Edge
오픈소스(Community 전체) P4 P4 P4 P4
최고 가치 코드: 아이디어 점수화, 봉인된 레코드 저장소 코어, 라우팅 정책 엔진, 보험 팩의 4가지 의사결정 엔진 P1 P3, 또는 클라우드 테넌시 내 Adverant가 봉인한 기밀 VM 형태의 P2 P3 배포되지 않음
의사결정을 수행하는 비공개 서버 모듈: 팩 서버 코드, 모바일 게이트웨이 P1 P3 P3 배포되지 않음
국방 및 보안 팩 서버 코드 P1 P3 P3 P3
Nexus Edge 페이로드 코드 배포되지 않음 배포되지 않음 배포되지 않음 P3
읽을 수 있는 클라이언트 정의: 휴대폰 앱, 팩 휴대폰 화면 P4 P4 P4 P4

이에 따라 두 가지 결과가 도출됩니다. 첫째, 보호 대상인 어떤 것도 휴대폰 앱에 포함되지 않으며 모든 규칙과 프롬프트는 서버에 머뭅니다. 둘째, 프롬프트, 루브릭 또는 에이전트 체인에 담긴 가치는 그것이 전송되는 모델을 실행하는 주체라면 누구든 읽을 수 있습니다. 조직이 모델을 자체 소유하는 경우, 해당 가치는 오직 라이선스 계약에 의해서만 보호됩니다. 배포되는 모든 TypeScript 이미지는 소스 맵 없이 번들링되고 축소(minified)되는데, 이는 보호보다는 정돈을 위한 것입니다.

확장 기능 개발 시 이것이 의미하는 바

귀하의 확장 기능은 Adverant 자체 모듈과 동일한 선상에 놓입니다. 이 장의 거의 모든 내용이 확장 기능에도 그대로 적용됩니다.

격리, ID 및 AI 경로는 두 에디션 모두에서 플랫폼과 함께 기본 제공됩니다. @adverant-nexus/plugin-sdk(으)로 빌드된 플러그인은 어느 에디션에 배포되든 범위 지정 쿼리 펜스, 토큰 검증기 및 UNO 디스패치를 상속받습니다. 2.19장 '모든 확장 기능이 상속받는 규칙'에 해당 내용들이 나열되어 있습니다.

에디션 게이팅은 귀하에게도 동일한 방식으로 작동합니다. 플러그인은 매니페스트의 entitlements 블록(featureIdPattern 및 상태 확인과 설정 페이지용으로 유지되는 짧은 alwaysOn 목록)에 기능 ID를 선언하고, 제한된 표면을 제공하기 전에 플랫폼에 판정을 요청합니다. 판정 결과는 결코 단순한 불리언(boolean) 값이 아닙니다. ENTITLEMENT_DENIED(403)은 플랫폼이 거부로 응답했음을 의미합니다. ENTITLEMENT_UNREACHABLE(502)는 응답이 없었음을 의미하며, 이 경우 플러그인은 임의로 가정하지 말고 거부해야 합니다. 장애 상황을 "권한 없음"으로 처리하면 모든 고객의 환경이 동시에 조용히 다운그레이드되기 때문입니다. 허용(yes) 결과는 짧게 캐시하고, 거부 결과는 절대 캐시하지 마십시오.

Community에서 개발자는 스킬 및 워크플로뿐만 아니라 플러그인 및 렌즈에 대해서도 Enterprise와 동일한 시작 템플릿을 얻습니다. 각 개발자는 단일 서버에서 데이터 브랜치가 있는 개발 공간에서 작업하며 코드는 GitHub에 저장됩니다. 도메인 팩 및 플랫폼 템플릿은 Enterprise 전용입니다. IDE(통합 개발 환경)에서의 시간 제한 액세스 권한 상승 또한 Enterprise 전용입니다. Community에는 권한을 높여 접근할 별도의 프로덕션 환경이 없으며, 콘솔은 이를 PASS_TIER_REQUIRED(으)로 알립니다.

Community에서 빌드하기
Community에서 빌드하기
Community에서 빌드하기는 GitHub에 코드를 두고 단일 서버에서 Enterprise와 동일한 템플릿을 제공합니다. 이 페이지는 Enterprise가 추가하는 기능을 명시하고 명확한 이유와 함께 권한 상승 액세스를 거부합니다.

Community 접점(seam)만 사용하는 확장 기능은 두 에디션 모두에서 변경 없이 실행됩니다. 예를 들어 메일과 같은 애드온에 의존하는 확장 기능은 라이선스에 해당 그룹이 명시되지 않은 모든 환경에서 잠긴 상태로 표시됩니다. 2.25장 '각 에디션용으로 빌드하기'에서는 두 에디션 모두를 위해 확장 기능을 구조화하는 방법과 각 에디션에 대해 테스트하는 방법을 보여줍니다.