버전 1.0.0-alpha.1최신
챕터 2.19
모든 확장 기능이 상속받는 규칙
세 가지 축에서의 격리, UNO를 통한 컴퓨팅, 라우터를 통한 AI(인공지능), 조직 소유의 키 및 라이선스 확인입니다. 각 규칙이 코드에 의미하는 바와 어떤 게이트가 이를 강제하는지, 그리고 이를 직접 작성하는 대신 상속받는 이유를 알아봅니다.
이 페이지는 AI에 의해 영어 원문에서 번역되었습니다. 불명확한 내용이 있는 경우 영어 페이지를 기준으로 삼으십시오. 이 페이지를 영어로 읽기

제가 만든 이상 징후 검토 플러그인이 보낸 첫 번째 거절 응답의 수신자는 바로 저 자신이었습니다. 다른 플랫폼에서의 습관대로 본문에 조직 ID를 담아 새 검토를 게시하는 테스트 클라이언트를 작성했는데, 제 핸들러가 실행되기도 전에 플러그인이 다음과 같이 응답했습니다.
{
"error": true,
"code": "TENANT_NOT_A_PARAMETER",
"message": "The request body names the organisation. Tenancy comes from the token.",
"resolved": ["tenant", "owner"],
"missing": [],
"troubleshooting": ["Remove organizationId from the body. The organisation is read from your sign-in."]
}그 검사는 제가 작성한 것이 아니었습니다. SDK(소프트웨어 개발 키트) 템플릿이 모든 /api 라우트에 연결하는 범위 가드(scope guard)에 포함되어 있던 기능으로, 본문에 있는 ID가 호출자 자신의 것일 때조차 작동합니다. 이것이 이 장 전체를 관통하는 패턴입니다. 즉, 소수의 규칙이 존재하고, 각 규칙은 상속받은 메커니즘에 의해 강제되며, 코드가 이를 우회하면 빌드를 실패시키는 게이트가 각각 존재합니다. Nexus에서 귀하의 플러그인은 플랫폼으로부터 격리성을 상속받으며, 게이트들이 이를 감사합니다.
다섯 가지 규칙이 있으며, 아래 섹션에서 이를 차례대로 다룹니다. 세 가지 축에서의 격리, 오직 UNO 디스패치를 통해서만 실행되는 컴퓨팅, 오직 AI Provider Router를 통해서만 이동하는 AI(인공지능), 조직에 속하는 모델 키, 그리고 라이선스에 대조하여 확인되는 라이선스 기능입니다. 또한 모든 매니페스트는 이 중 세 가지를 하나의 문장 블록으로 재진술합니다.
규칙 1: 인증된 요청으로부터 세 가지 축에서의 격리
확장 기능의 모든 읽기와 쓰기는 세 가지 축으로 범위가 지정되며, 모든 도구 호출과 스킬 디스패치도 마찬가지입니다.
| 축 | 열 | 답하는 질문 | 경계의 강도 |
|---|---|---|---|
| 테넌트(Tenant) | organization_id |
어느 조직인가 | 기록된 읽기 전용 권한 부여를 통해서만 넘을 수 있는 엄격한 경계 |
| 소유자(Owner) | owner_user_id |
조직 내 어느 개인인가 | 개인적인 모든 항목에 대해 단일 조직 내부에서도 비공개로 유지됨 |
| 부서(Unit) | business_unit_id |
조직의 어느 부서인가 | 테넌트 내부의 선택적 펜스 |
소유자(owner) 축은 신규 개발자들이 흔히 실수하는 부분입니다. 메일함은 개인적인 것이며, 저장된 뷰나 한 사람의 데이터에서 파생된 그래프도 마찬가지입니다. 같은 조직의 같은 부서에서 같은 역할을 맡은 두 구성원이라도 서로의 소유자 범위 행(row)은 볼 수 없습니다. 반면 승인이나 케이스 기록 같은 조직의 산출물에서 소유자는 출처(provenance)를 의미합니다. 즉, 누가 행동했는지를 기록하며, 감사 추적이 필요한 사람들에게 계속 보이도록 읽기는 테넌트 범위로 지정됩니다. 테이블별로 어느 종류인지 결정하면 리포지토리 계층이 이를 인코딩하며, 결코 라우트에서 예외적인 경우로 처리하지 않습니다.
이 축들은 인증된 요청에서 오며 그 외 어디에서도 오지 않습니다. 환경 변수로 제공할 수 없으며, 쿼리 매개변수, 경로 세그먼트, 클라이언트 헤더 또는 빌드 상수로도 제공할 수 없습니다. SDK는 잘못된 코드를 작성하기 어렵게 만듭니다. resolveScope(identity, options)에는 조직 매개변수가 아예 없습니다. 조직 정보는 identity 내부에 있으며, 검증된 토큰만이 이를 생성합니다. ID를 전달할 통로 자체가 없습니다.
이것이 바로 테넌트를 지정하는 본문이 무시되지 않고 거절되는 이유입니다. 가드는 다섯 가지 필드 이름(orgId, organizationId, organization_id, tenant, tenantId) 중 어느 것이든 거절합니다. 필드를 조용히 무시하면 호출자는 그 필드가 작동한다고 학습하게 됩니다. 첫 번째 호출자는 이를 테스트하고 자신의 데이터를 보게 되며, 두 번째 호출자는 다른 조직의 ID를 보냅니다. 첫 번째 요청에서 거절하면 누군가 잘못된 계약을 기반으로 개발하기 전에 계약 조건을 명확히 알릴 수 있습니다. 동일한 규칙이 디스패치의 inputParams에도 적용됩니다. 조직 ID를 담은 스킬의 입력은 디스패치 시점에 거절됩니다.
부서(unit) 축은 선언되어 강제되거나 아예 사용되지 않거나 둘 중 하나입니다. needsUnit: true을 선언하는 라우트는 자격 증명이 부서를 확인하지 못할 때 missing[]에 unit를 명시하여 거절합니다. 서브도메인이나 헤더에서 부서를 조합해 만들지 마시고, 기본값을 설정하지도 마십시오. 임의로 만든 부서는 조직의 실제 부서들과 다르게 펜스를 치며, 결합해서는 안 되는 행들을 결합합니다.
조건자를 표현할 수 없는 표면은 거부함
라우트가 행이 어느 테넌트와 소유자에 속하는지, 그리고 필요한 경우 어느 부서에 속하는지 말할 수 없다면 거절합니다. 폴백(fallback)으로서의 조직 전체 읽기나 플레이스홀더 값은 존재하지 않습니다. 플레이스홀더는 최악의 선택인데, 플레이스홀더도 하나의 값이고 값은 행과 일치하기 때문입니다. 테넌트와 사용자 모두의 기본값을 문자열 'unknown'로 설정한 도구 라우터는 호출하는 모든 사람에게 조직 전체 데이터를 제공했습니다. 테넌트 경계에서 ?? 'unknown'는 결함입니다.
거절 응답은 플랫폼 어디에서나 동일한 형태를 띠며, 클라이언트가 해결 방법을 렌더링하기에 충분한 정보를 담고 있습니다.
{
"error": true,
"code": "SCOPE_PREDICATE_MISSING",
"message": "Request cannot be scoped to a tenant from the presented credential.",
"resolved": ["tenant", "owner"],
"missing": ["unit"],
"troubleshooting": [
"The credential resolved tenant+owner; this route additionally requires a business unit.",
"Select a business unit in the client and retry — re-authentication will not change this outcome."
]
}error은 항상 true입니다. code은 플랫폼의 코드 카탈로그에서 가져옵니다. resolved[]는 도출된 축을 지정하고, missing[]는 라우트가 필요로 했으나 얻지 못한 축을 지정합니다. troubleshooting[]은 이를 실제로 해결할 방법을 알려줍니다. 단순히 "forbidden"이라고만 하는 것은 누구에게도 아무것도 알려주지 못합니다.
클라이언트가 401과 403에 대해 서로 다르게 작동하므로 두 코드를 구분하십시오.
| 상태 | 의미 | 클라이언트의 동작 |
|---|---|---|
| 401 | 인증되지 않음 | 다시 로그인함 |
| 403 | 인증되었으나 요청의 범위를 지정할 수 없거나 호출자에게 권한이 없음 | 재시도를 멈추고 요청을 변경함 |
범위 거절을 401로 응답하면 클라이언트는 어떤 로그인으로도 끝낼 수 없는 로그인 루프에 빠집니다. 세션을 버리고 다시 로그인한 뒤 재시도하여 다시 401을 받는 동안, 사용자는 영원히 회전하는 스피너만 보게 됩니다.
두 가지 메커니즘이 더 있어 거절을 완벽하게 만듭니다. 핸들러 내부에서 범위를 읽는 유일한 방법은 scopeOf(req)이며, 가드가 실행되지 않았다면 예외를 발생시킵니다. 그리고 가드는 본문 파싱 후, 모든 핸들러 실행 전에 실행됩니다. 조건자(predicate) 없이 도달할 수 있게 된 핸들러는 의도적으로 MIDDLEWARE_ORDERING_ERROR와 함께 500을 응답하여, 사고 보고서 대신 오류 예산(error budget)에 기록되도록 합니다.
데이터베이스가 자체적으로 동일한 기준을 유지함
코드 펜스와 데이터베이스 펜스는 하나의 법칙을 위한 두 가지 메커니즘이며, 귀하는 이 둘을 모두 갖게 됩니다.
범위가 지정된 테이블에 대한 모든 구문은 SDK의 tenantFence(scope)을 조합하여 구성하며, 조건자를 직접 작성하는 일은 결코 없습니다. 또한 모든 구문은 withScopedTx 내부에서 실행되는데, 이는 단일 데이터베이스 함수를 통해 해당 단일 트랜잭션에 대해 세 가지 축을 바인딩하고 두 번째 바인딩(SCOPE_ALREADY_BOUND)을 거절합니다. 그 아래에서 스키마의 모든 테이블에는 행 수준 보안(RLS)이 강제 적용되며, 요청 경로가 연결하는 역할(role)은 바인딩된 테넌트 자체를 변경할 수 없습니다. 행 수준 보안을 우회할 수 있는 역할로 연결하는 프로세스는 DB_ROLE_BYPASSES_ISOLATION와 함께 부팅을 거절합니다. 2.22장, 플러그인 런타임에서 코드를 보여주고, 2.21장, 플러그인 SDK에서 역할이 어떻게 렌더링되는지 보여줍니다.
유일한 교차: 기록된 권한 부여
테넌트 경계를 넘는 방법은 단 하나뿐입니다. 행을 보유한 조직이 어느 조직이 어느 테이블을, 어떤 합의 하에, 얼마 동안 읽을 수 있는지 지정하는 권한 부여(grant)를 기록합니다. 데이터베이스는 해당 읽기를 읽기 전용으로 만들고, 모든 조회는 읽기 전에 두 조직 모두에 ID로만 기록됩니다. 쓰기는 결코 경계를 넘지 않으며, 다른 회사에 전달되는 작업은 메시지로 이동합니다. 소유자 및 관리자 역할은 결코 경계를 넘어 읽지 않으며, 조직 간 읽기를 허용하는 권한이 이들을 차단하지 않으면 매니페스트가 거절됩니다. 경계를 넘는 다른 방법을 원하는 플러그인에게는 어떤 방법도 주어지지 않습니다.
규칙 2: 모든 컴퓨팅은 UNO 디스패치를 통해 실행됨
워크플로 엔진인 UNO는 유일한 컴퓨팅 경로입니다. 귀하의 코드는 모델 제공자나 엔진을 직접 호출하지 않으며, 큐나 워크플로 호스트도 직접 호출하지 않습니다. 디스패치 엔드포인트에 하나의 엔벨로프(envelope)를 보내고 식별자가 포함된 202을 돌려받으며, 결과는 폴링이나 콜백을 통해 도착합니다.
이에 따라 세 가지 관행이 뒤따르며, 템플릿에는 이미 이 세 가지가 모두 적용되어 있습니다.
- 단 하나의 파일만 디스패치 URL을 소유합니다.
UNO_DISPATCH_URL은 구성 로더에서 한 번 읽히며 클러스터 내부 주소여야 합니다. 설치 환경을 벗어나는 것은 아무것도 없기 때문에 공용 주소는 부팅 시 거절됩니다. - 이 표면(surface)이 디스패치할 수 있는 항목에 대한 하나의 닫힌 허용 목록(allow-list)을 유지합니다. 브라우저가 전달하는 모든 스킬 ID를 디스패치하는 백엔드는 다른 플러그인의 스킬과 다른 사람의 모델 예산을 소비하는 스킬을 포함하여 레지스트리에 있는 모든 스킬에 대한 범용 프록시가 됩니다. 이 목록은 네임스페이스가 지정된 작업 유형의 모듈 수준 상수이며, 결코 환경 변수가 아닙니다. 목록에 없는 ID는
SKILL_NOT_ALLOWED과 함께 거절됩니다. - 돌아오는 결과를 다시 확인하십시오. 작업을 다시 읽어올 때, SDK의 클라이언트는 네트워크 호출의 귀하 측에서 반환된 행의
organization_id을 호출자의 테넌트와 비교합니다. 호출의 반대편에만 존재하는 펜스는 단순한 관례일 뿐입니다.
규칙 3: 모든 AI는 AI 제공자 라우터를 거침
플러그인은 어디에서도 모델을 호출하지 않습니다. package.json에는 제공자 SDK가 없고, 환경에는 모델 키가 없으며, 릴레이도 없습니다. 오직 라우터만이 조직의 제공자 자격 증명을 보유하고 최종 제공자 및 모델 결정을 내립니다.
플러그인이 할 수 있는 일은 등록 시점에 매니페스트 스킬의 레지스트리 행에 희망 사항을 표현하는 것입니다.
{
"execution_config_skill": {
"preferredProvider": "gemini",
"preferredModel": "gemini-3.5-flash",
"capabilityProfile": { "needsToolUse": true, "minContextWindow": 200000 }
}
}라우터는 조직이 해당 제공자를 활성화하고 자격 증명을 부여한 경우에만 희망 사항을 존중합니다. 그렇지 않으면 조직의 자체 풀에서 대체합니다. capabilityProfile은 결코 선택하지 않으며 필터링만 수행하고, 그 dataResidency 필드는 라우터가 충족하거나 거절해야 하는 엄격한 관할권 제약 조건입니다. 대부분의 스킬에서는 이 모든 것을 생략하는 것이 올바른 기본값입니다. 그러면 조직의 자체 역할 할당이 결정을 내리며, 비용을 지불하는 주체도 바로 그 조직입니다.
두 가지 종류의 거절이 반환되며, 이 둘은 매우 다른 의미를 갖습니다.
| 코드 | 상태 | 의미 |
|---|---|---|
MISSING_CALLER_IDENTITY, UNAUTHORIZED_CALLER |
403 | 귀하의 코드가 라우터를 직접 호출하려고 시도했습니다. 중단하십시오. 이는 설계상 거절하는 경계선(seam)이며 재시도할 수 없습니다 |
MODEL_CAPABILITY_UNAVAILABLE |
422 | 프로필을 충족하는 모델을 가진 활성화된 제공자가 없습니다. 프로필을 완화하거나, 조직이 해당 기능을 갖춘 제공자를 활성화해야 합니다 |
NO_PROVIDER_FOR_ROLE |
422 | 조직이 이 역할에 대한 라우팅을 구성하지 않았습니다. 라우터의 해결 방법 텍스트를 사용자에게 표시하십시오 |
두 번째 쌍은 로그가 아니라 화면에 표시되어야 합니다. 기본 모델이나 폴백 제공자는 없습니다. 조직이 설정하지 않은 역할은 무엇을 구성해야 하는지 알려주는 문장과 함께 명확하게 실패를 알립니다.
플러그인이 라우터에 대해 수행할 수 있는 유일한 읽기는 runtime/ai-route의 effectiveRoute()입니다. 이는 AI 요청을 보내지 않고 로그인한 조직을 위해 라우터가 어떤 제공자와 모델을 선택할지 답해주며, 모델이 없을 때는 라우터의 거절을 텍스트로 반환합니다. 2.22장, 플러그인 런타임에서 이를 보여줍니다.
신뢰 사다리(trust ladder)는 한 줄을 더 추가합니다. 오직 core 및 verified 플러그인만이 라우터에 도달하는 두 가지 매니페스트 스킬 티어인 tool_using과 llm_only를 선언할 수 있습니다. 그 외의 모든 플러그인은 결정론적 작업을 중개하고 모델에 도달하는 부분은 플랫폼이 처리하도록 합니다.
규칙 4: 키는 조직에 속함
각 조직은 자체 제공자 계정과 키를 가져오고 자체 청구서를 지불합니다. 키는 콘솔에서 조직의 자체 관리자가 관리하는 조직의 AI 제공자 풀에 존재하며, 라우터가 호출 시점에 이를 확인합니다. 테넌트 이면에 공유되는 플랫폼 키가 없으므로 어떤 조직도 다른 조직의 예산을 소비하지 않습니다.
확장 기능에 있어 이는 세 가지를 의미합니다.
- 코드나 구성, 또는 시크릿 저장소 등 어디에서도 모델 키를 보유하지 않습니다. 읽을 수 있는 키가 있으면
no-credentials게이트가 빌드를 실패시키고, 키가 존재하면 구성 로더가 부팅을 거절합니다. - 조직의 키를 절대 열거하지 않습니다. 만약 플러그인이 이를 필요로 한다고 생각한다면 요구 사항이 잘못된 곳에 있는 것입니다.
- 키가 없는 조직은 AI 응답을 받지 못합니다. 이는 실제 화면이 준비되어 있는 예상된 상태입니다. 누락된 역할의 이름을 표시하고 해결 방법을 인용한 다음, 사용자에게 제공자 설정을 안내하십시오. 이를 빈 결과로 렌더링하지 마십시오.
규칙 5: 라이선스가 필요한 기능은 라이선스와 대조하여 확인함
설치 환경이 Community 기본 등급(floor)을 넘어 사용할 수 있는 기능은 단 한 곳에서 나옵니다. 바로 Adverant가 서명하고 설치 환경에서 오직 공개 키로만 검증되는 라이선스 문서입니다. 귀하의 확장 기능은 토큰의 플랜 이름이나 구성의 플래그와 같이 이보다 약한 어떤 근거로도 결정을 내리지 않습니다.
플러그인에서 기능을 라이선스에 연결하는 가장 간단한 방법은 해당 기능을 보호하는 권한(right)에 설정하는 것입니다. 매니페스트의 rights 레지스터에 있는 권한은 licence 기능을 지정할 수 있습니다.
"rights": {
"evidence.export": {
"summary": "Export the evidence pack for an inspection.",
"roles": ["owner", "admin", "member"],
"licence": "compliance-packs"
}
}조직의 라이선스에 compliance-packs가 포함되어 있지 않을 때, 해당 권한으로 보호되는 라우트를 호출하는 사람은 보유한 역할과 시트(seat)에 관계없이 LICENCE_LOCKED(403)으로 거절됩니다. 거절 응답은 해당 기능과 이를 포함하는 플랜을 명시하고, 누가 이를 켤 수 있는지 알려줍니다.
라이선스의 상태도 중요합니다. 라이선스가 유효하거나 경고 기간에 있는 동안에는 라이선스 기능이 작동하며, 유예 기간(grace)에도 계속 작동하면서 LICENCE_IN_GRACE 알림을 표시합니다. 라이선스가 유예 기간을 지나면 제한됩니다. 실행 중인 작업과 읽기는 계속되고 내보내기와 보안 업데이트도 계속되지만, 라이선스 기능 하에서 새로운 것을 생성하는 작업은 LICENCE_LOCKED로 거절됩니다. 이러한 응답을 예상하여 생성 경로를 구축하십시오.
플러그인이 자격 확인(entitlement check)에 조직이 특정 기능을 보유하고 있는지 물으면 단순한 불리언(boolean)이 아닌 판정 결과를 받습니다. "도달할 수 없음"과 "도달할 수 있으며 보유하지 않음"은 서로 다른 코드를 가진 서로 다른 사실입니다(ENTITLEMENT_UNREACHABLE(502) 및 ENTITLEMENT_DENIED(403)). 일시적인 연결 문제로 인해 모든 고객이 조용히 무료 기본 등급으로 다운그레이드되어서는 절대 안 됩니다.
MANIFEST_SCOPE_WIDENED 상태로 보류됩니다.매니페스트가 규칙을 재명시함
모든 v2 매니페스트는 세 개의 필수 문장이 포함된 architecture 블록을 가지며, 검증기는 그 문구를 고정합니다. 자체 설치 환경을 위해 빌드하는 플러그인에서 해당 문장은 다음과 같습니다.
"architecture": {
"compute": "All compute runs via UNO dispatch (nexus-orchestrator /api/v1/dispatch + nexus-workflows). No direct engine, queue or model-provider calls from plugin code.",
"ai": "All AI goes through the AI Provider Router, which alone owns the credential and the final provider/model decision. This plugin holds no model credentials.",
"deploy": "Deploy is through the installation's release channels only."
}이 문장들은 검사됩니다. 매니페스트는 법칙에 동의하면서 코드는 모델 제공자를 호출하는 플러그인은 자체 계약에서 거짓말을 하는 것이며, 게이트는 그 거짓말을 탐지하기 위해 존재합니다.
각 규칙을 강제하는 게이트
SDK는 하나의 명령어인 nexus-gates으로 22개의 준수 게이트를 제공합니다. 2.21장, 플러그인 SDK에서 모든 게이트를 설명합니다. 여기서는 각 게이트가 유지하는 규칙별로 묶어 정리했습니다.
| 규칙 | 게이트 | 빌드를 실패시키는 요인 |
|---|---|---|
| 라우트 계층에서의 격리 | scope-adherence, one-fence, rights-register, crud-adherence |
범위 가드가 없는 /api 라우트, 직접 작성한 두 번째 테넌트 조건자, 권한이 없는 범위 라우트, 권한에 아무것도 지정하지 않은 변경(mutating) 라우트 |
| SQL에서의 격리 | sql-fence, no-set-config |
펜스가 없는 범위 지정 테이블에 대한 구문, 테넌트 설정 자체를 바인딩하는 플러그인 코드 |
| 데이터베이스에서의 격리 | migrations-are-scoped, rls-present, db-role-honest |
축이나 테넌트 선행 키가 누락된 테이블, 강제된 행 수준 보안이 없는 테이블, 소유자나 슈퍼유저로 연결하는 요청 경로 |
| 유일한 경계 넘기 | grants-declared |
매니페스트가 선언하지 않았는데 마이그레이션에서 권한이 부여된 테이블, 또는 수동으로 권한이 부여된 읽기 시트 |
| UNO를 통한 컴퓨팅 | no-direct-compute |
모델 제공자나 엔진, 또는 큐나 워크플로 호스트에 대한 직접 호출, 디스패치 URL을 읽는 두 번째 리더 |
| AI 및 키 | no-credentials |
리포지토리나 환경에서 읽을 수 있는 모델 제공자 자격 증명 |
| 선언된 계약 | api-contract, platform-clients, declared-input |
등록되었으나 선언되지 않은 라우트, 또는 선언되었으나 등록되지 않은 라우트, 임포트되었으나 지정되지 않은 플랫폼 클라이언트 |
모든 게이트에는 게이트를 작동시키도록 구축된 픽스처(fixture)에서 실패함을 증명하는 자체 테스트가 있습니다. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test은 이 모두를 실행하며, 자체 픽스처에서 실패하지 않는 게이트는 작동을 멈춘 것입니다.
검토를 요청하기 전에
이것은 제가 동료에게 플러그인 검토를 요청하기 전에 확인하는 목록입니다. 각 줄은 Corrán Orbital의 검토자가 저에게 적어도 한 번 이상 반려하며 지적했던 항목입니다.
- 모든
/api라우트는 범위 가드를 등록하며, 유일한 익명 라우트는allowAnonymous: true과 함께auth: public로 선언된 정확한 경로뿐입니다. - 범위 가드가 제공하는 모든 라우트는 매니페스트의 레지스터에서
right을 지정하며, 어떤 핸들러도 자체적인 권한 검사를 포함하지 않습니다. - 어떤 핸들러도 본문, 쿼리 또는 헤더에서 조직, 개인 또는 부서를 읽지 않습니다.
- 범위가 지정된 테이블에 대한 모든 구문은
withScopedTx내부의tenantFence을 거치며, 리포지토리의 어떤 것도set_config을 호출하지 않습니다. - 모든 테이블에는 세 개의 축 열,
organization_id이 선행하는 기본 키, 그리고 테넌트를 포함하는 복합 외래 키가 있습니다. - 디스패치 URL은 하나의 파일에서 읽히며, 디스패치 허용 목록은 네임스페이스가 지정된 작업 유형의 상수입니다.
package.json의 어떤 것도 모델 제공자와 통신하지 않으며, 환경에는 어떤 키도 존재하지 않습니다.- 일부 라이선스만 보유하는 모든 기능은 자신을 보호하는 권한에
licence을 지정합니다. npx -p @adverant-nexus/plugin-sdk@2.50.0 nexus-gates --self-test이 통과(green) 상태이고,npx -p @adverant-nexus/plugin-sdk@2.50.0 create-nexus-plugin validate nexus.manifest.json도 마찬가지입니다.
아홉 가지가 모두 충족되면 검토는 귀하의 제품 자체에 대해서만 이루어지며, 이는 검토자의 시간이 마땅히 쓰여야 할 곳입니다.
플랫폼이 이러한 규칙을 강제하는 이유
위의 각 규칙은 한때 어딘가에서 단순한 관례였고, 각 관례는 똑같은 방식으로 실패했습니다. 관례를 기억한 라우트는 괜찮았고 잊어버린 라우트가 사고로 이어졌습니다. 선택적 미들웨어로 적용된 사업부 펜스는 여섯 가지 독립적인 방식으로 우회되었는데, 모두 이를 선택하지 않은 라우트들이었습니다. 테넌트 ID를 다시 쓰는 환경 변수는 한 조직에 다른 조직의 연락처 1,406개를 제공했으며, 작성된 대상 파드(pod)에서는 올바른 값이었기 때문에 검토 과정에서도 올바른 것처럼 보였습니다.
따라서 플랫폼은 모든 표면이 이미 통과하고 있는 곳, 즉 범위 가드와 펜스 함수, 트랜잭션 래퍼와 강제된 행 수준 보안, 그리고 디스패치 클라이언트에 조건자를 배치합니다. 그런 다음 게이트가 모든 라우트와 구문, 모든 임포트를 열거하고, 그중 하나라도 이러한 메커니즘을 거치지 않고 범위 지정 테이블이나 모델 또는 컴퓨팅 엔진에 도달하면 빌드를 실패시킵니다. 이러한 설계의 대가는 첫 번째 플러그인을 만들 때 제약을 느낀다는 것입니다. 그 보상은 데이터로 가는 다른 경로가 아예 없기 때문에, 천 번째 플러그인의 작성자가 해당 기능의 존재조차 모르더라도 플러그인이 완벽히 격리된다는 점입니다.
이 모든 것에는 솔직한 한계가 있습니다. 게이트는 귀하의 코드가 메커니즘을 거친다는 것을 증명할 뿐, 귀하의 제품 로직이 올바르다는 것을 증명할 수는 없습니다. 쿼리를 소유자의 행으로 올바르게 범위를 지정하는 라우트라도 여전히 올바른 소유자에게 잘못된 행을 보여줄 수 있습니다. 2.22장, 플러그인 런타임에 있는 격리 테스트 키트는 각 펜스를 차례로 제거하면서 다른 조직으로서, 그리고 동료로서 모든 라우트를 공격하며, 이는 제가 이 내용에 대한 제 자신의 이해를 신뢰하기 전에 실행할 테스트입니다.

