교차 범위 권한 API - ServiceNow Fluent

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • 교차 범위 권한 API는 런타임 액세스 추적을 위한 교차 범위 권한[sys_scope_privilege]을 정의합니다.

    주:
    최신 ServiceNow Fluent API 설명서 및 예제는 ServiceNow Fluent API 참조ServiceNow SDK 예제 리포지토리 는 의 위치에 있습니다 GitHub.

    런타임 액세스 추적을 사용하면 시스템에서 실행 권한을 부여하는 스크립트 운영 및 대상 목록을 만들어 관리자는 애플리케이션 자원에 대한 스크립트 액세스를 관리할 수 있습니다. 교차 범위 권한에 대한 일반적인 정보는 참조하십시오 교차 범위 권한 기록.

    CrossScopePrivilege 객체

    시스템에서 애플리케이션에서 실행할 수 있는 스크립트 운영 및 대상을 결정하는 교차 범위 권한[sys_scope_privilege]을 구성합니다.

    표 1. 속성
    이름 유형 설명
    $id 문자열 또는 숫자 필수 메타데이터 객체의 고유 ID입니다. 애플리케이션을 빌드할 때 이 ID는 고유한 sys_id으로 해시됩니다. 자세한 내용은 ServiceNow Fluent 언어 구성 문서를 참조하십시오.

    형식: Now.ID['문자열' 또는 숫자]

    상태 문자열 필수 이 기록에 대한 권한 부여입니다.
    유효한 값은 다음과 같습니다.
    • 요청됨
    • 허용됨
    • 거부됨
    운영 문자열 필수 스크립트가 대상에서 수행하는 작업입니다. 대상 유형에 따라 사용 가능한 작업이 결정됩니다.

    테이블 [sys_db_object]은 읽기, 쓰기, 만들기 및 삭제 작업을 지원합니다. 스크립트 포함 [sys_script_include] 및 스크립트 객체 [sys_db_object]는 실행 작업만 지원합니다.

    유효한 값은 다음과 같습니다.
    • 생성
    • 삭제
    • 읽기
    • 쓰기
    • 실행
    targetName 문자열 필수 요청 중인 테이블, 스크립트 포함 또는 스크립트 객체의 이름입니다.
    대상 범위 문자열 필수 자원이 요청되는 애플리케이션 범위입니다.
    targetType 문자열 필수 요청의 유형입니다(스크립트 포함, 스크립트 객체 또는 테이블).
    유효한 값은 다음과 같습니다.
    • sys_script_include
    • 스크립트 가능
    • sys_db_object
    $meta 객체 애플리케이션 메타데이터의 메타데이터입니다.
    installMethod 속성을 사용하면 애플리케이션 메타데이터를 특정 상황에서만 로드되는 출력 디렉터리에 매핑할 수 있습니다.
    $meta: {
          installMethod: 'String'
    }
    installMethod에 유효한 값:
    • demo: 데모 데이터 로드 옵션을 선택한 경우 애플리케이션과 함께 설치할 metadata/unload.demo 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    • 첫 번째 설치: 애플리케이션이 인스턴스에 처음 설치될 때만 설치할 메타데이터 /언로드 디렉터리에 애플리케이션 메타데이터를 출력합니다.
    import { CrossScopePrivilege } from '@servicenow/sdk/core'
    
    CrossScopePrivilege({
       $id: Now.ID['cross_1'],
       status: 'allowed',
       operation: 'execute',
       targetName: 'Script type',
       targetScope: 'x_snc_example',
       targetType: 'scriptable',
    })