다음을 통해 공유


Rapid7 데이터 커넥터

Rapid7 통합을 설정하려면 Rapid7 Platform API의 엔드포인트(예: "us.api.insight.rapid7.com")가 필요합니다. 커넥터는 엔드포인트 및 API 키를 사용하여 API 키 인증으로 인증합니다.

Rapid7 구성

  1. 엔드포인트 - Rapid7 엔드포인트를 찾습니다. 여기의 지침을 따르세요.

  2. API 키 – 이 통합에는 자산을 가져올 수 있는 권한이 있는 사용자의 사용자 API 키가 필요합니다. API 키를 생성하려면 이 링크의 세부 정보를 참조 하세요.

    참고:사용자 키에 연결하는 것보다 organization 키로 연결하는 것이 더 성공적이었습니다. 연결 성공 가능성을 높이기 위해 organization 키를 선택하는 것이 좋습니다.

노출 관리에서 Rapid7 연결 설정

노출 관리에서 Rapid7과의 연결을 설정하려면 다음 단계를 수행합니다.

  1. 노출 관리 탐색에서 데이터 커넥터 를 열고 Rapid7 타일에서 연결을 선택합니다.
  2. Rapid7 엔드포인트 및 API 키 세부 정보를 입력하고 연결을 선택합니다.

검색된 데이터

노출 관리는 컴퓨터 및 가상 머신을 포함하여 Rapid7에서 컴퓨팅 디바이스의 데이터를 검색합니다. 또한 해당 디바이스에서 Rapid7에서 보고한 취약성을 검색합니다.

Rapid7 자산의 "last_scan_end" 필드를 평가하여 지난 90일 동안 적극적으로 검사한 디바이스만 검색됩니다.

범주 속성
자산/디바이스 및 각 식별자당 데이터 - Rapid7 ID
- 호스트 이름
-IP 주소
- mac 주소
- OS 정보
- Rapid7 위험 점수
-태그
- Rapid7 중요도 데이터
- 클라우드 플랫폼
취약성 조사 결과 Rapid7은 수집하는 자산에 대한 CVE 결과를 검색합니다.

Rapid7 데이터 커넥터 문제 해결

다음은 Rapid7 커넥터를 구성할 때 발생할 수 있는 몇 가지 일반적인 문제와 resolve 방법에 대한 제안입니다.

오류 유형 문제 해결 작업
'원격 서버 이름을 확인할 수 없습니다.' 오류 메시지 Rapid7 엔드포인트를 확인합니다. 여기에서 Rapid7 API 엔드포인트를 확인하는 방법에 대해 자세히 알아봅니 .
오류 코드 401: 권한 부여 실패 권한 부여 실패는 자격 증명이 올바르지 않거나 Rapid7 데이터에 액세스할 수 있는 권한이 충분하지 않을 수 있음을 나타냅니다. API 키를 확인하고 유효한지, 계정이 잠겨 있지 않은지 확인합니다. 경우에 따라 organization 키를 사용하는 것이 사용자 키를 생성하는 것보다 더 성공적으로 작동하는 것으로 나타났습니다.
organization 키로 연결을 테스트해 보세요. 다음 명령을 실행하여 자격 증명을 테스트할 수 있습니다.
curl -l --request POST --location 'https://\<region\>.api.insight.rapid7.com/vm/v4/integration/assets?size=2&includeSame=true' --header 'X-API-Key:\<key\>' --header 'Content-Type: application/json' –header ‘Accept: application/json’
curl -l --request POST --location 'https://\<region\>.api.insight.rapid7.com/vm/v4/integration/vulnerabilities?size=2’ --header 'X-API-Key:\<key\>' --header 'Content-Type: application/json' –header ‘Accept: application/json’
이러한 오류가 실패하고 오류를 설명하는 경우 완화하려면 Rapid7 설명서를 참조하세요.
오류 코드 403: 액세스 금지 오류 이 오류는 제공된 자격 증명에 요청된 API를 실행하는 데 필요한 권한이 없음을 나타냅니다. Rapid7 데이터에 액세스할 수 있는 충분한 권한이 있는 사용자와 함께 API 키가 생성되었는지 확인합니다.
오류 코드 404: 찾을 수 없음 오류 이 오류는 요청된 엔드포인트에 연결할 수 없음을 나타냅니다. Rapid7 엔드포인트가 올바른지 확인합니다. 여기에서 Rapid7 API 엔드포인트를 확인하는 방법에 대해 자세히 알아봅니 .
'임시 연결 문제' 오류 메시지 구성 세부 정보(엔드포인트 URL 및 API 키)를 확인하고 올바른지 확인합니다. 자세한 내용은 Rapid7 구성 섹션 을 검토하세요.
수집된 데이터에서 Rapid7에서 보고한 내 자산 또는 취약성이 표시되지 않음 Rapid7 커넥터 에서 검색할 예상 데이터에 대한 설명은 검색된 데이터를 참조하세요. 여전히 누락된 데이터가 있는 경우 지원에 문의하세요.
Rapid7 허용 IP를 구성하여 노출 관리 커넥터가 Rapid7에 액세스할 수 있도록 해야 합니다. 허용 목록에 추가할 IP 집합을 추가하는 방법을 읽어보세요. 허용 목록 IP 주소입니다.

다음 단계

데이터 커넥터에서 값을 가져옵니다.