안내 설정을 사용하여 구성 AWS API Gateway용 API 서비스 그래프 커넥터

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기8분
  • 데이터를 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 문서를 참조하십시오.

    필요한 역할: 관리자

    프로시저

    1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 AWS API Gateway용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
      자세한 내용은 애플리케이션 선택기를 참조하십시오.
    2. 다음으로 이동 모두 > 서비스 그래프 커넥터 > AWS API 게이트웨이 > 설정.
    3. 안내 설정 페이지에서 계속을 선택합니다.
    4. 에 요청을 AWS API Gateway보내도록 인증 자격 증명을 구성합니다.
      1. 페이지의 연결 및 자격 증명 구성 섹션에서 AWS API Gateway용 API 서비스 그래프 커넥터시작을 선택합니다.
      2. 연결을 구성합니다.
        1. AWS 인증 자격 증명 구성 작업을 선택합니다.
        2. Name( 이름 ) 필드에 인증 이름을 입력합니다.

          SGAwsApiCredentials 는 기본 자격 증명 별칭 이름입니다. 여러 AWS API Gateway 인스턴스를 추가할 수 있습니다. 그러나 기본 연결 별칭은 수정하지 마십시오.

        3. 접근 키 ID 및 비밀 접근 키 필드에 접근 키 ID와 비밀 접근 키를 각각 입력합니다.

          AWS 액세스 키는 IAM 사용자에 대한 장기 자격 증명이며 액세스 키 ID와 비밀 액세스 키라는 두 부분으로 구성됩니다. 요청을 인증하려면 액세스 키 ID와 보안 액세스 키를 함께 사용해야 합니다.

        4. 업데이트를 선택합니다.
        5. 완료로 표시 확인란을 선택하여 AWS 인증 자격 증명 구성 작업을 완료하도록 설정한 다음 계속을 선택합니다.
      3. 인스턴스에 필요한 AWS API Gateway 구성 속성을 업데이트하고 연결을 테스트합니다.
        1. AWS 계정 세부 정보 구성 및 테스트 작업을 선택합니다.
        2. 서비스 그래프 연결 섹션의 서비스 그래프 연결 속성 관련 목록의 속성 열에서 속성을 선택하여 속성 상세 정보를 검토하고 수정합니다.
          다음 속성을 구성할 수 있습니다.
          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 가정 역할 이름입니다.
        3. 서비스 그래프 연결 속성 섹션에서 업데이트를 선택합니다.
        4. 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.

          연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.

        5. 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.

          테스트에 오류가 있는 경우, 수정 제안을 따르십시오.

        6. 완료로 표시 확인란을 선택하여 AWS 계정 세부 정보 구성 및 테스트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
    5. 옵션: 여러 AWS API Gateway 인스턴스와 통합합니다.
      1. 페이지의 Add Multiple Instances(여러 인스턴스 추가) 섹션에서 Start(AWS API Gateway용 API 서비스 그래프 커넥터시작)를 선택합니다.
      2. AWS API Gateway 연결에 대한 데이터 소스 작성을 활성화합니다.
        1. 데이터 소스 [sys_data_source] 테이블에 대한 편집 권한이 있는지 확인합니다.
        2. 데이터 소스 접근 업데이트 작업을 선택합니다.
        3. 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        4. 새 탭에서 열리는 데이터 소스 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
        5. 업데이트를 선택합니다.
        6. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 API 서비스 그래프 커넥터 .
        7. 완료로 표시 확인란을 선택하여 데이터 원본 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
      3. AWS API Gateway 연결에 대해 예약된 임포트 작업 작성을 활성화합니다.
        1. 예약된 데이터 임포트 [scheduled_import_set] 테이블에 대한 편집 권한이 있는지 확인합니다.
        2. 데이터 예약된 임포트 접근 업데이트 작업을 선택합니다.
        3. 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        4. 예약된 데이터 임포트 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
        5. 업데이트를 선택합니다.
        6. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 API 서비스 그래프 커넥터 .
        7. 완료로 표시 확인란을 선택하여 데이터 예약된 임포트 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
      4. 데이터 소스 [sys_data_source] 및 예약된 데이터 임포트 [scheduled_import_set] 테이블에서 캐시를 지웁니다.
        1. 데이터 소스 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 선택합니다.
        2. 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        3. 스크립트 실행 필드에 다음 코드를 입력합니다.
          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");
        4. 스크립트 실행을 선택합니다.
        5. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 AWS API Gateway용 API 서비스 그래프 커넥터 .
        6. 완료로 표시를 선택하여 데이터 원본 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 완료하도록 설정합니다.
      5. AWS API Gateway 인스턴스에 다른 연결을 추가합니다.
        1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 AWS API Gateway용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
        2. 다른 연결 추가 작업을 선택한 다음 여기를 클릭을 선택합니다.
        3. 다른 브라우저 탭에서 열리는 연결 페이지에서 연결 추가를 선택합니다.
        4. 연결 생성 창에서 연결 이름, 접근 키 및 비밀 키 상세 정보를 입력합니다.
        5. 연결 생성을 선택합니다.
        6. 워크플로우 스튜디오 닫고 안내 설정 탭으로 돌아갑니다.
        7. 완료로 표시 확인란을 선택하여 다른 연결 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      6. AWS API Gateway 연결에 필요한 구성 속성을 업데이트하고 연결을 테스트합니다.
        1. 새 연결 테스트 작업을 선택합니다.
        2. 단계에서 5.e생성한 연결 기록을 선택합니다.
        3. 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.

          연결을 테스트하는 데 몇 분 정도 걸릴 수 있습니다. 페이지가 새로 고쳐지고 테스트 결과가 표시됩니다.

        4. 상태 필드가 성공으로 설정되면 업데이트를 선택합니다.

          테스트에 오류가 있는 경우, 수정 제안을 따르십시오.

        5. 완료로 표시 확인란을 선택하여 새 연결 테스트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
    6. 데이터 임포트 AWS API Gateway 를 위해 예약된 작업을 구성합니다.
      1. 페이지의 Set up Scheduled Import Jobs(예약된 임포트 작업 설정) 섹션에서 Start(AWS API Gateway용 API 서비스 그래프 커넥터시작)를 선택합니다.
      2. SGA-AWS-API-Gateway-Managed-API-REST 예약된 작업을 선택합니다.
        여러 인스턴스의 경우 SGA-AWS-API-Gateway-Managed-API-REST 데이터 소스에 대해 예약된 작업을 선택합니다.
      3. 예약된 데이터 임포트 양식에서 예약된 작업의 필드 값을 확인합니다.

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

      4. SGA-AWS-API-Gateway-Managed-API-REST 데이터 소스에 대해 예약된 작업을 활성화하려면 활성 확인란을 선택합니다.
      5. 업데이트를 선택합니다.
      6. 완료로 표시 확인란을 선택하여 예약된 임포트 작업 설정 작업을 완료하도록 설정한 다음 계속을 선택합니다.
    7. AWS API Gateway용 API 서비스 그래프 커넥터 페이지에서 완료를 선택하여 변경 내용을 저장합니다.
    8. 설정 완료 대화 상자에서 완료 를 선택하여 설정을 완료합니다.
    9. 표시되는 메시지 상자에서 완료를 선택합니다.