grove.connectors.onepassword package

1Password connectors for Grove.

Submodules

grove.connectors.onepassword.api module

1Password Audit API client.

class grove.connectors.onepassword.api.Client(hostname: str | None = 'events.1password.com', token: str | None = None, retry: bool | None = True)[source]

Bases: object

get_auditevents(cursor: str | None = None, start_time: str | None = None) AuditLogEntries[source]

Fetches a list of actions performed by members of a 1Password account.

Parameters:
  • cursor – Cursor to use when fetching results. Supersedes other parameters.

  • start_time – The ISO Format timestamp to query logs since.

Returns:

AuditLogEntries object containing a pagination cursor, and log entries.

get_events(event_type: str, cursor: str | None = None, start_time: str | None = None) AuditLogEntries[source]

Returns a list of logs from a specified endpoint.

Parameters:
  • event_type – The API endpoint name and type of logs we’re pulling.

  • cursor – Cursor to use when fetching results. Supersedes other parameters.

  • start_time – The ISO Format timestamp to query logs since.

Returns:

AuditLogEntries object containing a pagination cursor, and log entries.

get_itemusages(cursor: str | None = None, start_time: str | None = None) AuditLogEntries[source]

Fetches a list of modified, accessed, or used items from a shared vault.

Parameters:
  • cursor – Cursor to use when fetching results. Supersedes other parameters.

  • start_time – The ISO Format timestamp to query logs since.

Returns:

AuditLogEntries object containing a pagination cursor, and log entries.

get_signinattempts(cursor: str | None = None, start_time: str | None = None) AuditLogEntries[source]

Fetches a list of signing attempt logs.

Parameters:
  • cursor – Cursor to use when fetching results. Supersedes other parameters.

  • start_time – The ISO Format timestamp to query logs since.

Returns:

AuditLogEntries object containing a pagination cursor, and log entries.

grove.connectors.onepassword.events_audit module

1Password Audit event log connector for Grove.

class grove.connectors.onepassword.events_audit.Connector(config: ConnectorConfig, context: Dict[str, str])[source]

Bases: BaseConnector

LOG_ORDER = 'CHRONOLOGICAL'
NAME = 'onepassword_events_audit'
POINTER_PATH = 'timestamp'
collect()[source]

Collects all logs from the 1Password audit event log API.

This will first check whether there are any pointers cached to indicate previous collections. If not, the last week of data will be collected.

grove.connectors.onepassword.events_itemusages module

1Password ItemUsage event log connector for Grove.

class grove.connectors.onepassword.events_itemusages.Connector(config: ConnectorConfig, context: Dict[str, str])[source]

Bases: BaseConnector

LOG_ORDER = 'CHRONOLOGICAL'
NAME = 'onepassword_events_itemusages'
POINTER_PATH = 'timestamp'
collect()[source]

Collects all logs from the 1Password itemusage event log API.

This will first check whether there are any pointers cached to indicate previous collections. If not, the last week of data will be collected.

grove.connectors.onepassword.events_signinattempts module

1Password Signin Attempt event log connector for Grove.

class grove.connectors.onepassword.events_signinattempts.Connector(config: ConnectorConfig, context: Dict[str, str])[source]

Bases: BaseConnector

LOG_ORDER = 'CHRONOLOGICAL'
NAME = 'onepassword_events_signinattempts'
POINTER_PATH = 'timestamp'
collect()[source]

Collects all logs from the 1Password signin event log API.

This will first check whether there are any pointers cached to indicate previous collections. If not, the last week of data will be collected.