실패한 자세 검사 동안 티켓 생성하기

Prev Next

개요

실패한 검사를 추적하고 기존 워크플로를 사용하여 수정 조치를 관리하려면, 실패한 SaaS 보안 자세 또는 계정 자세 검사를 통해 Cato 관리 애플리케이션 (CMA)에서 직접 티켓을 만드십시오. 티켓에는 세부 정보를 수동으로 복사하지 않고도 수정 작업을 시작하는 데 필요한 정보가 포함됩니다. 이로 인해 CMA와 티켓 플랫폼을 사용하는 팀 간의 소통이 간소화됩니다.

티켓을 생성하면 해당 ID가 CMA의 자세 검사 검토 서랍에 나타납니다.

티켓은 사전 정의된 템플릿과 웹훅 통합을 사용하여 생성됩니다. 통합 구성은 한 번만 필요합니다. 구성 후 통합을 사용하여 티켓을 생성할 수 있습니다.

티켓 내용 이해하기

CMA에서 티켓이 생성되면 검사 이름이 티켓 제목으로 사용됩니다. 티켓 설명에는 다음이 포함됩니다:

  • 검사 이름, 설명, 상태, 및 심각도

  • 사용자의 Cato 계정 이름과 계정 ID

  • 검사에 대한 권장 조치

  • 영향을 받은 발견 사항과 발견 사항 총 개수

  • Cato 관리 애플리케이션에서의 검사 링크

지원되는 티켓 플랫폼

다음 티켓 플랫폼이 지원됩니다:

  • Jira

  • 서비스나우

웹훅 통합 생성하기

웹훅 통합을 구성하려면 다음이 필요합니다:

  1. 티켓 시스템에서 필수 설정을 구성하십시오

  2. CMA에서 웹훅을 구성하십시오

Jira에 대한 웹훅 통합 생성

전제 조건

  • 파일 찾아보기 및 작업 항목 생성 권한을 가진 사용자

단계 1: Jira에서 필수 설정 구성하기

Jira에서 설정을 구성하려면:

  1. Atlassian 계정에서 오른쪽 상단의 프로필을 클릭하고 계정 설정을 클릭합니다.

  2. 보안 탭에서 API 토큰 섹션의 API 토큰 생성 및 관리를 클릭합니다.

  3. API 토큰을 범위로 또는 범위 없이 생성할 수 있습니다

    1. 범위를 지정하여 API 토큰을 생성하려면:

      1. 범위 포함 API 토큰 생성을 클릭합니다.

      2. 이름과 만료 날짜를 추가합니다.
        참고: 최대 만료 날짜를 365일로 선택할 것을 권장합니다.

      3. 다음 을 클릭하고 Jira 앱을 선택하세요

      4. 다음 을 클릭하고 write:jira-work 범위를 선택하세요

      5. 생성을 클릭하십시오.

    2. 범위 없이 API 토큰을 생성하려면:

      1. API 토큰 생성을 클릭합니다.

      2. 이름과 만료 날짜를 추가합니다.
        참고: 최대 만료 날짜를 365일로 선택할 것을 권장합니다.

      3. 생성을 클릭하십시오.

  4. CMA에 입력할 수 있도록 토큰을 복사하고 저장합니다.

  5. Atlassian 계정의 사이드바에서 스페이스 옆에 있는 세 점을 클릭합니다.

  6. 스페이스 관리를 클릭합니다.

  7. 티켓이 생성될 스페이스의 키를 복사하고 저장하여 CMA에 입력할 수 있도록 합니다.

  8. 범위가 있는 토큰을 생성한 경우, 웹 브라우저에 https://<your-site>.atlassian.net/_edge/tenant_info를 입력하고 cloudId 값을 복사하여 CMA에 입력할 수 있도록 합니다.
    범위가 없는 토큰을 생성한 경우 이 단계는 필요하지 않습니다.

단계 2: CMA에서 Webhook 구성

Webhook을 CMA에서 구성하려면:

  1. CMA에서 계정 > 구독으로 이동하십시오.

  2. Webhooks 탭에서 새로운을 클릭합니다.

  3. 이름을 추가합니다.

  4. 템플릿에서 시작 드롭다운 메뉴에서 Jira 자세 체크 티켓 생성을 선택합니다.

  5. URL 필드에서:

    1. 범위를 지정한 API 토큰의 경우: https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue, 여기서 <cloudId>는 1단계에서 복사한 cloudId입니다.

    2. API 토큰의 범위가 없는 경우: https://<your-site>.atlassian.net/rest/api/2/issue, 여기서 <your-site>는 당신의 Jira 사이트 이름입니다

  6. 1단계에서 API 토큰을 생성한 사용자의 사용자 이름을 추가하세요.

  7. 비밀번호 필드에 1단계에서 생성한 API 키를 입력하세요.

  8. 사용자 정의 본문 섹션에서 <YOUR-SPACE-KEY>를 1단계에서 복사한 공간 키로 교체하세요.

  9. (선택 사항) 공간에 작업 유형이 사용되지 않거나 프로젝트에 대한 추가 필드가 필요한 경우 본문을 적절히 편집하세요.

  10. 테스트를 클릭합니다.
    테스트 작업 항목이 Jira 공간에서 생성되고, '테스트가 성공적으로 통과되었습니다' 메시지가 표시됩니다. 그 후 테스트 작업 항목을 삭제할 수 있습니다.

  11. 저장을 클릭합니다.

ServiceNow의 웹훅 통합 생성

사전 준비사항

  • itil 역할을 맡은 사용자

단계 1: ServiceNow에서 필수 설정 구성

ServiceNow에서 설정을 구성하려면:

  1. ServiceNow 계정에 관리자 권한으로 로그인하여 사용자 관리 > 사용자로 이동합니다.

  2. 새로운을 클릭하십시오.

  3. 사용자 ID 및 이메일 주소를 입력하고 웹 서비스 액세스 전용을 선택합니다.

  4. 제출을 클릭합니다.

  5. 생성한 사용자의 기록을 엽니다:

    1. 비밀번호 설정을 클릭한 후 비밀번호 생성을 선택하세요. 비밀번호를 복사하여 저장하여 CMA에 입력할 수 있도록 합니다.

    2. 비밀번호 저장을 클릭합니다.  

    3. 역할 탭에서 편집 을 클릭하고 itil 역할을 추가하세요

    4. 저장을 클릭합니다

단계 2: CMA에서 웹훅 구성

CMA에서 웹훅을 구성하려면:

  1. CMA에서 계정 > 구독으로 이동합니다.

  2. Webhook 탭에서 새롭다를 클릭하십시오.

  3. 이름을 추가하십시오.

  4. 템플릿에서 시작 드롭다운 메뉴에서 서비스나우 상태 점검 티켓 생성을 선택합니다.

  5. URL 필드에서 <YOUR-INSTANCE-NAME>을 서비스나우 인스턴스 이름으로 바꾸십시오, URL은 https://<instance>.service-now.com/api/now/table/incident입니다

    서비스나우 URL에서 인스턴스 이름은 첫 번째 부분입니다. 예를 들어, https://acme.service-now.com에 로그인하면 인스턴스 이름은 acme이고 URL은 https://acme.service-now.com/api/now/table/incident입니다.

  6. 사용자 이름 필드에 1단계에서 생성한 서비스나우 사용자의 사용자 ID를 입력합니다.

  7. 비밀번호 필드에 1단계에서 생성한 서비스나우 사용자의 비밀번호를 입력합니다.

  8. (옵션) 사용자 정의 본문 섹션에서 사건의 기본 우선순위, 긴급도, 영향력을 변경하거나 배정 그룹과 같은 필드를 추가합니다.

  9. 테스트를 클릭하십시오.
    서비스나우에 테스트 사건이 생성되고 '테스트가 성공적으로 통과되었습니다'라는 메시지가 표시됩니다. 테스트 작업 항목을 나중에 해결하거나 종료할 수 있습니다.

  10. 저장을 클릭합니다.

실패한 상태 점검에 대한 티켓 생성

webhook 통합을 생성한 후 CMA에서 상태 점검 리뷰 드로어에서 티켓을 생성할 수 있습니다 티켓에는 최대 100개의 초기 정보가 기본 세부 정보와 함께 포함됩니다. 점검에 100개 이상의 초기 정보가 포함되거나 전체 세부 정보를 포함하도록 하려면 전체 초기 정보 목록(CSV) 링크 추가 체크박스를 선택하고 전체 초기 정보를 CSV 파일로 다운로드합니다. 칸 티켓에 CSV를 포함하려면 SharePoint와 같은 공유 위치에 업로드하고 CMA에 공유 가능한 링크를 추가하십시오.

실패한 상태 점검에 대한 티켓 생성하기:

  1. CMA에서 홈 > 상태로 이동하십시오.

  2. 티켓을 생성하려는 실패한 점검을 클릭하십시오.

  3. 티켓 생성을 클릭하십시오.

  4. 통합 드롭다운에서 티켓 생성을 위해 사용할 webhook 통합을 선택하십시오.

  5. (선택 사항) 검사의 결과가 100개 이상인 경우, CSV 파일을 다운로드하고 링크를 공유 위치에 추가할 수 있습니다.

  6. 티켓 생성을 클릭하십시오.

생성된 티켓 보기

CMA에서 티켓이 생성되면 체크의 자세 검토 서랍에 티켓 ID가 표시됩니다.

참고: 자세 검토가 통과되면 티켓이 자동으로 업데이트되지 않습니다.

문제 해결

티켓 생성이 실패한 경우, 에러 메시지가 티켓 시스템에서 반환된 상태를 보여줍니다:

  • 401 (권한 없음): 자격 증명이 잘못되었거나 토큰이 만료되었습니다. webhook의 사용자 이름과 비밀번호 필드를 확인한 후 테스트를 클릭하십시오 Jira에서는 사용자의 이메일 주소와 API 토큰을 사용하십시오. 토큰이 만료된 경우, 새로운 토큰을 생성하고 webhook의 비밀번호 필드를 업데이트하십시오.

  • 403 (금지됨): 사용자가 필요한 권한을 가지고 있지 않습니다. Jira에서는 사용자가 관련 공간에서 탐색 공간 및 작업 항목 생성 권한을 가지고 있는지 확인하십시오. 서비스나우에서, 사용자가 itil 역할을 가지고 있는지 확인하십시오.

  • 400 (잘못된 요청): 티켓 시스템이 요청 본문을 거부했습니다. 사용자 정의 본문에서 잘못된 공간 키 또는 필수 필드 누락을 확인하십시오.

  • 티켓 ID 누락: 티켓은 생성되었지만 Cato가 응답에서 그 ID를 읽을 수 없습니다. webhook의 응답 매핑이 템플릿과 일치하는지 확인하십시오