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

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기11분
  • 데이터를 Apigee XCMDB.

    시작하기 전에

    중요사항:
    안내 설정 방법이 더 이상 사용되지 않으므로 문제가 없는 한 뷰를 사용합니다 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 문서를 참조하십시오.

    필요한 역할: 관리자

    프로시저

    1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 Apigee X용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
      자세한 내용은 애플리케이션 선택기를 참조하십시오.
    2. 다음으로 이동 모두 > 서비스 그래프 커넥터 > Apigee X > 설정.
    3. Apigee X용 API 서비스 그래프 커넥터 페이지에서 계속을 선택합니다.
    4. 애플리케이션에 요청을 Apigee X 보내도록 인증 자격 증명을 구성합니다.
      1. 페이지의 연결 및 자격 증명 구성 섹션에서 Apigee X용 API 서비스 그래프 커넥터시작을 선택합니다.
      2. SGA Apigee X 프론트엔드 백엔드 데이터 소스가 파일을 Apigee X 검색하고 기록에 첨부할 수 있도록 첨부 파일 업데이트 권한을 부여합니다.
        1. 첨부 파일 접근 업데이트 작업을 선택합니다.
        2. 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        3. 첨부 파일 하위 페이지의 애플리케이션 액세스 관련 목록에서 업데이트 가능 확인란을 선택한 다음 업데이트를 선택합니다.
        4. Apigee X용 API 서비스 그래프 커넥터 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다.
        5. 완료로 표시 확인란을 선택하여 첨부 파일 액세스 업데이트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      3. Apigee X 환경을 설정하고 JKS(Java KeyStore) 인증서를 생성하여 애플리케이션에서 가져온 Apigee X 보안 인증서를 암호화합니다.
        1. Apigee X 설정 지침 작업을 선택합니다.
        2. 지식베이스에서 Apigee X용 API 서비스 그래프 커넥터 - 설정 지침[KBB0010364] 문서의 Now Support 설정 지침을 검토하고 완료합니다.

          대상 키 저장소 암호를 기록해 둡니다. JKS 인증서를 애플리케이션으로 임포트하는 동안 이 암호를 지정해야 합니다 Apigee X용 API 서비스 그래프 커넥터 .

        3. 완료로 표시 확인란을 선택하여 Apigee X 설정 지침 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      4. X.509 인증서를 생성하여 애플리케이션에 대한 Apigee X JKS(Java KeyStore) 인증서를 커넥터와 연결합니다.
        1. X.509 인증서 작성 작업을 선택합니다.
        2. 새로 만들기를 선택합니다.
        3. 양식의 필드에 내용을 입력합니다.
          표 1. X.509 인증서 양식
          필드 설명
          이름 X.509 인증서의 이름입니다. 예: SGA-ApigeeX-509Certificate.
          만료 시 알림 인증서가 만료될 때 알림을 받을 사용자입니다. 선택한 사용자가 없으면 기본적으로 로그인한 사용자가 관리자 역할을 가진 마지막 로그인한 사용자 두 명과 함께 추가됩니다.
          만료되기 전 경고 인증서가 만료되기 전에 알림을 보낼 일 수입니다.
          활성 인증서를 활성화하는 옵션입니다.
          유형 Java 키 스토어로 자동 설정되는 인증서 컨테이너입니다. 필드 값을 Java 키 스토어로 설정된 대로 둡니다.
          며칠 후 만료 인증서가 만료될 때까지의 일 수입니다.
          키 스토어 암호 이전 단계에서 적어둔 JKS 인증서에 액세스하기 위한 암호입니다.
          간단한 설명 X.509 인증서에 대한 설명입니다.
        4. 첨부 파일 관리 아이콘(첨부 파일 관리 아이콘.)을 선택합니다.
        5. 파일 선택을 선택하여 단계에서 4.c만든 JKS 인증서에 대한 keystore.p12 파일을 찾아 업로드합니다 .
        6. 대화 상자를 닫습니다.
        7. 저장소/인증서 확인 관련 링크를 선택합니다.
        8. 확인에 성공하면 업데이트를 선택하여 안내 설정 페이지로 돌아갑니다.
        9. 완료로 표시 확인란을 선택하여 X.509 인증서 만들기 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      5. 연결을 구성합니다.
        1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 Apigee X용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
        2. 연결 구성 작업을 선택합니다.
        3. 여기를 클릭을 선택하여 별도의 브라우저 탭에서 연결 페이지를 엽니다.
        4. SGA Apigee X Connection에 대해 편집을 검색하고 선택합니다.
        5. 연결 편집 창의 연결 정보 섹션에서 필드를 채웁니다.
          표 2. 연결 정보
          필드 설명
          연결 이름 연결 기록을 식별하는 Apigee X 이름입니다.

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

        6. 연결 편집 창의 자격 증명 정보 섹션에서 필드를 채웁니다.
          표 3. 자격 증명 정보
          필드 설명
          서비스 계정 이메일 시작하기 전에 섹션에 설명된 대로 인증 Apigee X 에 사용되는 서비스 계정과 연결된 ServiceNow 이메일 주소입니다.
          X.509 인증서 단계에서 4.dX.509 인증서가 작성되었습니다.
          키 스토어 암호 시작하기 전에 섹션에 나와 있는 키 스토어와 연결된 암호입니다.
        7. 편집 및 OAuth 토큰 가져오기를 선택합니다.
        8. 업데이트를 선택합니다.
        9. OAuth 토큰 흐름이 성공적으로 완료되면 안내 설정 페이지로 돌아가서 완료로 표시 확인란을 선택하여 연결 구성 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      6. 자원에 액세스하도록 커넥터의 속성을 구성합니다.
        1. 구성 속성 추가 작업을 선택합니다.
        2. 서비스 그래프 연결 속성 관련 목록에서 속성 값을 입력합니다.
          표 4. 서비스 그래프 연결 속성
          속성 설명
          수집 기간(일) API 사용량 데이터 수집 기간(일)입니다.
          CollectUsageData 사용량 데이터 수집을 사용하여 지정된 기간 동안 API 사용량 데이터를 검색합니다.
          디스커버리 범위 애플리케이션의 검색 범위입니다 Apigee X . 사용 가능한 옵션은 다음과 같습니다.
          조직
          서비스 계정이 조직 내 데이터에 액세스할 수 있는 Apigee X 경우 ServiceNow조직을 선택합니다.
          프로젝트
          서비스 계정이 프로젝트 내의 Apigee X 데이터에만 액세스할 수 있는 경우 ServiceNow프로젝트를 선택합니다.
          환경 제외 Apigee X 연결에서 제외되어야 하는 환경입니다.

          여러 환경의 경우 쉼표로 구분합니다. 속성에 나열된 Exclude Environments 게이트웨이를 제외한 모든 게이트웨이를 가져옵니다.

          조직 ID 프로젝트가 속한 시스템 내의 Apigee X 조직입니다.
          페이지 크기 페이지당 기록 수입니다. 기본값은 100이고 최솟값은 2입니다.
          파티션 크기 병렬 로드가 활성화된 경우 관리되는 API의 Apigee X 파티션 크기입니다.

          0보다 큰 숫자 값을 사용할 수 있습니다. 비워 두면 값이 자동으로 계산됩니다.

          프로젝트 ID 연결이 연결될 환경 내의 Apigee X 프로젝트 식별자입니다.

          프로젝트 ID가 여러 개인 경우 쉼표로 구분합니다.

          팁:
          속성 값을 입력하려면 두 번 클릭(또는 바로 가기 키 사용)하여 속성의 셀에 값을 입력합니다.
        3. 완료로 표시 확인란을 선택하여 구성 속성 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      7. 연결을 테스트합니다.
        1. 연결 테스트 작업을 선택합니다.
        2. 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.

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

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

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

        4. 완료로 표시 확인란을 선택하여 연결 테스트 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
    5. 옵션: 여러 Apigee X 인스턴스와 통합합니다.
      1. 페이지의 Add Multiple Instances(여러 인스턴스 추가) 섹션에서 Start(Apigee X용 API 서비스 그래프 커넥터시작)를 선택합니다.
      2. Apigee X 연결에 대한 데이터 소스 작성을 활성화합니다.
        1. 데이터 소스 [sys_data_source] 테이블에 대한 편집 권한이 있는지 확인하십시오.
        2. 데이터 소스 접근 업데이트 작업을 선택합니다.
        3. 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        4. 다른 탭에서 열리는 데이터 소스 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
        5. 업데이트를 선택합니다.
        6. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 Apigee X용 API 서비스 그래프 커넥터 .
        7. 완료로 표시 확인란을 선택하여 데이터 원본 액세스 업데이트 작업을 완료하도록 설정한 다음 계속을 선택합니다.
      3. Apigee X 연결에 대해 예약된 임포트 작업 작성을 활성화합니다.
        1. 예약된 데이터 임포트 [scheduled_import_set] 테이블에 대한 편집 권한이 있는지 확인합니다.
        2. 예약된 데이터 임포트 접근 업데이트 작업을 선택합니다.
        3. 기록을 편집하려면 애플리케이션 선택기에서 전역 애플리케이션 범위를 선택합니다.
        4. 예약된 데이터 임포트 양식의 애플리케이션 접근 관련 목록에서 만들기 가능, 업데이트 가능, 삭제 가능 확인란을 선택합니다.
        5. 업데이트를 선택합니다.
        6. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 Apigee X용 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");     
          GlideTableManager.invalidateTable("sys_attachment");
          GlideCacheManager.flushTable("sys_attachment");
        4. 스크립트 실행을 선택합니다.
        5. 애플리케이션 선택기에서 애플리케이션 범위를 선택합니다 Apigee X용 API 서비스 그래프 커넥터 .
        6. 완료로 표시를 선택하여 데이터 원본 및 예약된 데이터 임포트 테이블에 대한 캐시 지우기 작업을 완료하도록 설정합니다.
      5. Apigee X 인스턴스에 대한 X.509 인증서를 만들려면 단계를 4.d반복한 다음 완료로 표시를 선택하여 X.509 인증서 만들기 작업을 완료로 표시합니다.
      6. Apigee X 인스턴스에 다른 연결을 추가합니다.
        1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 Apigee X용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
        2. 다른 연결 추가 작업을 선택한 다음 여기 클릭을 선택합니다.
        3. 다른 브라우저 탭에서 열리는 연결 페이지에서 연결 추가를 선택합니다.
        4. 연결 생성 창에서 연결, 서비스 계정 및 키 스토어 암호를 포함한 키 스토어 상세 정보를 입력합니다.

          단계에서 5.e키 스토어를 작성했습니다.

        5. OAuth 토큰 생성 및 가져오기를 선택합니다.
        6. 연결 페이지를 닫고 안내 설정 페이지 탭으로 돌아갑니다.
        7. 완료로 표시 확인란을 선택하여 다른 연결 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      7. 새 연결에 대한 속성을 추가합니다.
        1. 애플리케이션 선택기를 사용하여 애플리케이션 범위가 애플리케이션으로 Apigee X용 API 서비스 그래프 커넥터 설정되어 있는지 확인합니다.
        2. 구성 속성 추가 작업을 선택합니다.
        3. 이름 열에서 다음 단계에서 5.f작성한 연결 이름을 선택합니다.
        4. 서비스 그래프 연결 속성 관련 목록에서 속성 값을 입력합니다.

          속성에 관한 자세한 내용은 4.f.ii을 참조하십시오.

          팁:
          속성 값을 입력하려면 두 번 클릭(또는 바로 가기 키 사용)하여 속성의 셀에 값을 입력합니다.
        5. 완료로 표시 확인란을 선택하여 구성 속성 추가 작업을 완료하도록 설정한 다음, 계속을 선택합니다.
      8. 새 연결을 테스트합니다.
        1. 새 연결 테스트 작업을 선택합니다.
        2. 이름 열에서 다음 단계에서 5.f작성한 연결 이름을 선택합니다.
        3. 연결 테스트 관련 링크를 선택하여 연결을 테스트합니다.

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

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

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

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

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

      4. 활성 확인란을 선택하여 예약된 작업을 활성화합니다.
      5. 실행 필드에서 주기적으로를 선택하여 작업이 실행되는 빈도를 지정합니다.
      6. 업데이트를 선택합니다.
      7. 완료로 표시 확인란을 선택하여 예약된 임포트 작업 설정 작업을 완료하도록 설정한 다음 계속을 선택합니다.
    7. Apigee X용 API 서비스 그래프 커넥터 페이지에서 완료를 선택하여 변경 내용을 저장합니다.
    8. 설정 완료 대화 상자에서 완료 를 선택하여 설정을 완료합니다.
    9. 표시되는 메시지 상자에서 완료를 선택합니다.