Page Comparison

...

The following actions are logged:

Scope	Event / Action	ID (type)
User Authentication	A new login event for a given user.	`authentication`
Pipeline Actions	Start Stop Reset Resume Approve Edit/Change Pipeline Steps Edit/Change Pipeline Settings Create New Pipeline from template Delete Pipeline Duplicate Pipeline Publish Pipeline to Catalog	`pipeline`
Access Token Usage	All uses of a given token are logged	n/a
Tool Registry	Create Tool Edit/Change Tool Attributes or Connection Settings Delete	`registry`

Audit Logs API

The following API’s are available for consuming the audit logs. All Opsera API’s require a valid Access Token.

API Server: https://app.opsera.io

URL

METHOD

DESCRIPTION

DATA

RESPONSE

/api/v1/logs/user/actions

GET

Gets the User Activity Logs for the system. This is a route limited to Site Admins and Power users and requires a token of either API scope or Security Logs scope.

If no date parameter is passed, the last 7 days of logs will be returned (up to a max of 1000 records)

Optional Query Parameters:

?date=YYYY-MM-DD

?type=<value from type field>

Code Block

{
    "count": 6,
    "data": [
        {
            "_id": "61042540e1d666c9ded178c4",
            "user_id": "5e1cbf251c26d68f7ce6361e",
            "user_email": "support@opsera.io",
            "type": "pipeline",
            "action": "update",
            "target_id": "5fbe589a0fae8b021e137534",
            "account": "org-opsera-dnd-acc0",
            "createdAt": "2021-07-30T16:13:52.109Z",
            "updatedAt": "2021-07-30T16:13:52.109Z",
            "__v": 0
        },
  ]
}

/api/v1/logs/user/tokens

GET

Gets the Personal Access Tokens' Activity Logs. This is a route limited to Site Admins and Power users and requires a token of either API scope or Security Logs scope.

If no date parameter is passed, the last 7 days will be returned.(up to a max of 1000 records)

Optional Query Parameters:

?date=YYYY-MM-DD

?scope=<value from scope field>

Code Block

{
    "count": 6,
    "data": [
        {
            "_id": "61057f3a1429a35336563240",
            "token_id": "61043b2bbcb6d95b55adc5fd",
            "scope": "api",
            "target": "/v1/logs/user/tokens",
            "user_id": "5e1cbf251c26d68f7ce6361e",
            "account": "org-opsera-dnd-acc0",
            "createdAt": "2021-07-31T16:50:02.242Z",
            "updatedAt": "2021-07-31T16:50:02.242Z",
            "__v": 0
        },
  ]
}

Data Model

Two data models exist for the Audit Logs: Actions and Tokens. Details on what the fields mean are listed below:

...

Versions Compared

Old Version 6

New Version 7

Key

Audit Logs API

Data Model