Netskope NPA MCP 서버

대규모 언어 모델(LLM)을 통해 Netskope Network Private Access(NPA) 인프라를 관리하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

경고

50개 도구가 모두 작동하려면 아직 많은 작업이 필요하므로 이를 프로덕션 환경에서 사용하지 않는 것이 좋습니다.

데모

https://github.com/johnneerdael/netskope-mcp/raw/refs/heads/main/demo.mov

설치

옵션 1: NPM 패키지

npm을 사용하여 패키지를 설치하세요:

지엑스피1

옵션 2: 지역 개발

저장소를 복제하고 종속성을 설치합니다.

MCP 구성

MCP 설정 파일에 다음 구성을 추가합니다.

WSL이 있는 Windows

NPM 설치의 경우:

지역 개발을 위해:

리눅스와 macOS

NPM 설치의 경우:

지역 개발을 위해:

환경 변수

Netskope NPA MCP 서버가 제대로 작동하려면 다음 환경 변수를 구성해야 합니다.

필수 변수

• 넷스코프_베이스_URL
  • 설명 : Netskope 테넌트의 기본 URL
  • 형식 : 프로토콜을 포함한 전체 URL
  • 예 : https://your-tenant.goskope.com
  • 사용법 : Netskope 테넌트와의 모든 API 통신에 사용됩니다.
  • 참고 : 경로 구성 요소가 없는 완전한 테넌트 URL이어야 합니다.
• 넷스코프 API 키
  • 설명 : Netskope 서비스 인증을 위한 API 토큰
  • 형식 : Netskope 관리 콘솔의 문자열 토큰
  • 예 : 030f31f7d57fd94834af57a3edc4bbda
  • 사용법 : 모든 API 요청 인증에 필요
  • 보안 참고 사항 : 이 토큰을 안전하게 보관하고 버전 제어에 커밋하지 마십시오.

구성 예제

개발 환경

프로덕션 환경

알림도구

• getAlertConfig
  • 설명 : 업그레이드 및 연결 상태 변경과 같은 다양한 이벤트에 대한 알림 기본 설정을 포함하여 게시자의 현재 알림 구성 설정을 검색합니다.
  • 필수 매개변수 : 없음
  • 응답 스키마 :
    { adminUsers: string[], // Array of admin user emails to notify eventTypes: string[], // Array of event types to monitor selectedUsers: string // Additional users to notify }
  • 이벤트 유형 :
    • UPGRADE_WILL_START : 게시자 업그레이드가 시작되기 전 알림
    • UPGRADE_STARTED : 업그레이드 프로세스가 시작될 때 알림
    • UPGRADE_SUCCEEDED : 업그레이드가 성공적으로 완료되었을 때의 알림
    • UPGRADE_FAILED : 업그레이드 프로세스가 실패할 경우 알림
    • CONNECTION_FAILED : 게시자 연결 문제 발생 시 알림
  • 사용 예 :
    1. "업그레이드 알림을 받도록 구성된 관리자를 확인하세요. getAlertConfig 사용하여 현재 관리자 사용자 목록과 알림 기본 설정을 반환합니다."
    2. "계획된 유지 관리 기간 전에 알림 구성을 확인하세요. getAlertConfig 사용하여 적절한 팀 구성원에게 업그레이드 이벤트에 대한 알림이 전송되도록 하세요."
    3. "게시자 모니터링 설정을 감사합니다. getAlertConfig 사용하여 추적 중인 중요 이벤트와 알림을 받는 사람을 확인하세요."
• 업데이트알림구성
  • 설명 : 게시자의 알림 구성 설정을 업데이트하여 업그레이드 및 연결 상태 변경을 포함한 다양한 시스템 이벤트에 대한 알림 기본 설정을 사용자 지정할 수 있습니다.
  • 필수 매개변수 :
    { adminUsers: string[], // Array of admin user emails to receive notifications eventTypes: string[], // Array of event types to monitor selectedUsers: string // Additional users to receive notifications }
  • 응답 스키마 : getAlertConfig와 동일
  • 사용 예 :
    1. "알림 구성: 중요 이벤트가 제대로 모니터링되도록 알림 설정을 업데이트합니다."
    2. 수신자 수정: 특정 유형의 알림을 받는 관리자 목록을 조정합니다.
    3. "이벤트 선택: 다양한 사용자 그룹에 대한 알림을 트리거하는 이벤트 유형을 사용자 정의합니다."

로컬브로커툴즈

• 로컬브로커 목록
  • 설명 : Netskope 환경에 구성된 모든 로컬 브로커를 나열합니다. 로컬 브로커는 최종 사용자가 온프레미스에서 호스팅되는 프라이빗 애플리케이션에 액세스하기 위해 클라우드 브로커 대신 로컬 브로커에 연결하는 온프레미스 제로 트러스트 네트워크 액세스(ZTNA) 시나리오에 사용됩니다.
  • 필수 매개변수 : 없음
  • 선택 매개변수 :
    • fields : 응답에서 반환할 특정 필드의 배열
  • 응답 스키마 :
    { status: 'success' | 'not found', total: number, data: Array<{ id: number, // Unique identifier for the local broker name: string, // Display name of the local broker common_name: string, // Common name used for broker identification registered: boolean // Registration status of the broker }> }
  • 사용 예 :
    1. "모든 등록된 브로커와 현재 상태에 대한 개요를 파악하기 위해 지역 브로커를 나열하여 지역 브로커 배치를 모니터링하세요."
    2. 고가용성 설정 확인: 배포된 브로커 목록을 검토하여 사이트별로 여러 개의 로컬 브로커가 구성되어 있는지 확인하세요.
    3. "브로커 등록 감사: 등록되지 않은 인스턴스 중 주의가 필요한 인스턴스를 파악하기 위해 모든 로컬 브로커를 나열합니다."
• createLocalBroker
  • 설명 : 온프레미스 ZTNA 트래픽을 처리하기 위한 새로운 로컬 브로커 인스턴스를 생성합니다. 일반적으로 새 사이트를 설정하거나 기존 위치의 용량을 확장할 때 사용됩니다.
  • 필수 매개변수 :
    { name: string // Name for the new local broker }
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { id: number, // Assigned unique identifier name: string, // Configured broker name common_name: string, // Assigned common name registered: boolean // Initial registration status } }
  • 사용 예 :
    1. "새로운 사이트를 구축하세요. 새로운 사무실 위치에서 높은 가용성을 보장하려면 로컬 브로커를 두 번 만드세요."
    2. "용량 확장: 새로운 브로커 인스턴스를 생성하여 온프레미스 트래픽 증가를 처리할 로컬 브로커를 추가합니다."
    3. HA 설정 초기화: 사이트와 역할을 나타내는 설명적 이름으로 여러 로컬 브로커를 만듭니다.
• getLocalBroker
  • 설명 : 특정 로컬 브로커의 ID를 기준으로 해당 브로커에 대한 자세한 정보를 검색합니다. 이를 사용하여 개별 브로커 인스턴스의 상태 및 구성을 모니터링할 수 있습니다.
  • 필수 매개변수 :
    • id : 검색할 로컬 브로커의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { id: number, // Broker's unique identifier name: string, // Broker's display name common_name: string, // Broker's common name registered: boolean // Current registration status } }
  • 사용 예 :
    1. "브로커 상태 확인: 특정 브로커 세부 정보를 검색하여 등록 상태와 구성을 확인합니다."
    2. "연결 문제 해결: 문제가 발생한 브로커에 대한 자세한 정보를 얻으세요."
    3. "배포 확인: 세부 정보를 검색하여 새로운 브로커가 성공적으로 생성되었는지 확인합니다."
• 로컬 브로커 업데이트
  • 설명 : 기존 로컬 브로커의 구성을 업데이트합니다. 이를 통해 브로커의 ID와 연결을 유지하면서 브로커 이름 등의 설정을 수정할 수 있습니다.
  • 필수 매개변수 :
    { id: number, // Identifier of broker to update name: string // New name for the broker }
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { id: number, // Broker's identifier name: string, // Updated broker name common_name: string, // Broker's common name registered: boolean // Current registration status } }
  • 사용 예 :
    1. "명확성을 위해 이름 변경: 인프라에서의 위치나 역할을 더 잘 반영하도록 브로커의 이름을 업데이트하세요."
    2. "명명 표준화: 조직 전체의 업데이트된 명명 규칙을 따르도록 브로커 이름을 수정합니다."
    3. HA 쌍 업데이트: 브로커 이름을 조정하여 기본 및 보조 역할을 명확하게 나타냅니다.
• 로컬 브로커 삭제
  • 설명 : Netskope 구성에서 로컬 브로커를 제거합니다. 브로커를 해제하거나 사용하지 않는 인스턴스를 정리할 때 이 기능을 사용하세요.
  • 필수 매개변수 :
    • id : 삭제할 로컬 브로커의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'not found' }
  • 사용 예 :
    1. "오래된 브로커 해체: 더 이상 필요하지 않거나 교체된 브로커를 제거합니다."
    2. "테스트 인스턴스 정리: 테스트 목적으로 생성된 임시 브로커를 삭제합니다."
    3. "사이트 통합: 활성 사이트의 서비스를 유지하는 동시에 폐쇄된 위치에서 브로커를 제거합니다."
• getBrokerConfig
  • 설명 : 모든 브로커 인스턴스에 영향을 미치는 호스트 이름 구성을 포함하여 로컬 브로커에 대한 글로벌 구성 설정을 검색합니다.
  • 필수 매개변수 : 없음
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { hostname: string // Global hostname configuration } }
  • 사용 예 :
    1. "전역 설정 검토: 모든 로컬 브로커에 영향을 미치는 현재 호스트 이름 구성을 확인하세요."
    2. "변경에 대비하세요: 업데이트를 계획하기 전에 기존 구성을 확인하세요."
    3. "구성 감사: 호스트 이름 설정이 네트워크 아키텍처와 일치하는지 확인하세요."
• updateBrokerConfig
  • 설명 : 모든 로컬 브로커에 대한 글로벌 구성 설정을 업데이트하여 시스템 전체 브로커 동작을 수정할 수 있습니다.
  • 필수 매개변수 :
    { hostname: string // New hostname configuration }
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { hostname: string // Updated hostname configuration } }
  • 사용 예 :
    1. "전역 설정 수정: 네트워크 변경 사항을 반영하도록 호스트 이름 구성을 업데이트합니다."
    2. "인프라 업데이트: 새로운 네트워킹 요구 사항을 수용하도록 브로커 구성을 조정합니다."
    3. "표준화된 설정: 모든 브로커 인스턴스에서 일관된 호스트 이름 구성을 보장합니다."
• 로컬 브로커 등록 토큰 생성
  • 설명 : 특정 로컬 브로커에 대한 새로운 등록 토큰을 생성하여 Netskope 관리 평면에 대한 보안 등록을 가능하게 합니다.
  • 필수 매개변수 :
    • id : 로컬 브로커의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'not found', data: { token: string // Generated registration token } }
  • 사용 예 :
    1. "새로운 브로커 보안: 새로 배포된 로컬 브로커를 안전하게 등록하기 위한 토큰을 생성합니다."
    2. "브로커 재등록: 브로커 등록을 재설정해야 할 때 새 토큰을 생성합니다."
    3. "토큰 로테이션: 보안 유지 관리의 일환으로 새로운 등록 토큰을 생성합니다."

정책 도구

• 목록 규칙
  • 설명 : Netskope Private Access 환경에 구성된 모든 정책 규칙을 나열합니다. 이 규칙은 Zero Trust Network Access(ZTNA) 원칙을 사용하여 개인 애플리케이션에 대한 액세스 제어를 정의합니다.
  • 필수 매개변수 : 없음
  • 선택 매개변수 :
    • fields : 반환할 특정 필드의 배열
    • filter : 규칙에 대한 필터 기준
    • limit : 반환할 최대 규칙 수
    • offset : 건너뛸 규칙의 개수
    • sortby : 정렬 기준 필드
    • sortorder : 정렬 방향('asc' 또는 'desc')
  • 응답 스키마 :
    { data: { rules: Array<{ id: number, name: string, description?: string, enabled: boolean, action: 'allow' | 'block', policy_group_id: number, priority: number, conditions: Array<{ type: 'private_app' | 'user' | 'group' | 'organization_unit' | 'location' | 'device', operator: 'in' | 'not_in' | 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with', value: string | string[] | number | number[] }>, created_at: string, updated_at: string }> }, status: 'success' | 'error', total: number }
  • 사용 예 :
    1. "모든 구성된 규칙과 해당 조건을 검토하여 적절한 액세스 제어를 보장하기 위해 액세스 정책을 감사합니다."
    2. 규칙의 우선순위 지정: 정책 평가 순서를 파악하고 잠재적 갈등을 파악하기 위해 우선순위별로 규칙을 정렬합니다.
    3. "특정 정책 필터링: 필터 매개변수를 사용하여 특정 애플리케이션이나 사용자 그룹과 관련된 규칙을 검색합니다."
• getRule
  • 설명 : ID를 기준으로 특정 정책 규칙에 대한 자세한 정보를 검색합니다. 이를 사용하여 개별 규칙 구성 및 조건을 검토할 수 있습니다.
  • 필수 매개변수 :
    • id : 정책 규칙의 숫자 식별자
  • 선택 매개변수 :
    • fields : 반환할 특정 필드의 배열
  • 응답 스키마 :
    { data: { id: number, name: string, description?: string, enabled: boolean, action: 'allow' | 'block', policy_group_id: number, priority: number, conditions: Array<{ type: 'private_app' | 'user' | 'group' | 'organization_unit' | 'location' | 'device', operator: 'in' | 'not_in' | 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with', value: string | string[] | number | number[] }>, created_at: string, updated_at: string }, status: 'success' | 'error' }
  • 사용 예 :
    1. "액세스 문제 해결: 특정 규칙 세부 정보를 검토하여 액세스가 차단되거나 허용되는 이유를 파악합니다."
    2. "규칙 조건 확인: 중요 액세스 정책에 대해 구성된 정확한 조건을 확인합니다."
    3. "규칙 기록 검토: 정책 변경 사항을 추적하기 위해 생성 및 업데이트 타임스탬프를 확인하세요."
• 생성규칙
  • 설명 : 비공개 애플리케이션에 대한 액세스를 제어하는 새로운 정책 규칙을 생성합니다. 규칙은 사용자 신원, 기기 상태, 위치 등 다양한 조건을 기반으로 설정할 수 있습니다.
  • 필수 매개변수 :
    { name: string, // Rule name description?: string, // Optional rule description enabled: boolean, // Rule status action: 'allow' | 'block', // Access action policy_group_id: number, // Associated policy group priority: number, // Rule priority conditions: Array<{ type: 'private_app' | 'user' | 'group' | 'organization_unit' | 'location' | 'device', operator: 'in' | 'not_in' | 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with', value: string | string[] | number | number[] }> }
  • 사용 예 :
    1. "최소 권한 액세스 구현: 사용자 역할 및 장치 상태에 따라 특정 애플리케이션에만 액세스 권한을 부여하는 규칙을 만듭니다."
    2. "위치 기반 정책 설정: 규정 준수 요구 사항에 맞게 사용자 위치에 따라 액세스를 제한하는 규칙을 정의합니다."
    3. "그룹 기반 액세스 구성: 특정 사용자 그룹이 지정된 개인 애플리케이션에 액세스할 수 있도록 허용하는 규칙을 만듭니다."
• 업데이트 규칙
  • 설명 : 기존 정책 규칙의 구성을 업데이트합니다. 액세스 제어, 조건 또는 규칙 속성을 수정하는 데 사용합니다.
  • 필수 매개변수 :
    • id : 업데이트할 규칙의 숫자 식별자
    • data : create_rule과 동일한 스키마를 따르는 업데이트된 규칙 구성
  • 응답 스키마 :
    { data: { // Updated rule details (same as get_rule response) }, status: 'success' | 'error' }
  • 사용 예 :
    1. "액세스 조건 조정: 새로운 보안 요구 사항이나 조직 변경 사항에 맞게 규칙 조건을 수정합니다."
    2. "규칙 우선순위 업데이트: 적절한 정책 평가 순서를 보장하기 위해 규칙의 우선순위를 변경합니다."
    3. "규칙 활성화/비활성화: 유지 관리 중이나 정책 변경을 구현할 때 규칙 상태를 전환합니다."
• 규칙 삭제
  • 설명 : 구성에서 정책 규칙을 제거합니다. 액세스 제어 정책이 영구적으로 제거되므로 주의해서 사용하세요.
  • 필수 매개변수 :
    • id : 삭제할 규칙의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'error' }
  • 사용 예 :
    1. "쓸모없는 정책을 정리하세요. 더 이상 필요하지 않거나 새로운 정책으로 대체된 규칙을 제거하세요."
    2. 정책 통합: 정책 구성을 병합한 후 중복된 규칙을 삭제합니다.
    3. "임시 규칙 제거: 특정 프로젝트나 유지 관리를 위해 생성된 임시 액세스 정책을 정리합니다."

프라이빗앱스툴즈

• 개인 앱 만들기
  • 설명 : Netskope 환경에 새로운 개인 애플리케이션을 생성합니다. 이를 통해 Zero Trust Network Access(ZTNA) 인프라를 통해 액세스할 수 있는 애플리케이션을 정의하고 구성할 수 있습니다.
  • 필수 매개변수 :
    { app_name: string, // Name of the private application host: string, // Host address of the application clientless_access: boolean, // Enable clientless access is_user_portal_app: boolean, // Show in user portal protocols: Array<{ port: string, // Port number type: 'tcp' | 'udp' // Protocol type }>, publisher_tags?: Array<{ // Optional publisher tags tag_name: string }>, publishers: Array<{ // Associated publishers publisher_id: string, publisher_name: string }>, trust_self_signed_certs: boolean, // Trust self-signed certificates use_publisher_dns: boolean, // Use publisher DNS allow_unauthenticated_cors?: boolean, // Optional CORS settings allow_uri_bypass?: boolean, // Optional URI bypass bypass_uris?: string[], // Optional bypass URIs real_host?: string, // Optional real host app_option?: Record<string, unknown> // Additional options }
  • 응답 스키마 :
    { data: { allow_unauthenticated_cors: boolean, allow_uri_bypass: boolean, uribypass_header_value: string, bypass_uris: string[], app_option: Record<string, unknown>, clientless_access: boolean, host: string, id: number, is_user_portal_app: boolean, name: string, protocols: Array<{ ports: string[], type: string }>, real_host: string, service_publisher_assignments: Array<{ primary: boolean, publisher_id: number, publisher_name: string, reachability: { error_code: number, error_string: string, reachable: boolean }, service_id: number }>, tags: Array<{ tag_id: number, tag_name: string }>, trust_self_signed_certs: boolean, use_publisher_dns: boolean }, status: 'success' | 'not found' }
  • 사용 예 :
    1. "내부 애플리케이션 배포: 특정 프로토콜 및 보안 설정을 사용하여 내부 웹 서비스에 대한 비공개 앱 정의를 만듭니다."
    2. 고가용성 구성: 중복성을 위해 여러 게시자가 있는 개인 애플리케이션을 설정합니다.
    3. "보안 액세스 활성화: 엄격한 보안 설정과 특정 우회 규칙이 적용된 비공개 앱을 만드세요."
• 개인 앱 업데이트
  • 설명 : 기존 개인 애플리케이션의 구성을 업데이트하여 액세스 설정, 프로토콜 및 보안 매개변수를 수정할 수 있도록 합니다.
  • 필수 매개변수 :
    { id: number, // Application ID // All other fields same as create_private_app }
  • 응답 스키마 : create_private_app과 동일
  • 사용 예 :
    1. "보안 설정 수정: 보안을 강화하기 위해 인증서 신뢰 설정과 CORS 구성을 업데이트합니다."
    2. "액세스 매개변수 조정: 변화하는 요구 사항에 맞게 프로토콜을 업데이트하거나 규칙을 우회합니다."
    3. "게시자 재할당: 애플리케이션 트래픽을 처리하는 게시자 목록을 수정합니다."
• 개인 앱 삭제
  • 설명 : Netskope 구성에서 비공개 애플리케이션을 제거합니다. 이 작업을 수행하면 애플리케이션 정의와 관련 액세스 제어가 영구적으로 제거됩니다.
  • 필수 매개변수 :
    • id : 개인 애플리케이션의 숫자 식별자
  • 응답 스키마 :
    { status: number, result: string }
  • 사용 예 :
    1. "서비스 해제: 더 이상 사용하지 않는 개인 애플리케이션을 제거합니다."
    2. 테스트 앱 정리: 테스트에 사용된 임시 애플리케이션을 삭제합니다.
    3. "더 이상 사용되지 않는 서비스 제거: 인프라 업데이트 중에 오래된 애플리케이션 정의를 정리합니다."
• getPrivateApp
  • 설명 : 특정 개인 애플리케이션에 대한 자세한 구성 정보를 검색합니다.
  • 필수 매개변수 :
    • id : 개인 애플리케이션의 숫자 식별자
  • 응답 스키마 : create_private_app 응답과 동일
  • 사용 예 :
    1. "구성 감사: 규정 준수 검사를 위해 개인 애플리케이션의 세부 설정을 검토합니다."
    2. "액세스 문제 해결: 애플리케이션 구성을 검사하여 연결 문제를 해결하세요."
    3. 설정 확인: 애플리케이션을 변경한 후 구성이 올바른지 확인하세요.
• 개인 앱 목록
  • 설명 : 구성된 모든 개인 애플리케이션과 해당 구성의 목록을 검색합니다.
  • 필수 매개변수 : 없음
  • 선택 매개변수 :
    • fields : 반환할 특정 필드
    • filter : 필터 기준
    • query : 검색 쿼리
    • limit : 최대 결과 수
    • offset : 건너뛸 결과 수
  • 응답 스키마 :
    { data: Array<{ // Same fields as get_private_app response }>, status: 'success' | 'not found', total: number }
  • 사용 예 :
    1. "재고 신청서: 감사 목적으로 모든 개인 신청서의 전체 목록을 받으세요."
    2. "기준별 필터링: 특정 구성이나 태그가 있는 애플리케이션을 검색합니다."
    3. "페이지별 리뷰: 대규모 배포를 위해 관리 가능한 단위로 애플리케이션을 검색합니다."
• getPrivateAppTags
  • 설명 : 개인 애플리케이션과 연관된 모든 태그를 검색합니다. 애플리케이션을 구성하고 분류하는 데 유용합니다.
  • 필수 매개변수 : 없음
  • 선택 매개변수 :
    • query : 태그에 대한 검색 쿼리
    • limit : 태그의 최대 개수
    • offset : 건너뛸 태그의 개수
  • 응답 스키마 :
    { data: Array<{ tag_id: number, tag_name: string }>, status: 'success' | 'not found' }
  • 사용 예 :
    1. "카테고리 나열: 모든 태그를 검색하여 애플리케이션 분류를 파악합니다."
    2. "태그 검색: 특정 기준과 일치하는 특정 태그를 찾습니다."
    3. 태그 인벤토리: 표준화 목적으로 사용 가능한 모든 태그를 검토합니다.
• 개인 앱 태그 생성
  • 설명 : 더 나은 구성 및 관리를 위해 새로운 태그를 개인 애플리케이션과 연결합니다.
  • 필수 매개변수 :
    • id : 애플리케이션 식별자
    • tags : 태그 객체의 배열
  • 사용 예 :
    1. "앱 분류: 조직 태그를 추가하여 관련 앱을 그룹화합니다."
    2. "환경 라벨링: 배포 환경에 따라 애플리케이션에 태그를 지정합니다."
    3. "팀 할당: 애플리케이션을 소유하거나 관리하는 팀을 나타내는 태그를 추가합니다."
• updatePrivateAppTags
  • 설명 : 하나 이상의 개인 애플리케이션과 관련된 태그를 업데이트합니다.
  • 필수 매개변수 :
    • ids : 애플리케이션 식별자 배열
    • tags : 업데이트된 태그 객체의 배열
  • 사용 예 :
    1. "대량 태그 업데이트: 여러 애플리케이션의 태그를 동시에 수정합니다."
    2. "태그 표준화: 새로운 명명 규칙에 맞게 태그를 업데이트합니다."
    3. "소유권 변경: 새로운 팀 배정을 반영하도록 태그를 업데이트하세요."
• 개인 앱 게시자 업데이트
  • 설명 : 개인 애플리케이션에 대한 게시자 할당을 업데이트하여 애플리케이션 트래픽을 처리하는 게시자를 제어합니다.
  • 필수 매개변수 :
    { private_app_ids: string[], // Application IDs publisher_ids: string[] // Publisher IDs }
  • 사용 예 :
    1. "부하 분산: 여러 게시자에게 애플리케이션 트래픽을 분산합니다."
    2. "퍼블리셔 마이그레이션: 애플리케이션을 새로운 퍼블리셔나 다른 퍼블리셔로 이동합니다."
    3. "HA 구성: 고가용성을 위해 백업 게시자를 추가합니다."
• 개인 앱 게시자 삭제
  • 설명 : 개인 애플리케이션에서 게시자 할당을 제거합니다.
  • 필수 매개변수 :
    { private_app_ids: string[], // Application IDs publisher_ids: string[] // Publisher IDs to remove }
  • 사용 예 :
    1. "게시자 서비스 중단: 애플리케이션 구성에서 이전 게시자를 제거합니다."
    2. "할당 정리: 불필요한 게시자 할당을 제거하세요."
    3. "라우팅 재구성: 트래픽 흐름 업데이트 중에 게시자를 제거합니다."
• getDiscoverySettings
  • 설명 : 개인 애플리케이션의 현재 검색 설정을 검색합니다. 이 설정은 애플리케이션이 검색되고 모니터링되는 방식을 제어합니다.
  • 필수 매개변수 : 없음
  • 사용 예 :
    1. "검색 검토: 현재 애플리케이션 검색 구성을 확인하세요."
    2. "감사 설정: 규정 준수를 위해 검색 매개변수를 확인합니다."
    3. "모니터링 구성: 애플리케이션이 어떻게 검색되고 추적되는지 살펴보세요."
• getPolicyInUse
  • 설명 : 지정된 개인 애플리케이션과 연관된 활성 정책을 검색합니다.
  • 필수 매개변수 :
    • ids : 애플리케이션 식별자 배열
  • 사용 예 :
    1. 정책 감사: 어떤 정책이 특정 애플리케이션에 영향을 미치는지 검토합니다.
    2. "접근 제어 검토: 보안 규정 준수를 위한 정책 할당을 확인합니다."
    3. "접근 문제 해결: 접근 문제를 조사할 때 정책을 확인하세요."

게시자도구

• 게시자 목록
  • 설명 : Netskope 환경에 구성된 모든 게시자를 나열합니다. 게시자는 개인 애플리케이션 트래픽을 처리하는 구성 요소이며, 최적의 성능을 위해 적절한 관리가 필요합니다.
  • 필수 매개변수 : 없음
  • 선택 매개변수 :
    • fields : 응답에서 반환할 특정 필드
  • 응답 스키마 :
    { data: { publishers: Array<{ apps_count: number, assessment: { ca_certs_status: { hashes: string[], last_modified: number }, eee_support: boolean, hdd_free: string, hdd_total: string, ip_address: string, latency: number, version: string }, capabilities: { DTLS: boolean, EEE: boolean, auto_upgrade: boolean, nwa_ba: boolean, pull_nsconfig: { orgkey_exist: boolean, orguri_exist: boolean } }, common_name: string, connected_apps: string[], id: number, lbrokerconnect: boolean, name: string, publisher_upgrade_profiles_id: number, registered: boolean, status: 'connected' | 'not registered', stitcher_id: number, sticher_pop: string, upgrade_request: boolean, upgrade_status: { upstat: string } }> }, status: 'success' | 'not found', total: number }
  • 사용 예 :
    1. "배포 모니터링: 모든 게시자를 나열하여 연결 상태와 기능을 확인합니다."
    2. "구성 감사: 게시자 설정 및 관련 애플리케이션을 검토합니다."
    3. "용량 계획: 앱 수와 게시자 전체의 부하를 확인하세요."
• getPublisher
  • 설명 : 구성, 상태, 기능을 포함하여 특정 게시자에 대한 자세한 정보를 검색합니다.
  • 필수 매개변수 :
    • id : 게시자의 숫자 식별자
  • 응답 스키마 : list_publishers 응답의 개별 게시자와 동일
  • 사용 예 :
    1. "상태 점검: 특정 게시자에 대한 자세한 상태 정보를 확인하세요."
    2. "연결 문제 해결: 게시자 기능과 연결 상태를 검사하세요."
    3. "버전 확인: 게시자 버전과 업그레이드 상태를 확인하세요."
• 생성자
  • 설명 : Netskope 환경에서 새로운 게시자 인스턴스를 만듭니다.
  • 필수 매개변수 :
    { name: string, // Publisher name lbrokerconnect?: boolean, // Optional local broker connection publisher_upgrade_profiles_id?: number // Optional upgrade profile assignment }
  • 응답 스키마 : get_publisher 응답과 동일
  • 사용 예 :
    1. "새로운 게시자 배포: 새로운 데이터 센터 위치에 대한 게시자를 만듭니다."
    2. "용량 확장: 증가한 애플리케이션 트래픽을 처리할 게시자를 추가하세요."
    3. "HA 구성: 고가용성 설정을 위한 추가 게시자 생성"
• 패치 퍼블리셔
  • 설명 : 게시자의 구성을 부분적으로 업데이트하여 다른 설정을 유지하면서 특정 설정을 수정할 수 있도록 합니다.
  • 필수 매개변수 :
    { name: string, // Publisher name id?: number, // Optional publisher ID lbrokerconnect?: boolean, // Optional local broker connection publisher_upgrade_profiles_id?: number // Optional upgrade profile assignment }
  • 응답 스키마 : get_publisher 응답과 동일
  • 사용 예 :
    1. "이름 업데이트: 새로운 명명 규칙에 맞게 게시자 이름을 변경합니다."
    2. "연결 수정: 로컬 브로커 연결 설정을 업데이트합니다."
    3. "프로필 할당: 게시자를 업그레이드 프로필에 연결합니다."
• 업데이트 게시자
  • 설명 : 게시자 구성을 완전히 업데이트하고 모든 설정을 제공된 값으로 바꿉니다.
  • 필수 매개변수 :
    { id: number, // Publisher ID name: string, // Publisher name lbrokerconnect?: boolean, // Optional local broker connection tags?: Array<{ // Optional tags tag_id: number, tag_name: string }> }
  • 응답 스키마 : get_publisher 응답과 동일
  • 사용 예 :
    1. "전체 재구성: 모든 게시자 설정을 한 번에 업데이트합니다."
    2. "태그 관리: 게시자 태그와 구성을 함께 업데이트합니다."
    3. "설정 재설정: 기존 구성을 새 값으로 바꿉니다."
• 게시자 삭제
  • 설명 : Netskope 구성에서 게시자를 제거합니다. 애플리케이션 액세스에 영향을 미치므로 주의해서 사용하십시오.
  • 필수 매개변수 :
    • id : 삭제할 게시자의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'error' }
  • 사용 예 :
    1. "게시자 서비스 중단: 서비스가 중단되는 게시자를 제거합니다."
    2. "테스트 인스턴스 정리: 테스트에 사용된 게시자를 삭제합니다."
    3. "사용하지 않는 항목 제거: 더 이상 필요하지 않은 게시자를 정리합니다."
• 대량 업그레이드 게시자
  • 설명 : 여러 게시자에 대한 업그레이드를 동시에 시작합니다.
  • 필수 매개변수 :
    { publishers: { apply: { upgrade_request: boolean // Whether to request upgrade }, id: string[] // Array of publisher IDs } }
  • 응답 스키마 :
    { data: { publishers: Array<PublisherResponse> }, status: 'success' | 'not found' }
  • 사용 예 :
    1. "대량 업그레이드: 특정 지역의 모든 게시자를 업그레이드합니다."
    2. "단계적 출시: 여러 퍼블리셔를 한꺼번에 업그레이드합니다."
    3. "긴급 패치: 여러 게시자에 중요 업데이트를 적용합니다."
• getReleases
  • 설명 : 사용 가능한 출판사 출시에 대한 정보를 검색합니다.
  • 필수 매개변수 : 없음
  • 응답 스키마 :
    { data: Array<{ docker_tag: string, is_recommended: boolean, release_type: 'Beta' | 'Latest' | 'Latest-1' | 'Latest-2', version: string }>, status: 'success' | 'not found' }
  • 사용 예 :
    1. 버전 계획: 업그레이드 계획을 위해 사용 가능한 릴리스를 확인하세요.
    2. "릴리스 추적: 새로운 버전과 권장 사항을 모니터링합니다."
    3. "호환성 검사: 업그레이드하기 전에 릴리스 유형을 확인하세요."
• getPrivateApps
  • 설명 : 특정 게시자와 관련된 개인 애플리케이션 목록을 검색합니다.
  • 필수 매개변수 :
    • publisherId : 게시자의 숫자 식별자
  • 응답 스키마 : 애플리케이션별 응답
  • 사용 예 :
    1. "앱 인벤토리: 게시자가 처리하는 모든 애플리케이션을 나열합니다."
    2. "부하 평가: 게시자의 앱 수와 유형을 확인하세요."
    3. "마이그레이션 계획: 다른 게시자로 이동하기 전에 앱을 검토하세요."
• generatePublisherRegistrationToken
  • 설명 : 게시자를 위한 새로운 등록 토큰을 생성하여 Netskope 제어 평면에서 보안 등록을 활성화합니다.
  • 필수 매개변수 :
    • publisherId : 게시자의 숫자 식별자
  • 응답 스키마 :
    { data: { token: string // Registration token }, status: string }
  • 사용 예 :
    1. "초기 설정: 새로운 게시자 등록을 위한 토큰을 생성합니다."
    2. "재등록: 게시자 재연결을 위한 새로운 토큰을 만듭니다."
    3. "보안 새로 고침: 등록 토큰을 주기적으로 교체하세요."

업그레이드 프로필 도구

• listUpgradeProfiles
  • 설명 : Netskope 환경에 구성된 모든 업그레이드 프로필을 나열합니다. 업그레이드 프로필은 게시자 업그레이드가 수행되는 시기와 방법을 정의합니다.
  • 필수 매개변수 : 없음
  • 응답 스키마 :
    { data: { upgrade_profiles: Array<{ id: number, external_id: number, name: string, docker_tag: string, enabled: boolean, frequency: string, // Cron format: minute hour day * DAY_OF_WEEK timezone: string, // Standard timezone identifier release_type: 'Beta' | 'Latest' | 'Latest-1' | 'Latest-2', created_at: string, updated_at: string, next_update_time?: number, num_associated_publisher: number, upgrading_stage?: number, will_start?: boolean }> }, status: 'success' | 'not found', total: number }
  • 사용 예 :
    1. 업그레이드 일정 검토: 모든 프로필을 나열하여 다양한 게시자의 업그레이드 일정을 파악합니다.
    2. "구성 감사: 모든 업그레이드 프로필의 설정과 일정이 일관성을 유지하는지 확인합니다."
    3. 업그레이드 상태 모니터링: 현재 업그레이드 중이거나 업데이트가 예약된 프로필을 확인하세요.
• 업그레이드 프로필 가져오기
  • 설명 : 일정 및 구성을 포함하여 특정 업그레이드 프로필에 대한 자세한 정보를 검색합니다.
  • 필수 매개변수 :
    • id : 업그레이드 프로필의 숫자 식별자
  • 응답 스키마 : list_upgrade_profiles의 개별 프로필과 동일
  • 사용 예 :
    1. "설정 확인: 업그레이드 창 전에 특정 프로필 구성을 확인하세요."
    2. "업그레이드 문제 해결: 업그레이드 문제를 조사할 때 프로필 세부 정보를 검토하세요."
    3. "진행 상황 모니터링: 진행 중인 업그레이드 프로세스의 상태를 추적합니다."
• createUpgradeProfile
  • 설명 : 자동 게시자 업그레이드를 관리하기 위한 새 업그레이드 프로필을 만듭니다. 프로필은 게시자에 대한 업데이트 적용 시기와 방식을 제어합니다.
  • 필수 매개변수 :
    { name: string, // Profile name enabled: boolean, // Profile status docker_tag: string, // Docker image tag for upgrade frequency: string, // Cron schedule format timezone: string, // Timezone for schedule release_type: 'Beta' | 'Latest' | 'Latest-1' | 'Latest-2' }
  • 사용 예 :
    1. "일정 유지 관리: 정기적인 근무 외 시간 업그레이드를 위한 프로필을 만드세요."
    2. 베타 테스트: 선택한 퍼블리셔에서 새로운 릴리스를 테스트하기 위한 프로필을 설정합니다.
    3. "지역 업데이트: 다양한 시간대 유지 관리 창에 맞춰 프로필을 만듭니다."
• 업데이트업그레이드프로파일
  • 설명 : 기존 업그레이드 프로필의 구성을 업데이트하여 일정, 릴리스 유형 및 기타 설정을 수정할 수 있습니다.
  • 필수 매개변수 :
    • id : 프로필 식별자
    • data : 업데이트된 프로필 구성(create_upgrade_profile과 동일한 스키마)
  • 응답 스키마 :
    { data: { // Updated profile details (same as get_upgrade_profile response) }, status: 'success' | 'not found' }
  • 사용 예 :
    1. "일정 조정: 유지 관리 기간에 더 잘 맞춰 업그레이드 시기를 수정합니다."
    2. "릴리스 트랙 변경: 다른 릴리스 유형을 사용하도록 프로필을 업데이트하세요."
    3. "업그레이드 활성화/비활성화: 변경 동결 기간 동안 프로필 상태를 전환합니다."
• deleteUpgradeProfile
  • 설명 : 구성에서 업그레이드 프로필을 제거합니다. 자동 업그레이드 일정에 영향을 미치므로 주의해서 사용하십시오.
  • 필수 매개변수 :
    • id : 삭제할 프로필의 숫자 식별자
  • 응답 스키마 :
    { status: 'success' | 'not found' }
  • 사용 예 :
    1. "오래된 프로필 제거: 사용하지 않는 업그레이드 구성을 정리합니다."
    2. "프로필 통합: 업그레이드 일정을 통합한 후 중복된 프로필을 삭제합니다."
    3. 테스트 프로필 정리: 업그레이드 테스트에 사용된 임시 프로필을 제거합니다.

스티어링툴즈

• 업데이트 게시자 협회
  • 설명 : 개인 애플리케이션과 게시자 간의 연결을 업데이트하여 특정 애플리케이션 트래픽을 처리하는 게시자를 수정할 수 있습니다.
  • 필수 매개변수 :
    { private_app_ids: string[], // Array of private application IDs publisher_ids: string[] // Array of publisher IDs }
  • 응답 스키마 :
    { status: 'success' | 'error', data: { private_app_ids: string[], publisher_ids: string[] } }
  • 사용 예 :
    1. "게시자 재지정: 특정 개인 애플리케이션을 처리하는 게시자를 업데이트합니다."
    2. "부하 분산: 더 나은 트래픽 분산을 위해 게시자 할당을 수정합니다."
    3. "HA 구성: 애플리케이션 중복성을 위해 여러 게시자를 설정합니다."
• deletePublisherAssociation
  • 설명 : 개인 애플리케이션과 게시자 간의 연결을 제거하여 해당 게시자가 애플리케이션 트래픽을 처리하지 못하도록 효과적으로 차단합니다.
  • 필수 매개변수 :
    { private_app_ids: string[], // Array of private application IDs publisher_ids: string[] // Array of publisher IDs to remove }
  • 응답 스키마 : update_publisher_association과 동일
  • 사용 예 :
    1. "연관성 제거: 특정 게시자가 특정 애플리케이션을 처리하지 못하도록 합니다."
    2. "구성 정리: 불필요한 게시자 할당을 제거합니다."
    3. "폐쇄에 대비하세요: 퍼블리셔를 은퇴시키기 전에 애플리케이션을 제거하세요."
• getUserDiagnostics
  • 설명 : 개인 애플리케이션에 대한 사용자 액세스에 대한 진단 정보를 검색하여 연결 문제를 해결하는 데 도움이 됩니다.
  • 필수 매개변수 : 없음
  • 응답 스키마 :
    { status: 'success' | 'error', data: { user_id: string, diagnostics: Array<{ private_app_id: string, private_app_name: string, publisher_id: string, publisher_name: string, status: string, timestamp: string }> } }
  • 사용 예 :
    1. "접근 문제 해결: 개인 애플리케이션에 대한 사용자 연결 문제를 조사합니다."
    2. "액세스 패턴 감사: 사용자가 어떤 게시자를 통해 연결하는지 검토합니다."
    3. "성능 모니터링: 사용자 액세스에 대한 연결 상태와 타이밍을 확인합니다."
• getDeviceDiagnostics
  • 설명 : 특정 개인 애플리케이션에 대한 장치 액세스에 대한 진단 정보를 검색합니다.
  • 필수 매개변수 :
    • deviceId : 장치 식별자
    • privateAppId : 개인 애플리케이션 식별자
  • 응답 스키마 :
    { status: 'success' | 'error', data: { device_id: string, private_app_id: string, diagnostics: Array<{ publisher_id: string, publisher_name: string, status: string, timestamp: string }> } }
  • 사용 예 :
    1. "기기 문제 해결: 특정 기기 연결 문제를 조사합니다."
    2. "애플리케이션 액세스: 개인 애플리케이션에 대한 장치별 액세스를 확인하세요."
    3. "연결 기록: 기기의 연결 패턴과 상태를 검토합니다."

검증 도구

• validateName
  • 설명 : 다양한 리소스(게시자, 비공개 앱, 정책 등)의 이름을 검증하여 명명 요구 사항을 충족하는지 확인합니다.
  • 필수 매개변수 :
    { resourceType: 'publisher' | 'private_app' | 'policy' | 'policy_group' | 'upgrade_profile', name: string, tagType?: 'publisher' | 'private_app' }
  • 응답 스키마 :
    { status: 'success' | 'error', data: { valid: boolean, message?: string } }
  • 사용 예 :
    1. "이름 검증: 제안된 리소스 이름이 요구 사항을 충족하는지 확인합니다."
    2. "태그 검증: 태그 이름을 생성하기 전에 검증합니다."
    3. 정책 이름 지정: 정책 이름이 규칙을 따라야 합니다.
• 리소스 검증
  • 설명 : 생성 또는 업데이트 작업 전에 전체 리소스 구성을 검증합니다.
  • 필수 매개변수 :
    { resourceType: 'publisher' | 'private_app' | 'policy' | 'policy_group' | 'upgrade_profile', data: { name: string, // Additional resource-specific fields } }
  • 응답 스키마 :
    { status: 'success' | 'error', data: { valid: boolean, errors?: string[] } }
  • 사용 예 :
    1. "구성 검증: 생성하기 전에 리소스 설정을 확인하세요."
    2. 업데이트 확인: 업데이트를 적용하기 전에 변경 사항을 검증합니다.
    3. "규정 준수 확인: 리소스가 필수 표준을 충족하는지 확인하세요."
• 검색자료
  • 설명 : 지정된 기준에 따라 게시자나 개인 애플리케이션을 검색합니다.
  • 필수 매개변수 :
    { resourceType: 'publishers' | 'private_apps', query: string }
  • 응답 스키마 : 리소스별 응답 형식
  • 사용 예 :
    1. "리소스 검색: 특정 기준에 맞는 리소스를 찾으세요."
    2. "출판사 검색: 이름이나 속성으로 출판사를 검색하세요."
    3. "애플리케이션 검색: 검색어와 일치하는 비공개 앱을 찾으세요."