안내 설정을 사용하여 구성 AWS API Gateway용 API 서비스 그래프 커넥터
데이터를 AWS API GatewayCMDB.
시작하기 전에
중요사항:
안내 설정 방법이 더 이상 사용되지 않으므로 문제가 없는 한 뷰를 사용합니다 SGC 센터 . 안내 설정을 사용하여 연결을 구성한 경우 연결이 뷰에 SGC 센터 나타나지 않을 수 있습니다.
커넥터에서 사용하는 인증 메커니즘은 STS(보안 토큰 서비스) 토큰을 사용하는 AWS AWS 서명 유형(HMAC 인증 기술)입니다. 권한에 대한 자세한 내용은 기술 자료의 AWS API Gateway용 API 서비스 그래프 커넥터 - 설정 지침[KB1962734] 문서를 Now Support 참조하십시오.
의존성 및 요구사항:
- 자동으로 설치되는 Integration Commons for CMDB 스토어 앱입니다. CMDB용 통합 커먼즈를 참조하십시오.
- 자동으로 설치되는 CMDB CI Class Models 스토어 앱입니다. CMDB CI 클래스 모델 문서를 참조하십시오.
- ITOM 검색 라이센스 플러그인(com.snc.itom.discovery.license). 이 플러그인을 활성화해야 합니다.
- ITOM 라이선싱 플러그인(com.snc.itom.license). Request Discovery 문서를 참조하십시오.
필요한 역할: 관리자
프로시저
-
애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 AWS API Gateway용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
자세한 내용은 애플리케이션 선택기를 참조하십시오.
- 다음으로 이동 모두 > 서비스 그래프 커넥터 > AWS API 게이트웨이 > 설정.
- 안내 설정 페이지에서 계속을 선택합니다.
-
에 요청을 AWS API Gateway보내도록 인증 자격 증명을 구성합니다.
- 페이지의 연결 및 자격 증명 구성 섹션에서 AWS API Gateway용 API 서비스 그래프 커넥터시작을 선택합니다.
-
연결을 구성합니다.
- AWS 인증 자격 증명 구성 작업을 선택합니다.
- Name( 이름 ) 필드에 인증 이름을 입력합니다.
SGAwsApiCredentials는 기본 자격 증명 별칭 이름입니다. 여러 AWS API Gateway 인스턴스를 추가할 수 있습니다. 그러나 기본 연결 별칭은 수정하지 마십시오. - 접근 키 ID 및 비밀 접근 키 필드에 접근 키 ID와 비밀 접근 키를 각각 입력합니다.
AWS 액세스 키는 IAM 사용자에 대한 장기 자격 증명이며 액세스 키 ID와 비밀 액세스 키라는 두 부분으로 구성됩니다. 요청을 인증하려면 액세스 키 ID와 보안 액세스 키를 함께 사용해야 합니다.
- 업데이트를 선택합니다.
- 완료로 표시 확인란을 선택하여 AWS 인증 자격 증명 구성 작업을 완료하도록 설정한 다음 계속을 선택합니다.
-
인스턴스에 필요한 AWS API Gateway 구성 속성을 업데이트하고 연결을 테스트합니다.
- AWS 계정 세부 정보 구성 및 테스트 작업을 선택합니다.
- 서비스 그래프 연결 섹션의 서비스 그래프 연결 속성 관련 목록의 속성 열에서 속성을 선택하여 속성 상세 정보를 검토하고 수정합니다.다음 속성을 구성할 수 있습니다.
- AccountId
- 계정 ID의 숫자 식별자입니다 AWS .
- 수집 기간(일)
- API 사용량 데이터 수집 기간(일)입니다.
- CollectUsageData
- 사용량 데이터 수집을 사용하여 지정된 기간 동안 API 사용량 데이터를 검색합니다.
- IsGov클라우드
- 연결 설정이 AWS GovCloud용임을 나타내려면 활성화합니다.
- ConfigAggregatorAccountId
- AWS Config 서비스의 집계기 자원 유형이 구성된 AWS 계정 ID입니다.
- 지역
- 가 AWS API Gateway 상주하는 쉼표로 구분된 영역의 목록입니다.
- 파티션 크기
- 병렬 로드가 활성화된 경우 AWS 관리형 API의 파티션 크기입니다.
0보다 큰 숫자 값을 사용할 수 있습니다. 비워 두면 값이 자동으로 계산됩니다.
- StandaloneAccountId
- 계정과 연결된 구성원 계정의 ID입니다 AWS API Gateway .
- ConfigAggregatorName
- AWS Config 서비스의 집계기 자원 유형의 이름입니다.
- ManagementAccountId
- 계정과 연결된 관리 계정 ID입니다 AWS API Gateway .
- ConfigAggregatorRegion
- 집계기 자원 유형이 있는 지역입니다.
- StsRoleName
- API 자격 증명을 얻기 위해 STS 역할 가정 API를 쿼리하는 데 사용되는 AWS 계정의 STS 가정 역할 이름입니다.
- 서비스 그래프 연결 속성 섹션에서 업데이트를 선택합니다.
- 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.
연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.
- 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.
테스트에 오류가 있는 경우, 수정 제안을 따르십시오.
- 완료로 표시 확인란을 선택하여 AWS 계정 세부 정보 구성 및 테스트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
- 옵션:
여러 AWS API Gateway 인스턴스와 통합합니다.
- 페이지의 Add Multiple Instances(여러 인스턴스 추가) 섹션에서 Start(AWS API Gateway용 API 서비스 그래프 커넥터시작)를 선택합니다.
-
새 AWS API Gateway 연결에 대한 데이터 소스 작성을 활성화합니다.
- 데이터 소스 [sys_data_source] 테이블에 대한 편집 권한이 있는지 확인합니다.
- 데이터 소스 접근 업데이트 작업을 선택합니다.
- 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
- 새 탭에서 열리는 데이터 소스 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
- 업데이트를 선택합니다.
- 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 API 서비스 그래프 커넥터 .
- 완료로 표시 확인란을 선택하여 데이터 원본 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
-
새 AWS API Gateway 연결에 대해 예약된 임포트 작업 작성을 활성화합니다.
- 예약된 데이터 임포트 [scheduled_import_set] 테이블에 대한 편집 권한이 있는지 확인합니다.
- 데이터 예약된 임포트 접근 업데이트 작업을 선택합니다.
- 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
- 예약된 데이터 임포트 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
- 업데이트를 선택합니다.
- 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 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"); - 스크립트 실행을 선택합니다.
- 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 API 서비스 그래프 커넥터 .
- 완료로 표시를 선택하여 데이터 원본 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 완료하도록 설정합니다.
-
새 AWS API Gateway 인스턴스에 다른 연결을 추가합니다.
- 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 AWS API Gateway용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
- 다른 연결 추가 작업을 선택한 다음 여기를 클릭을 선택합니다.
- 다른 브라우저 탭에서 열리는 연결 페이지에서 연결 추가를 선택합니다.
- 연결 생성 창에서 연결 이름, 접근 키 및 비밀 키 상세 정보를 입력합니다.
- 연결 생성을 선택합니다.
- 를 워크플로우 스튜디오 닫고 안내 설정 탭으로 돌아갑니다.
- 완료로 표시 확인란을 선택하여 다른 연결 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
새 AWS API Gateway 연결에 필요한 구성 속성을 업데이트하고 연결을 테스트합니다.
- 새 연결 테스트 작업을 선택합니다.
- 단계에서 5.e생성한 연결 기록을 선택합니다.
- 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.
연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.
- 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.
테스트에 오류가 있는 경우, 수정 제안을 따르십시오.
- 완료로 표시 확인란을 선택하여 새 연결 테스트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
-
데이터 임포트 AWS API Gateway 를 위해 예약된 작업을 구성합니다.
- 페이지의 Set up Scheduled Import Jobs(예약된 임포트 작업 설정) 섹션에서 Start(AWS API Gateway용 API 서비스 그래프 커넥터시작)를 선택합니다.
-
SGA-AWS-API-Gateway-Managed-API-REST 예약된 작업을 선택합니다.
여러 인스턴스의 경우 SGA-AWS-API-Gateway-Managed-API-REST 데이터 소스에 대해 예약된 작업을 선택합니다.
-
예약된 데이터 임포트 양식에서 예약된 작업의 필드 값을 확인합니다.
자세한 내용은 Schedule a data import 문서를 참조하십시오.
- SGA-AWS-API-Gateway-Managed-API-REST 데이터 소스에 대해 예약된 작업을 활성화하려면 활성 확인란을 선택합니다.
- 업데이트를 선택합니다.
- 완료로 표시 확인란을 선택하여 예약된 임포트 작업 설정 작업을 완료하도록 설정한 다음 계속을 선택합니다.
- AWS API Gateway용 API 서비스 그래프 커넥터 페이지에서 완료를 선택하여 변경 내용을 저장합니다.
- 설정 완료 대화 상자에서 완료 를 선택하여 설정을 완료합니다.
- 표시되는 메시지 상자에서 완료를 선택합니다.