일치하지 않는 API 확장 클래스

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기5분

    • CMDB CI Class Models 스토어 앱은 일치하지 않는 API(애플리케이션 프로그래밍 인터페이스)에 대한 클래스를 추가하거나 업데이트합니다.

    앱은 클래스 설명, 식별 규칙, 식별자 항목 및 종속 관계(해당되는 경우)를 포함하여 CMDB 클래스 계층 구조를 확장하는 클래스 모델을 추가합니다. 추가된 클래스를 다른 CMDB 클래스처럼 사용할 수 있습니다. 와 같은 검색 및 서비스 매핑 패턴 애플리케이션은 이러한 클래스 확장을 사용하여 CI를 채우고 다양한 기술 및 소프트웨어를 검색할 수 있습니다.

    스토어에서 앱 요청

    ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.

    일치하지 않는 API

    API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component] 클래스를 채울 만큼 구조화되지 않은 API 엔드포인트는 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 클래스를 대신 채웁니다. 일치하지 않는 API는 일반적으로 보안 스캐너 또는 관찰 가능성 도구와 같은 통합에서 사용됩니다.

    클래스

    이 섹션에는 CMDB CI Class Models 스토어 앱이 추가하거나 업데이트하는 클래스가 나열됩니다.

    CMDB CI Class Models: 릴리스 1.49.0은 일치하지 않는 API 엔드포인트에 대해 다음 클래스를 추가합니다. 이 스토어 앱이 확장할 수 있는 클래스를 포함하여 기본 시스템의 CMDB 클래스 목록은 을 참조하십시오 CMDB 테이블 설명.

    클래스 확장 설명
    일치하지 않는 API 엔드포인트

    [cmdb_ci_unmatched_api_endpoint]

    		 구성 항목

    [cmdb_ci]

    		 cmdb_ci_api 또는 cmdb_ci_api_component 채울 수 없는 구조화되지 않은 엔드포인트가 있는 API.

    클래스 속성

    CMDB CI Class Models: 릴리스 1.49.0은 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 클래스에 다음 속성을 추가합니다.

    표 1. 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint]
    속성 데이터 유형 설명
    방법 문자열 API의 백엔드 프로토콜 유형입니다. 예시:
    • Lambda
    • HTTP
    • 논리 앱
    프로토콜 문자열 통신 프로토콜입니다. 예: HTTP, HTTPS.
    URL 문자열 (1024) 호출되는 자원의 URL입니다.
    ID 문자열 (1024) 소스 시스템의 고유 식별자입니다.
    인터넷 연결 부울 공용 인터넷에서 구성요소에 연결할 수 있는지 여부를 나타내는 부울입니다. 구성요소에 연결할 수 있는 경우 1 또는 "true"를 지정합니다.
    권한 부여 문자열 권한 부여 또는 인증 방법의 유형입니다. 예시:
    • 기본
    • 키
    • Oauth
    • 없음
    요청 데이터 유형 문자열 (255) 요청의 데이터 형식 목록입니다. 예시:
    • 참조
    • 이메일
    • 주소
    응답 데이터 유형 문자열 (255) 응답의 데이터 유형 목록입니다. 예시:
    • 참조
    • 이메일
    • 주소

    주요 관계 구조

    일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] CMDB 클래스 및 API 엔드포인트 검색됨 [api_endpoint_discovered] 비 CMDB 테이블은 구조화되지 않은 API 데이터가 수집되어 통합 허브-ETL의 기능 이상으로 처리해야 하는 시나리오를 위한 것입니다.

    검색된 API 엔드포인트 [api_endpoint_discovered]는 API [cmdb_ci_api] 및 API 구성요소 [cmdb_ci_api_component] 클래스의 원시 데이터에 대한 스테이징 테이블 역할을 할 수 있습니다. 잘 구조화된 데이터 소스에서 제공되지 않거나 표준 식별 규칙을 적용할 수 없는 API 데이터는 먼저 검색된 API 엔드포인트 [api_endpoint_discovered] 테이블을 채울 수 있습니다. 그런 다음 고객 정의 통합을 사용하여 API [cmdb_ci_api] 및 API 구성 요소 [cmdb_ci_api_component]에 대한 품질 및 조건 요구 사항과 일치하는 올바른 형식의 데이터가 가장 적합한 테이블을 채우도록 할 수 있습니다.

    데이터를 올바르게 구문 분석할 수 없거나 예기치 않은 방식으로 구조화된 경우 대신 고객 정의 통합을 사용하여 일치하지 않는 API 엔드포인트 [cmdb_ci_unmatched_api_endpoint] 테이블을 채울 수 있습니다.

    검색된 API 엔드포인트 [api_endpoint_discovered] 테이블을 채우는 데이터는 30일마다 삭제됩니다.

    표 2. 검색된 API 엔드포인트 [api_endpoint_discovered]
    속성 데이터 유형 설명
    이름 문자열 (100) API 엔드포인트의 이름입니다.
    방법 문자열 REST API 메서드. 예시:
    • GET
    • POST
    • 삭제
    URL 문자열 (1024) 호출되는 자원의 URL입니다.
    유형 선택 목록 API 유형입니다. 다음을 지정할 수 있습니다.
    • REST
    • SOAP
    • HTTP
    • gRPC (영문)
    • GraphQL
    • Websocket
    권한 부여 문자열 권한 부여 또는 인증 방법의 유형입니다. 예시:
    • 기본
    • 키
    • OAuth
    • 없음
    인터넷 연결 부울 공용 인터넷에서 구성요소에 연결할 수 있는지 여부를 나타내는 부울입니다. 구성요소에 연결할 수 있는 경우 1 또는 "true"를 지정합니다.
    요청 데이터 유형 문자열 (255) 요청의 데이터 형식 목록입니다. 예시:
    • 참조
    • 이메일
    • 주소
    응답 데이터 유형 문자열 (255) 응답의 데이터 유형 목록입니다. 예시:
    • 참조
    • 이메일
    • 주소
    머리글 문자열 (255) 쉼표로 구분된 헤더 이름 목록입니다.
    구성 항목 참조 일치하는 CMDB CI(API 구성요소 또는 일치하지 않는 API 엔드포인트)에 대한 참조입니다.

    관련 비 CMDB 테이블

    일치하지 않는 API 확장 클래스는 API 배포 [api_deployment] 비 CMDB 테이블을 관련 목록으로 사용합니다.

    표 3. API 배포 [api_deployment]
    속성 데이터 유형 설명
    이름 문자열 (100) API 배포의 이름입니다.
    API 참조 배포된 API(cmdb_ci_api)에 대한 참조입니다.
    일치하지 않는 API 엔드포인트 참조 API가 기존 API(cmdb_ci_unmatched_api_endpoint)와 일치하지 않는 경우 일치하지 않는 API 엔드포인트에 대한 참조입니다.
    구성 항목 참조 구성 항목에 대한 참조입니다. API가 배포되는 CI를 알고 있는 경우 일반적으로 참조로 수동으로 지정됩니다.