Skip to main content

​
Freshservice 정보

Iru는 Freshservice API v2에서 티켓, 변경(승인 상태 및 구현 날짜 포함), 인시던트, 문제, CMDB 자산, 에이전트 및 해당 역할을 읽습니다. 인증에는 Profile Settings에서 찾을 수 있는 API 키를 사용합니다. 요청 대상은 https://YOUR_DOMAIN.freshservice.com/api/v2의 계정 도메인입니다. 커넥터 마법사는 먼저 Basic 자격 증명을 받은 다음 도메인을 받습니다.

​
작동 방식

Freshservice는 HTTPS를 통한 HTTP Basic을 사용합니다. 사용자 이름은 API 키이고 비밀번호는 비어 있지 않은 임의의 문자열이며, 관례적으로 문자 X를 사용합니다. 인코딩은 Iru가 처리합니다. 사용자 이름과 비밀번호를 사용하는 Basic 인증은 2023년 5월 31일에 지원 중단되어 이제 실패하므로, API 키가 유일하게 지원되는 방법입니다. API 키는 키를 생성한 에이전트의 권한을 그대로 가지며 엔드포인트별 범위는 없습니다. 권한이 제한된 에이전트의 키는 티켓과 변경 사항의 일부만 반환합니다. 증거가 완전하게 유지되도록 전용 관리자 수준 서비스 계정을 사용하세요. 공식 참고 자료: API v2 reference, Where to find your API key.

​
사전 요구 사항

  • 도메인(https://acme.freshservice.com의 acme).
  • 키를 생성할 관리자 수준 에이전트 계정. 개인 에이전트 계정을 사용하면 증거 수집이 한 사람의 권한에 묶이며, 해당 사용자가 퇴사하면 중단됩니다.
  • 범위에 포함할 항목을 결정하세요. Freshservice에서는 티켓 유형을 제외하거나, 자산 인벤토리를 건너뛰거나, 부서별로 필터링할 수 있습니다. 기본 데이터가 제외되면 Iru는 영향을 받는 컨트롤을 확인할 수 없음으로 표시합니다.

​
Freshservice를 Iru에 연결

Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
1

Freshservice에 로그인

통합이 권한을 상속할 관리자 수준 에이전트로 https://YOUR_DOMAIN.freshservice.com에 로그인합니다.
2

Profile Settings 열기

오른쪽 상단의 프로필 아바타를 선택한 다음 Profile Settings를 선택합니다.
3

API 키 복사

해당 페이지에서 Your API Key를 찾아 복사합니다. Freshservice는 매번 새 키를 생성하지 않고 프로필 페이지에 키를 표시하므로 나중에 다시 확인할 수 있습니다.
4

비밀번호 규칙 확인

Basic 인증의 비밀번호는 문자 X입니다. Freshservice가 아닌 Iru에 입력합니다.
Iru Compliance 탭에서 계속 진행하세요.

​
문제 해결

Iru 사이트에 대한 팝업 차단 설정을 확인한 후 다시 시도하세요.
API 키 대신 이메일 주소와 비밀번호를 사용했습니다. 이 방법은 2023년 5월 31일에 제거되었습니다. 키를 사용자 이름으로 사용하세요.
전체 API 키를 붙여넣고 비밀번호 필드에 X와 같이 비어 있지 않은 값이 있는지 확인하세요. 비밀번호가 비어 있으면 실패합니다.
키를 생성한 에이전트에게 변경, 자산 또는 문제에 대한 권한이 없습니다. 관리자 수준 에이전트로 키를 다시 생성하세요.
이 연결에서 CMDB가 범위에서 제외되었거나 에이전트가 자산을 읽을 수 없습니다. Iru는 이 두 경우를 구분할 수 없습니다.
도메인을 수정하고 다시 연결하세요. 도메인은 전체 URL이 아닌 하위 도메인만 해당합니다.

​
관련 문서

Sources 관리

모든 Compliance 소스를 찾아보고 관리합니다.

Freshsales

CRM 증거를 위해 Freshsales를 연결합니다.

Compliance 시작하기

프레임워크, 작업 및 아티팩트.

Artifacts 관리

소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.