> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/data-onboarding/supported-logs/1password.md). # 1Password 로그 ## 개요 Panther는 다음을 통해 1Password 이벤트 로그를 가져옵니다 [1Password 이벤트 API](https://support.1password.com/events-api-reference/) 1분마다. Panther는 다음 1Password 이벤트를 특별히 모니터링합니다: * 사용자의 1Password 계정에서의 로그인 시도 * 수정, 액세스 또는 사용된 공유 금고의 항목 * 활동 로그의 감사 이벤트 Panther는 기기가 오프라인인 동안 생성된 1Password 이벤트를 수집합니다. {% hint style="info" %} 다음을 유발하는 작업이 발생한 시점부터 최대 하루까지 지연이 있을 수 있습니다 [OnePassword.ItemUsage](#onepassword.itemusage) 이벤트가 발생한 시점부터 로그가 Panther에 수집될 때까지. Panther는 이벤트가 사용 가능해지는 즉시 가져오지만, 일부 기기는 1Password와 하루에 한두 번만 동기화됩니다. {% endhint %} ## 1Password 로그를 Panther에 연동하는 방법 Panther에서 1Password를 로그 소스로 설정하려면, 1Password 계정에서 액세스 토큰을 생성한 다음 Panther에서 1Password 로그 소스를 구성해야 합니다. ### 1단계: 1Password에서 액세스 토큰 생성 1. [로그인](https://start.1password.com/signin) 1Password 계정에 로그인한 다음 클릭 **Integrations** 사이드바에서. 2. 클릭합니다 **디렉터리** 페이지 상단에서. 3. "Events Reporting" 섹션으로 스크롤한 다음 클릭 **Panther**.\ In the "Events Reporting" section in 1Password, there is a tile labeled Panther. In the image, there is a red square around it. 4. 다음을 입력하세요 **시스템 이름** 통합용으로 **통합 추가**. 5. 베어러 토큰의 이름을 입력하고 토큰 만료 시간을 선택합니다. 6. 토큰에 부여할 액세스 권한이 있는 이벤트 유형을 선택하세요: * 로그인 시도 * 다음을 수집할 계획이라면 이 옵션을 선택하세요 [OnePassword.SignInAttempt](#onepassword.signinattempt) 이벤트를 Panther에 수집합니다. * 항목 사용 이벤트 * 다음을 수집할 계획이라면 이 옵션을 선택하세요 [OnePassword.ItemUsage](#onepassword.itemusage) 이벤트를 Panther에 수집합니다. * 감사 이벤트 * 다음을 수집할 계획이라면 이 옵션을 선택하세요 [OnePassword.AuditEvent](#onepassword.auditevent) 이벤트를 Panther에 수집합니다. 7. 클릭합니다 **토큰 발급** 액세스 토큰 키를 생성합니다. * 1Password 베어러 토큰의 발급 또는 취소에 대한 추가 정보는 다음을 참조하세요 [1Password 문서](https://support.1password.com/events-reporting/#appendix-issue-or-revoke-bearer-tokens). 8. 클릭합니다 **1Password에 저장** 그런 다음 토큰을 저장할 금고를 선택합니다. 9. 클릭합니다 **통합 세부 정보 보기** 토큰을 보려면 * 다음 단계에서 이 토큰이 필요합니다. ### 2단계: Panther에서 새 1Password 로그 소스 만들기 1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**. 2. 클릭합니다 **새로 만들기.** 3. “1Password”를 검색한 다음 해당 타일을 클릭하세요. 4. 슬라이드아웃 패널에서 다음을 클릭합니다 **설정 시작**. 5. 다음 화면에서 소스 이름을 입력하세요. 예: `내 1Password 로그`. 6. 클릭합니다 **설정.** 7. 다음 페이지에서 **자격 증명** 페이지에서 양식을 작성하세요: * 메타데이터 URL을 **액세스 토큰 키** 1Password 계정에서 액세스 토큰 필드에 입력합니다. * 1Password 계정의 지역과 요금제를 선택하세요. 8. 클릭합니다 **설정**. 성공 화면으로 이동됩니다:\\
The success screen reads, "Everything looks good! Panther will now automatically pull & process logs from your account"
* 선택적으로 하나 이상의 [디택션 팩](https://docs.panther.com/detections/panther-managed/packs). * 다음 **이벤트가 처리되지 않으면 알러트를 발생시키기** 설정의 기본값은 **예**. 일정 시간이 지난 후 로그 소스에서 데이터 흐름이 멈추면 알러트를 받게 되므로 이 설정을 활성화한 상태로 두는 것을 권장합니다. 이 시간 범위는 구성 가능하며 기본값은 24시간입니다.\\
The "Trigger an alert when no events are processed" toggle is set to YES. The "How long should Panther wait before it sends you an alert that no events have been processed" setting is set to 1 Day
{% hint style="warning" %} **참고:** 기본적으로 1Password 로그에는 금고 및 로그인 자격 증명과 같은 객체의 사람이 읽을 수 있는 값이 포함되어 있지 않습니다. 자세한 내용은 [Lookup Table 사용 가이드를 참조하세요](https://docs.panther.com/guides/using-lookup-tables-1password-uuids) 1Password의 범용 고유 식별자(UUID) 값을 사람이 읽을 수 있는 이름으로 변환하세요. {% endhint %} ## Panther 내장 탐지 Panther의 내장 [Github의 panther-analysis에 있는 1Password 규칙](https://github.com/panther-labs/panther-analysis/tree/master/rules/onepassword_rules). ## 지원되는 로그 유형 ### OnePassword.ItemUsage 이는 1Password 항목 사용 이벤트입니다. 자세한 내용은 다음을 참조하세요 [1Password Events API 참조 문서](https://developer.1password.com/docs/events-api/reference/#item-usage). ```yaml 스키마: OnePassword.ItemUsage 파서: 네이티브: 이름: OnePassword.ItemUsage 설명: OnePassword 항목 사용 참조 URL: https://support.1password.com/events-api-reference/#item-usage 필드: - name: uuid 필수: true 설명: 이벤트의 UUID. 유형: string - 이름: timestamp 필수: true 설명: rfc3339 표준 형식의 이벤트 날짜 및 시간. 유형: timestamp 시간 형식: - rfc3339 이벤트 시간 여부: true - 이름: used_version 설명: 액세스된 항목의 버전. 유형: bigint - 이름: vault_uuid 설명: 항목이 있는 금고의 UUID. 유형: string - 이름: item_uuid 설명: 액세스된 항목의 UUID. 유형: string - 이름: action 설명: 항목이 사용된 방법에 대한 세부 정보입니다. 작업은 1Password 8.4.0 이상을 사용하는 클라이언트 앱에서만 캡처됩니다. 유형: string - 이름: user 설명: 항목에 액세스한 사용자 객체. 유형: object 필드: - name: uuid 설명: 항목에 액세스했거나 계정에 로그인하려고 시도한 사용자의 UUID. 유형: string - 이름: name 설명: 이벤트 생성 시점에 채워진 사용자의 이름. 유형: string - 이름: email 설명: 이벤트 생성 시점에 채워진 사용자의 이메일 주소. 유형: string 지표: - email - name: client 설명: 항목에 액세스하는 데 사용된 클라이언트 객체. 유형: object 필드: - 이름: app_name 설명: 항목에 액세스한 1Password 앱의 이름. 유형: string - 이름: app_version 설명: 앱의 버전 번호. 유형: string - 이름: platform_name 설명: 항목에 액세스한 플랫폼의 이름. 유형: string - 이름: platform_version 설명: 1Password가 설치된 브라우저 또는 컴퓨터의 버전, 또는 1Password 명령줄 도구가 설치된 컴퓨터의 CPU. 유형: string - 이름: os_name 설명: 항목에 액세스한 운영 체제의 이름. 유형: string - 이름: os_version 설명: 항목에 액세스한 운영 체제의 버전. 유형: string - 이름: ip_address 설명: 항목에 액세스한 IP 주소. 유형: string 지표: - ip ``` ### OnePassword.SignInAttempt 이는 1Password 로그인 시도입니다. 자세한 내용은 다음을 참조하세요 [1Password Events API 참조 문서](https://developer.1password.com/docs/events-api/reference/#sign-in-attempts). ```yaml 스키마: OnePassword.SignInAttempt 파서: 네이티브: 이름: OnePassword.SignInAttempt 설명: OnePassword 로그인 시도 참조 URL: https://support.1password.com/events-api-reference/#sign-in-attempts 필드: - name: uuid 필수: true 설명: 이벤트의 UUID. 유형: string - 이름: session_uuid 설명: 이벤트를 생성한 세션의 UUID. 유형: string - 이름: timestamp 필수: true 설명: rfc3339 표준 형식의 이벤트 날짜 및 시간. 유형: timestamp 시간 형식: - rfc3339 이벤트 시간 여부: true - 이름: category 설명: 로그인 시도의 범주. 유형: string - 이름: type 설명: 로그인 시도의 유형 세부 정보. 유형: string - 이름: country 설명: 이벤트가 발생한 국가 코드. 유형: string - 이름: details 설명: 사용자의 로그인을 차단하는 방화벽 규칙과 같은 로그인 시도에 대한 추가 정보. 유형: object 필드: - 이름: value 설명: 로그인 시도의 국가, 대륙 또는 IP 주소 유형: string - 이름: target_user 설명: 로그인 시도를 한 사용자 객체. 유형: object 필드: - name: uuid 설명: 항목에 액세스했거나 계정에 로그인하려고 시도한 사용자의 UUID. 유형: string - 이름: name 설명: 이벤트 생성 시점에 채워진 사용자의 이름. 유형: string - 이름: email 설명: 이벤트 생성 시점에 채워진 사용자의 이메일 주소. 유형: string 지표: - email - name: client 설명: 로그인 시도에 사용된 클라이언트 객체 유형: object 필드: - 이름: app_name 설명: 항목에 액세스한 1Password 앱의 이름. 유형: string - 이름: app_version 설명: 앱의 버전 번호. 유형: string - 이름: platform_name 설명: 항목에 액세스한 플랫폼의 이름. 유형: string - 이름: platform_version 설명: 1Password가 설치된 브라우저 또는 컴퓨터의 버전, 또는 1Password 명령줄 도구가 설치된 컴퓨터의 CPU. 유형: string - 이름: os_name 설명: 항목에 액세스한 운영 체제의 이름. 유형: string - 이름: os_version 설명: 항목에 액세스한 운영 체제의 버전. 유형: string - 이름: ip_address 설명: 항목에 액세스한 IP 주소. 유형: string 지표: - ip - 이름: location 설명: 이벤트가 발생한 위치. 유형: object 필드: - 이름: country 설명: 이벤트가 발생한 국가 코드. 유형: string - 이름: region 설명: 이벤트가 발생한 지역 코드. 유형: string - 이름: city 설명: 이벤트가 발생한 도시 코드. 유형: string - name: longitude 설명: 이벤트가 발생한 위치의 경도. 유형: float - name: latitude 설명: 이벤트가 발생한 위치의 위도. 유형: float ``` ### OnePassword.AuditEvent 이는 활동 로그의 1Password 감사 이벤트입니다. 자세한 내용은 다음을 참조하세요 [1Password Events Reporting 감사 이벤트 문서](https://developer.1password.com/docs/events-api/audit-events/). ```yaml 스키마: OnePassword.AuditEvent 설명: OnePassword 감사 이벤트 참조 URL: https://developer.1password.com/docs/events-api/audit-events/ 필드: - name: uuid 필수: true 설명: 이벤트의 UUID. 유형: string - 이름: timestamp 필수: true 설명: rfc3339 표준 형식의 이벤트 날짜 및 시간. 유형: timestamp 시간 형식: - rfc3339 이벤트 시간 여부: true - 이름: actor_uuid 설명: ActorUUID 필드. 유형: string 지표: - actor_id - 이름: actor_details 설명: 작업을 수행한 팀원의 세부 정보. 유형: object 필드: - name: uuid 설명: 팀원 UUID. 유형: string 지표: - actor_id - 이름: name 설명: 팀원 이름. 유형: string 지표: - username - 이름: email 설명: 팀원 이메일. 유형: string 지표: - email - 이름: action 필수: true 설명: 수행된 작업. 유형: string - 이름: object_type 필수: true 설명: 이벤트의 영향을 받은 객체의 유형. 유형: string - 이름: object_uuid 설명: 이벤트의 영향을 받은 객체의 UUID. 유형: string - 이름: object_details 설명: 이벤트의 영향을 받은 팀원의 세부 정보입니다. 이 속성은 작업의 대상 객체가 팀원인 이벤트에 대해서만 반환됩니다. 유형: object 필드: - name: uuid 설명: 팀원 UUID. 유형: string 지표: - actor_id - 이름: name 설명: 팀원 이름. 유형: string 지표: - username - 이름: email 설명: 팀원 이메일. 유형: string 지표: - email - 이름: aux_id 설명: 활동에 대한 추가 정보의 ID. 유형: bigint - 이름: aux_uuid 설명: 활동에 대한 추가 정보의 UUID. 유형: string - 이름: aux_details 설명: 활동에 대한 추가 정보와 관련된 팀원의 세부 정보입니다. 이 속성은 활동에 대한 추가 정보가 팀원과 관련된 이벤트에 대해서만 반환됩니다. 유형: object 필드: - name: uuid 설명: 팀원 UUID. 유형: string 지표: - actor_id - 이름: name 설명: 팀원 이름. 유형: string 지표: - username - 이름: email 설명: 팀원 이메일. 유형: string 지표: - email - 이름: aux_info 설명: 활동에 대한 추가 정보. 유형: string - 이름: session 설명: 클라이언트에 대해 수집된 세션 정보. 유형: object 필드: - name: uuid 설명: 이벤트를 생성한 세션의 UUID. 유형: string - 이름: login_time 설명: 세션 로그인 날짜 및 시간. 유형: timestamp - 이름: device_uuid 설명: 로그인 기기의 UUID. 유형: string - 이름: ip 설명: 로그인 기기의 IP 주소. 유형: string 지표: - ip - 이름: location 설명: 이벤트가 발생한 위치 객체. 유형: object 필드: - 이름: country 설명: 이벤트가 발생한 국가 코드. 유형: string - 이름: region 설명: 이벤트가 발생한 지역 코드. 유형: string - 이름: city 설명: 이벤트가 발생한 도시 코드. 유형: string - name: longitude 설명: 이벤트가 발생한 위치의 경도. 유형: float - name: latitude 설명: 이벤트가 발생한 위치의 위도. 유형: float ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.panther.com/ko/data-onboarding/supported-logs/1password.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.