사용 구성 Azure API Management용 API 서비스 그래프 커넥터SGC 센터

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 데이터를 Azure API ManagementCMDB.

    시작하기 전에

    ServiceNow Store 설치 단계는 ServiceNow Store 애플리케이션 설치를 참조하십시오. 에서 ServiceNow Store버전 1.0.0 이상을 설치합니다Azure API Management용 API 서비스 그래프 커넥터.
    관리자로부터 Azure OAuth 자격 증명을 얻으십시오. 다음 세부 정보를 기록합니다.
    • 애플리케이션(클라이언트) ID
    • 클라이언트 비밀
    • 디렉터리(테넌트) ID
    • 연결 URL
    필요한 역할: 다음 표는 플레이북의 각 스테이지에 필요한 역할을 보여줍니다.
    표 1. 각 플레이북 스테이지에 필요한 역할
    스테이지 역할
    필수 구성요소 관리자
    설정 SGC-관리자(sn_cmdb_int_util.sgc_admin) 또는 관리자
    주:
    백그라운드 스크립트를 실행하고 SGC-Admin 사용자에게 전역 테이블에 대한 접근 권한을 제공하려면 관리자 사용자 역할이 필요합니다. 의 사용자 역할 서비스 그래프 커넥터에 대한 자세한 내용은 다음 문서를 참조하십시오 서비스 그래프 커넥터 사용자 역할.

    이 태스크 정보

    온보딩 커넥터에 대한 플레이북 경험은 에서 CMDB 작업 공간활성화됩니다SGC 센터. 애플리케이션을 구성하려면 SGC 센터 플레이북과 상호작용하는 방법에 대한 자세한 내용은 플레이북과 상호작용 섹션을 참조하십시오SGC 센터 구성.

    주:
    또는 의 설치된 연결 또는 초안 연결 SGC 센터에서 이미 사용할 수 있는 기본 연결을 구성할 수 있습니다. 이동 모두 > 서비스 그래프 커넥터을 클릭한 다음 메뉴에서 커넥터 설정을 선택합니다. 설치된 연결과 초안 연결에 대한 자세한 내용은 문서를 참조하십시오 에 추가된 서비스 그래프 커넥터 연결 관리 SGC 센터.

    프로시저

    1. 다음으로 이동 작업 공간 > CMDB 작업 공간.
    2. 에서 CMDB 작업 공간을 선택합니다 SGC 센터.
    3. 개요 페이지에서 연결 생성을 선택합니다.
      팁:
      또는 모든 연결 페이지에서 연결 만들기를 선택할 수 있습니다.
    4. 연결 생성 창에서 커넥터 유형을 선택한 Azure API Management 다음 연결 생성을 선택합니다.
    5. 커넥터를 사용하여 처음으로 연결을 설정할 때 초기 필요 조건을 완료합니다.
      주:
      이 단계는 처음 설정하는 동안에만 필요합니다. SGC 센터에서 연결을 만들 때 초기 설정 작업 수행 문서를 참조하십시오.
    6. 연결 상세 정보를 입력하고 데이터 임포트 Azure API Management 를 위한 API 연결을 테스트합니다.
      1. 플레이북의 설정 단계에서 연결 생성 및 테스트 활동을 선택합니다.
      2. 양식에서 필드를 채웁니다.
        표 2. 연결 양식 생성 및 테스트
        필드 설명
        Azure API 관리 연결 이름 연결 기록을 식별하는 Azure API Management 이름입니다.

        예: Azure API Management 연결.
        연결 URL 서비스에 연결하기 위한 기본 URL입니다.Azure API Management
        주:
        이 필드는 애플리케이션에 연결하기 위한 URL로 자동 설정됩니다. 필드 값은 그대로 둡니다.
        OAuth 클라이언트 ID 시작하기 전에 섹션에 나와 있는 클라이언트 애플리케이션의 애플리케이션(클라이언트) ID Azure 입니다.
        OAuth 클라이언트 비밀 시작하기 전에 섹션에 설명된 클라이언트 애플리케이션의 Azure 클라이언트 비밀입니다.
        OAuth 토큰 URL 클라이언트 애플리케이션의 토큰 URL입니다 Azure .
        클라이언트 애플리케이션의 Azure 지역에 따라 다음 형식 중 하나로 토큰 URL을 입력합니다.
        • 전역 
          https://login.microsoftonline.com/<tenantid>/oauth2/v2.0/token
        • 미국 정부
          https://login.microsoftonline.us/<tenantid>/oauth2/v2.0/token
        • 중국
          https://login.partner.microsoftonline.cn/<tenantid>/oauth2/v2.0/token
        • 독일
          https://login.microsoftonline.de/<tenantid>/oauth2/v2.0/token
        여기서 <tenantid>는 시작하기 전에 섹션에 설명된 대로 클라이언트 애플리케이션의 Azure 테넌트 ID입니다.
      3. 연결 만들기 및 테스트를 선택합니다.
      4. 연결 테스트가 완료되면 계속을 선택합니다.
    7. 옵션: 연결에 대한 구성 속성을 설정합니다.
      주:
      이 단계를 건너뛰려면 구성 속성 설정 작업에 대해 계속을 선택합니다.
      1. 플레이북의 설정 단계에서 구성 속성 설정 활동을 선택합니다.
      2. 속성 상세 정보를 입력합니다.
        표 3. Azure API 관리 구성 속성
        속성 설명
        Azure API 관리 연결
        디스커버리 범위 클라이언트 애플리케이션의 검색 범위입니다 Azure . 사용 가능한 옵션은 다음과 같습니다.
        관리 그룹
        서비스 계정이 ServiceNow 관리 그룹 내의 데이터에 액세스할 수 있는 경우 관리 그룹을 선택합니다.Azure
        구독
        서비스 계정이 ServiceNow 구독 내의 데이터에만 액세스할 수 있는 경우 구독을 선택합니다.Azure
        구독
        구독 ID Azure API Management 서비스의 구독 ID입니다.

        구독 ID가 여러 개인 경우 쉼표로 구분합니다. 검색 범위가 구독으로 설정되고 이 필드를 비워 두면 자격 증명에 지정된 테넌트에 대한 모든 구독이 검색됩니다.
        관리 그룹
        관리 그룹 ID Azure API Management 서비스의 관리 그룹 ID입니다.

        여러 관리 그룹의 경우 쉼표로 구분합니다.
        중첩된 그룹 구독 가져오기 관리 그룹이 검색 범위로 설정된 경우 중첩된 모든 하위 구독에서 데이터 검색을 활성화하는 옵션입니다.

        중첩된 하위 구독을 제외하려면 속성을 비활성화합니다.
        선택적 독점 구성
        ExcludeServices 연결에서 제외해야 하는 Azure API Management 서비스입니다.

        여러 서비스의 경우 쉼표로 구분하십시오. 속성에 나열된 ExcludeServices 게이트웨이를 제외한 모든 게이트웨이를 가져옵니다.
        자원그룹 Azure API Management 서비스의 자원 그룹 이름입니다.

        여러 자원 그룹의 경우 이름을 쉼표로 구분합니다. 이 필드를 비워 두면 커넥터 내의 데이터 소스가 사용 가능한 모든 자원 그룹에서 데이터를 임포트합니다.
        사용량 데이터 구성
        사용량 데이터 수집 사용량 데이터 수집을 활성화하여 지정된 기간 동안 API 사용량 데이터를 검색하는 옵션입니다.
      3. 계속을 선택합니다.
    8. 데이터를 정기적으로 임포트하도록 임포트 일정을 구성합니다.
      1. 플레이북의 설정 단계에서 임포트 일정 구성 활동을 선택합니다.
      2. 임포트 일정 목록 내에서 예약된 상위 데이터 임포트를 확장하여 연결과 연결된 API Management 서비스 임포트 일정을 선택합니다.
        주:
        연결 이름은 일정 이름 앞에 붙습니다.
      3. 임포트 일정 구성 대화 상자에서 활성 확인란을 선택한 다음, 실행 일정 및 시간 상세 정보를 입력합니다.

        자세한 내용은 Schedule a data import 문서를 참조하십시오.

      4. 저장을 선택합니다.
        또는 지금 실행을 선택하여 임포트 일정을 즉시 실행합니다.
      5. 계속을 선택합니다.
    9. 플레이북의 설정 단계에서 연결 생성 확인 활동을 선택하여 연결이 생성되었는지 확인합니다.

    다음에 수행할 작업

    모든 연결 보기를 선택하여 연결 세부 정보를 검토합니다. 생성된 연결이 설치된 연결 목록에 나타납니다.

    그런 다음 SGC 센터CMDB 작업 공간. 자세한 내용은 에 추가된 서비스 그래프 커넥터 연결 관리 SGC 센터 문서를 참조하십시오.