안내 설정을 사용하여 구성 Azure API Management용 API 서비스 그래프 커넥터
데이터를 Azure API ManagementCMDB.
시작하기 전에
중요사항:
안내 설정 방법이 더 이상 사용되지 않으므로 문제가 없는 한 뷰를 사용합니다 SGC 센터 . 안내 설정을 사용하여 연결을 구성한 경우 연결이 뷰에 SGC 센터 나타나지 않을 수 있습니다.
의존성 및 요구사항:
- 자동으로 설치되는 Integration Commons for CMDB 스토어 앱입니다. CMDB용 통합 커먼즈를 참조하십시오.
- 자동으로 설치되는 CMDB CI Class Models 스토어 앱입니다. CMDB CI 클래스 모델 문서를 참조하십시오.
- ITOM 검색 라이센스 플러그인(com.snc.itom.discovery.license). 이 플러그인을 활성화해야 합니다.
- ITOM 라이선싱 플러그인(com.snc.itom.license). Request Discovery 문서를 참조하십시오.
관리자로부터 Azure OAuth 자격 증명을 얻습니다. 다음 세부 정보를 기록해 둡니다.
- 애플리케이션(클라이언트) ID
- 클라이언트 비밀
- 디렉터리(테넌트) ID
- 연결 URL
필요한 역할: 관리자
프로시저
-
애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 Azure API Management용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
자세한 내용은 애플리케이션 선택기를 참조하십시오.
- 다음으로 이동 모두 > 서비스 그래프 커넥터 > Azure API 관리 > 설정.
- Azure API Management용 API 서비스 그래프 커넥터 페이지에서 빠른 시작 옵션이 선택되어 있는지 확인한 다음 계속을 선택합니다.
-
애플리케이션에 요청을 Azure API Management 보내도록 인증 자격 증명을 구성합니다.
- 페이지의 연결 및 자격 증명 구성 섹션에서 Azure API Management용 API 서비스 그래프 커넥터시작을 선택합니다.
-
연결을 구성합니다.
- Azure 인증 자격 증명 구성 작업을 선택합니다.
- 여기를 클릭을 선택하여 별도의 브라우저 탭에서 연결 페이지를 엽니다.
- Azure API Management 연결에 대한 편집을 검색하여 선택합니다.
- 연결 편집 창의 연결 정보 섹션에서 필드를 채웁니다.
표 1. 연결 정보 필드 설명 Azure API Management 연결 이름 연결 기록을 식별하는 Azure API Management 이름입니다. Azure API Management 연결은기본 자격 증명 별칭 이름입니다. 여러 Azure API Management 인스턴스를 추가할 수 있습니다. 그러나 기본 연결 이름은 수정하지 마십시오.연결 URL 서비스에 연결하기 위한 기본 URL입니다 Azure API Management . 클라이언트 애플리케이션의 지역에 Azure 따라 다음 형식 중 하나로 URL을 입력합니다.- 전역
https://management.azure.com - 미국 정부
htttps://management.usgovcloudapi.net - 중국
https://management.chinacloudapi.cn - 독일
https://management.microsoftazure.de/
- 전역
- 연결 편집 창의 자격 증명 정보 섹션에서 필드를 채웁니다.
표 2. 자격 증명 정보 필드 설명 OAuth 클라이언트 ID 시작하기 전에 섹션에 나와 있는 Azure 클라이언트 애플리케이션의 애플리케이션(클라이언트) ID입니다. OAuth 클라이언트 비밀 시작하기 전에 섹션에 설명된 클라이언트 애플리케이션의 클라이언트 비밀 Azure 입니다. OAuth 토큰 URL 클라이언트 애플리케이션의 토큰 URL입니다 Azure . 클라이언트 애플리케이션의 지역에 Azure 따라 다음 형식 중 하나로 토큰 URL을 입력합니다.여기서 <tenantid>는 시작하기 전에 섹션에 설명된 대로 클라이언트 애플리케이션의 테넌트 ID Azure 입니다.- 전역
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
- 전역
- 편집 및 OAuth 토큰 가져오기를 선택합니다.
- 업데이트를 선택합니다.
- OAuth 토큰 흐름이 성공적으로 완료되면 안내 설정 페이지로 돌아가서 완료로 표시 확인란을 선택하여 Azure 인증 자격 증명 구성 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
를 통해 Azure API Management리소스를 관리 Azure 하도록 연결을 구성합니다.
- 속성 구성 작업을 선택합니다.
- 서비스 그래프 연결 속성 관련 목록에서 속성 값을 입력합니다.
표 3. 서비스 그래프 연결 속성 속성 설명 수집 기간(일) API 사용량 데이터 수집 기간(일)입니다. CollectUsageData 사용량 데이터 수집을 사용하여 지정된 기간 동안 API 사용량 데이터를 검색합니다. 디스커버리 범위 클라이언트 애플리케이션의 검색 범위입니다 Azure . 사용 가능한 옵션은 다음과 같습니다. - 관리 그룹
- 서비스 계정이 관리 그룹 내의 Azure 데이터에 액세스할 수 있는 경우 ServiceNow관리 그룹을 선택합니다.
- 구독
- 서비스 계정이 구독 내의 Azure 데이터에만 액세스할 수 있는 경우 ServiceNow구독을 선택합니다.
서비스 제외 연결에서 제외해야 하는 Azure API Management 서비스입니다. 여러 서비스의 경우 쉼표로 구분합니다. 속성에 나열된 ExcludeServices 게이트웨이를 제외한 모든 게이트웨이를 가져옵니다.
GetNestedGroupSubscriptions 관리 그룹이 검색 범위로 설정된 경우 중첩된 모든 하위 구독에서 데이터 검색을 활성화합니다. 중첩된 하위 구독을 제외하려면 속성을
False로 설정합니다.ManagementGroupId Azure API Management 서비스의 관리 그룹 ID입니다. 여러 관리 그룹의 경우 쉼표로 구분합니다.
파티션 크기 병렬 로드가 활성화된 경우 관리되는 API의 Azure 파티션 크기입니다. 0보다 큰 숫자 값을 사용할 수 있습니다. 비워 두면 값이 자동으로 계산됩니다.
ResourceGroups Azure API Management 서비스의 자원 그룹 이름입니다. 여러 자원 그룹의 경우 이름을 쉼표로 구분합니다. 이 필드를 비워 두면 커넥터 내의 데이터 소스가 사용 가능한 모든 자원 그룹에서 데이터를 임포트합니다.
SubscriptionId Azure API Management 서비스의 구독 ID입니다. 구독 ID가 여러 개인 경우 쉼표로 구분합니다. 검색 범위가 구독 으로 설정되고 이 필드를 비워 두면 자격 증명에서 지정된 테넌트에 대한 모든 구독이 검색됩니다.
팁:속성 값을 입력하려면 두 번 클릭(또는 바로 가기 키 사용)하여 속성의 값 셀에 값을 입력합니다. - 완료로 표시 확인란을 선택하여 속성 구성 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
연결을 테스트합니다.
- 연결 테스트 작업을 선택합니다.
- 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.
연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.
- 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.
테스트에 오류가 있는 경우, 수정 제안을 따르십시오.
- 완료로 표시 확인란을 선택하여 연결 테스트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
- 옵션:
여러 Azure API Management 인스턴스와 통합합니다.
- 페이지의 Add Multiple Instances(여러 인스턴스 추가) 섹션에서 Start(Azure API Management용 API 서비스 그래프 커넥터시작)를 선택합니다.
-
새 Azure API Management 연결에 대한 데이터 소스 작성을 활성화합니다.
- 데이터 소스 [sys_data_source] 테이블에 대한 편집 권한이 있는지 확인하십시오.
- 데이터 소스 접근 업데이트 작업을 선택합니다.
- 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
- 다른 탭에서 열리는 데이터 소스 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
- 업데이트를 선택합니다.
- 애플리케이션 선택기에서 Azure API Management용 API 서비스 그래프 커넥터 애플리케이션 범위를 선택합니다.
- 완료로 표시 확인란을 선택하여 데이터 원본 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
-
새 Azure API Management 연결에 대해 예약된 임포트 작업 작성을 활성화합니다.
- 예약된 데이터 임포트 [scheduled_import_set] 테이블에 대한 편집 권한이 있는지 확인합니다.
- 예약된 데이터 임포트 접근 업데이트 작업을 선택합니다.
- 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
- 예약된 데이터 임포트 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
- 업데이트를 선택합니다.
- 애플리케이션 선택기에서 Azure API Management용 API 서비스 그래프 커넥터 애플리케이션 범위를 선택합니다.
- 완료로 표시 확인란을 선택하여 예약된 데이터 임포트 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
-
데이터 소스 [sys_data_source] 및 예약된 데이터 임포트 [scheduled_import_set] 테이블에서 캐시를 지웁니다.
- 데이터 소스 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 선택합니다.
- 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
- 스크립트 실행 필드에 다음 코드를 입력합니다.
GlideTableManager.invalidateTable("sys_data_source"); GlideCacheManager.flushTable("sys_data_source"); GlideTableManager.invalidateTable("scheduled_import_set"); GlideCacheManager.flushTable("scheduled_import_set"); GlideTableManager.invalidateTable("sys_db_object"); GlideCacheManager.flushTable("sys_db_object"); - 스크립트 실행을 선택합니다.
- 애플리케이션 선택기에서 Azure API Management용 API 서비스 그래프 커넥터 애플리케이션 범위를 선택합니다.
- 완료로 표시를 선택하여 데이터 원본 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 완료하도록 설정합니다.
-
새 Azure API Management 인스턴스에 다른 연결을 추가합니다.
- 애플리케이션 선택기를 사용하여 애플리케이션 범위가 Azure API Management용 API 서비스 그래프 커넥터 애플리케이션으로 설정되어 있는지 확인합니다.
- 다른 연결 추가 작업을 선택한 다음 여기 클릭을 선택합니다.
- 다른 브라우저 탭에서 열리는 연결 페이지에서 연결 추가를 선택합니다.
- 연결 생성 창에서 연결, 자격 증명 및 구독 ID 세부 정보를 입력합니다.
- OAuth 토큰 생성 및 가져오기를 선택합니다.
- 연결 페이지를 닫고 안내 설정 페이지 탭으로 돌아갑니다.
- 완료로 표시 확인란을 선택하여 다른 연결 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
새 연결에 대한 속성을 추가합니다.
- 애플리케이션 선택기를 사용하여 애플리케이션 범위가 Azure API Management용 API 서비스 그래프 커넥터 애플리케이션으로 설정되어 있는지 확인합니다.
- 새 연결에 속성 추가 작업을 선택합니다.
- 이름 열에서 다음 단계에서 5.e작성한 연결 이름을 선택합니다.
- 서비스 그래프 연결 속성 관련 목록에서 속성 값을 입력합니다.
속성에 관한 자세한 내용은 4.c.ii을 참조하십시오.
팁:속성 값을 입력하려면 두 번 클릭(또는 바로 가기 키 사용)하여 속성의 값 셀에 값을 입력합니다. - 완료로 표시 확인란을 선택하여 새 연결에 속성 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
새 연결을 테스트합니다.
- 새 연결 테스트 작업을 선택합니다.
- 이름 열에서 다음 단계에서 5.e작성한 연결 이름을 선택합니다.
- 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.
연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.
- 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.
테스트에 오류가 있는 경우, 수정 제안을 따르십시오.
- 완료로 표시 확인란을 선택하여 새 연결 테스트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
데이터 임포트 Azure API Management 를 위해 예약된 작업을 구성합니다.
- 페이지의 Set up Scheduled Import Jobs(예약된 임포트 작업 설정) 섹션에서 Start(Azure API Management용 API 서비스 그래프 커넥터시작)를 선택합니다.
-
SGA Azure API Management 서비스 예약된 작업을 선택합니다.
다중 인스턴스 설정의 경우 에서 5.e연결을 사용하여 작성된 예약된 임포트를 선택합니다.
-
예약된 데이터 임포트 양식에서 필드 값을 확인합니다.
자세한 내용은 Schedule a data import 문서를 참조하십시오.
- 활성 확인란을 선택하여 예약된 작업을 활성화합니다.
- 실행 필드에서 주기적으로를 선택하여 작업이 실행되는 빈도를 지정합니다.
- 업데이트를 선택합니다.
- 완료로 표시 확인란을 선택하여 예약된 임포트 작업 설정 작업을 완료하도록 설정한 다음 계속을 선택합니다.
- Azure API Management용 API 서비스 그래프 커넥터 페이지에서 완료를 선택하여 변경 내용을 저장합니다.
- 설정 완료 대화 상자에서 완료 를 선택하여 설정을 완료합니다.
- 표시되는 메시지 상자에서 완료를 선택합니다.