macOS에 한 줄 에이전트 클라이언트 수집기 설치 수행

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 2분

    • 효율적인 한 줄 명령 스크립트를 사용하여 macOS 운영 체제를 사용하는 머신에 에이전트 클라이언트 수집기를 설치합니다. 에이전트가 인스턴스에 연결되지 않았거나 고급 커스터마이제이션 옵션을 원하는 경우 수동 설치 절차를 수행합니다.

    시작하기 전에

    • 에이전트 클라이언트 수집기 웹 서버를 구성했는지 확인합니다.
    • 에이전트 클라이언트 수집기 설치에 설명된 대로 서버의 OS와 버전이 지원되는 OS 버전의 목록과 일치하는지 확인합니다.
    • 설치 스크립트에서 사용할 수 있는 pkgutil 패키지가 있는지 확인합니다.
    • 대상 에이전트가 다음에 연결되어 있는지 확인합니다.
      • ServiceNow 설치 서버[install.service-now.com]
      • ServiceNow 인스턴스
      • 에이전트가 연결할 MID 서버

    필요한 역할: agent_client_collector_admin

    프로시저

    1. MID 서버 웹소켓 URL 매개변수를 검색합니다.
      1. 다음으로 이동 에이전트 클라이언트 수집기 > 웹소켓 엔드포인트 구성.
      2. 관련 웹소켓 엔드포인트를 선택합니다.
      3. 설치 명령에 사용할 엔드포인트 URL 필드 값을 복사합니다.
    2. API 키를 검색합니다.
      1. 다음으로 이동 에이전트 클라이언트 수집기 > 배치 > MID 웹 서버 API 키.
      2. 설치 명령에 사용할 API 키 값을 복사합니다.
    3. 에이전트 클라이언트 수집기가 설치되는 서버에서 다음 명령을 실행합니다. 
      ACC_API_KEY=<api_key> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events bash -c "$(curl -L https://<instance URL>/api/sn_agent/agents/install_agent)"

      명령줄에 다음 값을 입력합니다.

      표 1. 명령줄 매개변수
      매개변수 값
      ACC_API_KEY <api_key> 문자열을 MID 서버 웹소켓에 액세스하는 데 사용되는 API 키로 바꿉니다. 값을 지정하지 않으면 스크립트가 실행되는 동안 API 키 값을 입력하라는 메시지가 표시됩니다.
      ACC_MID <mid_ip> 문자열을 MID 서버 웹소켓의 URL로 바꿉니다. 여러 MID 서버를 지정하는 경우 MID 서버별로 문자열을 쉼표로 구분하여 입력합니다.
      ACC_ALLOW_LIST (선택 사항) 허용 목록을 사용하지 않도록 설정하려면 ACC_ALLOW_LIST=0 문자열을 추가합니다. 기본적으로 허용 목록은 사용하도록 설정되어 있습니다.
      주:
      허용 목록을 사용하지 않도록 설정하면 시스템의 보안이 손상되며 허용 목록 업데이트를 완료할 때까지 임시 조치로만 수행하는 것이 좋습니다. 업데이트를 완료한 후에는 한 줄 명령 문자열에서 ACC_ALLOW_LIST=0을 제거하여 허용 목록을 다시 활성화합니다.
      ACC_VALIDATE_SIG (선택 사항) 설치 관리자 인증서 검증 확인을 사용하지 않도록 설정하려면 ACC_VALIDATE_SIG=0 문자열을 추가합니다. 기본적으로 검증은 활성화되어 있습니다.

      기본적으로 확인은 활성화되어 있습니다.

      주:
      비표준 서명 확인 도구를 사용하는 경우에만 인증 확인을 비활성화합니다.