Kandji ServiceNow 앱 설치
앱이 아직 설치되지 않은 경우 ServiceNow 인스턴스에 Kandji ServiceNow 앱을 설치하세요. 설치하면 테넌트에서 통합에 필요한 종속 항목이 추가됩니다.1
ServiceNow Store 접속
ServiceNow store로 이동합니다.
2
Kandji ServiceNow 앱 찾기
스토어에서 Kandji를 검색하여 Kandji ServiceNow app을 찾습니다.
3
Kandji ServiceNow 앱 설치
Get을 선택하여 Kandji ServiceNow 앱을 설치합니다. 메시지가 표시되면 ServiceNow store에 로그인합니다. 사용하는 계정에는 Integration Hub 스토어 앱을 설치할 수 있는 권한이 있어야 합니다.
OAuth 앱 생성
Iru Endpoint는 grant type이 **Resource Owner Password Credentials (ROPC)**인 ServiceNow OAuth API 클라이언트를 사용하여 인스턴스의 액세스 토큰과 새로 고침 토큰을 가져옵니다.ServiceNow Zurich 이상 릴리스에서는 외부 클라이언트용 OAuth API 엔드포인트를 생성할 때 Scope Restriction을 Broadly scoped로 설정하세요. 이 필드가 더 좁은 범위로 설정되면 Iru Endpoint의 인바운드 API 호출이 OAuth client does not have unrestricted access to unscoped APIs is not allowed와 같은 오류로 실패할 수 있습니다. 자세한 내용은 ServiceNow KB2731346을 참조하세요.
1
ServiceNow 접속
ServiceNow 관리자 계정을 사용하여 ServiceNow 테넌트(.service-now.com)에 로그인합니다.
2
System OAuth로 이동
Filter navigator에서 System OAuth를 검색합니다.
3
Application Registry 열기
Application Registry를 선택합니다.
4
OAuth 엔드포인트 생성
Create an OAuth API endpoint for external clients를 선택합니다.
5
OAuth 앱 구성
OAuth 앱의 이름을 지정합니다(예:
kandji_oauth_api).6
Redirect URL 설정
Redirect URL 필드에 https://kandji.io를 입력합니다.
7
구성 제출
제출을 선택합니다.
8
OAuth 앱 접속
방금 생성한 OAuth 앱으로 돌아갑니다.
9
Client ID 복사
Client ID를 강조 표시하고 복사합니다.
10
Client Secret 표시
자물쇠 아이콘을 선택하여 Client Secret을 표시합니다.
11
Client Secret 복사
Client Secret을 복사합니다. 직접 클라이언트 시크릿을 설정한 경우 업데이트를 선택하여 저장합니다.
서비스 계정 추가
서비스 계정 사용자 자격 증명은 Iru Endpoint에서 ServiceNow 통합을 구성하는 데 사용됩니다.웹 서비스에 대한 접근 권한이 있고 cmdb_read, import_transformer, rest_api_explorer 역할이 있는 ServiceNow 사용자 계정이라면 어떤 계정이든 사용할 수 있습니다. 가능하면 이 통합 전용 서비스 계정을 생성하세요.
1
ServiceNow 접속
ServiceNow 관리자 계정을 사용하여 ServiceNow 테넌트(.service-now.com)에 로그인합니다.
2
사용자로 이동
Filter navigator에서 사용자를 검색합니다.
3
User Administration 열기
User Administration에서 사용자를 선택합니다.
4
새 사용자 생성
New를 선택하여 새 사용자를 추가합니다.
5
사용자 세부 정보 구성
사용자에 대한 설명이 포함된 이름을 입력합니다(예:
kandji_rest_api_user). 사용자 이름을 안전한 위치에 복사해 두세요. Iru Endpoint에서 통합을 구성할 때 필요합니다.- 필요한 경우 조직에서 요구하는 추가 정보를 입력합니다.
6
웹 서비스 접근 설정
Web service access only를 선택합니다.
7
사용자 생성 제출
제출을 선택합니다.
8
사용자 비밀번호 설정
방금 생성한 사용자를 열고 Set Password를 선택합니다.
9
비밀번호 생성
생성을 선택하여 새 비밀번호를 생성합니다.
10
비밀번호 복사
새 비밀번호를 복사합니다.
11
비밀번호 저장
Save Password를 선택합니다. 비밀번호를 안전한 위치에 보관하세요. ServiceNow 통합을 구성할 때 Iru Endpoint에 입력합니다.
12
비밀번호 대화 상자 닫기
닫기를 선택하여 Users 페이지로 돌아갑니다.
13
사용자 역할 접속
사용자 페이지에서 Roles로 이동합니다.
14
역할 편집
편집을 선택합니다.
15
필수 역할 추가
서비스 계정 사용자에게 다음 역할을 추가합니다.
- cmdb_read
- import_transformer
- rest_api_explorer
16
역할 할당 확인
총 6개의 역할이 표시되어야 합니다. 직접 추가한 역할 3개와 상속된 역할 3개입니다.
17
사용자 구성 저장
사용자 생성을 완료하려면 저장을 선택합니다.
문제 해결
Kandji가 Discovery Source인지 확인
1
Dictionary 접속
ServiceNow의 Filter navigator에 Dictionary를 입력합니다.
2
Dictionary 열기
System Definition에서 Dictionary를 선택합니다.
3
Discovery Source 검색
Dictionary Entries에서 Column name을 선택한 다음 discovery_source를 입력합니다.
4
CMDB 테이블 선택
cmdb_ci 테이블을 선택합니다.
5
Choices 탭 접속
아래로 스크롤하여 Choices 탭을 선택합니다.
6
Kandji 확인
Kandji가 목록에 있는지 확인합니다. 표시되지 않으면 레이블 Kandji를 검색합니다.
Kandji가 Discovery Source로 표시되지 않는 경우
Kandji ServiceNow 앱을 설치한 후 Kandji가 discovery source로 표시되지 않으면 kandji_fix_script를 수동으로 실행하세요.1
Fix Scripts 접속
ServiceNow의 Filter navigator에 Fix Script를 입력합니다.
2
Fix Scripts 열기
System Definition에서 Fix Scripts를 선택합니다.
3
Fix Script 검색
Fix Scripts에서 이름을 선택한 다음 kandji_fix_script를 입력합니다.
4
Fix Script 선택
kandji_fix_script 레코드를 엽니다.
5
Fix Script 실행
Run Fix Script를 선택합니다.
6
백그라운드에서 실행
Run Fix Script 모달에서 Proceed in Background를 선택합니다.
고려 사항
서비스 계정
접근 및 변경 사항을 더 쉽게 감사할 수 있도록 대화형 사용자를 재사용하는 대신 이 통합 전용 계정을 사용하는 것이 좋습니다.
OAuth
Zurich 이상에서는 OAuth 앱을 생성할 때 Scope Restriction을 Broadly scoped로 설정하세요(OAuth 앱 생성 참조). Redirect URL을
https://kandji.io로 설정하고 클라이언트 자격 증명을 안전하게 보관하세요.역할
서비스 계정에는 cmdb_read, import_transformer, rest_api_explorer 역할이 필요합니다.
검색 소스
설치 후 Dictionary에서 cmdb_ci의 discovery source 선택 항목에 Kandji가 표시되는지 확인하세요.
문제 해결
discovery source 또는 동기화가 올바르지 않은 경우 kandji_fix_script fix script를 실행하고 서비스 계정에 위의 세 가지 역할이 있는지 확인하세요.
관련 문서
ServiceNow 통합: 개요
인벤토리가 Iru Endpoint에서 ServiceNow 테이블 및 변환으로 흐르는 방식과 SAM Pro 데이터가 활성화된 경우의 흐름을 설명합니다.
ServiceNow 통합: Iru Endpoint 구성
OAuth 앱과 서비스 계정으로 Iru Endpoint를 연결하고, ServiceNow가 준비된 후 통합을 관리합니다.