{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Opsera provides audit logging for key operations in the platform. These logs can be accessed via the Opsera API. ","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"2e75a1e9-66e7-4981-b3c5-be5c146efbc8"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"0f3871ea-1185-42c9-ab09-50b2216534ef"}},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The user account used to generate the token is the one associated with the token. They are the owner of that token and as such any API call they use it against will validate their Roles and Access before allowing the action to proceed. T","type":"text"},{"text":"o access Audit Logs, the user MUST have the Power User role in the Opsera Platform","type":"text","marks":[{"type":"strong"}]},{"text":", setup via ","type":"text"},{"text":"Group Management","type":"text","marks":[{"type":"link","attrs":{"href":"https://opsera.atlassian.net/wiki/spaces/OE/pages/1330970654/Role+Based+Access+-+Pipelines+Tool+Registry#Group-Management"}}]},{"text":".","type":"text"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Audit Scope","type":"text"}]},{"type":"paragraph","content":[{"text":"The following actions are logged:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"2de58329-ac24-4f71-ab6f-9a8b6628c708"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Scope","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"Event / Action","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"ID (type)","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"User Authentication","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"A new login event for a given user. ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"authentication","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Pipeline Actions","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reset","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resume","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Approve","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Denial","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit/Change Pipeline Steps","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit/Change Pipeline Settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create New Pipeline from template","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete Pipeline","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Duplicate Pipeline","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Publish Pipeline to Catalog","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Webhook-Start","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"pipeline","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Access Token Usage","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"All uses of a given token are logged","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"n/a","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Tool Registry","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create Tool","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit/Change Tool Attributes or Connection Settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"registry","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Analytics Data Entries","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"analytics_data_entry","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Analytics Data Mapping: Organization","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"analytics_data_mapping_organization","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Analytics Data Mapping: Project","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"analytics_data_mapping_project","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Analytics Data Mapping: User","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"analytics_data_mapping_user","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Feature Flags","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"feature_flags","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Notification Policy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"notification_policy","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Pipeline Template","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deploy","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ownership Transfer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit Access Roles","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"pipeline_template","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Instructions","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"instructions","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Policy","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"policy","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Tag","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"tag","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[254.0]},"content":[{"type":"paragraph","content":[{"text":"Task","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[253.0]},"content":[{"type":"paragraph","content":[{"text":"task","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Audit Logs API","type":"text"}]},{"type":"paragraph","content":[{"text":"The following API’s are available for consuming the audit logs. All Opsera API’s require a valid ","type":"text"},{"text":"Access Token","type":"text","marks":[{"type":"link","attrs":{"href":"https://opsera.atlassian.net/wiki/spaces/OE/pages/1460961698/Managing+Personal+Access+Tokens"}}]},{"text":" with either ","type":"text"},{"text":"API Access OR Security Logs (Read Only)","type":"text","marks":[{"type":"code"}]},{"text":"scope.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: Dates are in UTC.","type":"text"}]},{"type":"paragraph","content":[{"text":"API Server*: ","type":"text","marks":[{"type":"strong"}]},{"text":"https://app.opsera.io","type":"text","marks":[{"type":"link","attrs":{"href":"https://app.opsera.io"}}]}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"1cbff409-301b-433f-add5-bb60756b6e1d"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"URL","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"METHOD","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"DESCRIPTION","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"Scope","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"DATA","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"RESPONSE","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"/api/v1/logs/user/actions","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no date parameter is passed, the last 7 days of logs will be returned (up to a max of 1000 records)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"API Access","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Security Logs (Read Only)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Optional Query Parameters:","type":"text"}]},{"type":"paragraph","content":[{"text":"?date=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?start=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]},{"text":" & ","type":"text"},{"text":"?end=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?type=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?count=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?range=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"*","type":"text"},{"text":"supported timescale characters","type":"text","marks":[{"type":"strong"}]},{"text":" =","type":"text"}]},{"type":"paragraph","content":[{"text":"s(seconds): 30 seconds = “30s”","type":"text"}]},{"type":"paragraph","content":[{"text":"m(minutes): 13 minutes = “13m”","type":"text"}]},{"type":"paragraph","content":[{"text":"h(hours): 1 hour = “1h”","type":"text"}]},{"type":"paragraph","content":[{"text":"d(days): 3 days = “3d”","type":"text"}]},{"type":"paragraph","content":[{"text":"w(weeks): 2 weeks = “2w”","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"count\": 6,\n \"data\": [\n {\n \"_id\": \"61042540e1d666c9ded178c4\",\n \"user_id\": \"5e1cbf251c26d68f7ce6361e\",\n \"user_email\": \"support@opsera.io\",\n \"type\": \"pipeline\",\n \"action\": \"update\",\n \"target_id\": \"5fbe589a0fae8b021e137534\",\n \"account\": \"org-opsera-dnd-acc0\",\n \"createdAt\": \"2021-07-30T16:13:52.109Z\",\n \"updatedAt\": \"2021-07-30T16:13:52.109Z\",\n \"__v\": 0\n },\n ]\n}","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"/api/v2/logs/audit/user","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Gets the User Activity Logs for the system. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a route limited to Site Administrators, Power Users, Auditors, Security Managers.","type":"text"}]},{"type":"paragraph","content":[{"text":"It requires a token of either API scope or Security Logs scope.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"API Access","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"API Access","type":"text","marks":[{"type":"code"}]},{"text":" (Read only)","type":"text"}]},{"type":"paragraph","content":[{"text":"Security Logs (Read Only)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Optional Query Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"?start_date=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"?start_time=HH:MM:SS (start date is required)","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"?end_date=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?end_time=HH:MM:SS (end date is required)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"page= current page","type":"text"}]},{"type":"paragraph","content":[{"text":"page_size= page size (max is 1000)","type":"text"}]},{"type":"paragraph","content":[{"text":"action= various actions","type":"text"}]},{"type":"paragraph","content":[{"text":"type= item type (pipeline, registry, etc)","type":"text"}]},{"type":"paragraph","content":[{"text":"user_id= mongo user ID","type":"text"}]},{"type":"paragraph","content":[{"text":"user_email= email address","type":"text"}]},{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"/api/v1/logs/user/tokens","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no date parameter is passed, the last 7 days will be returned.(up to a max of 1000 records)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"API Access","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Security Logs (Read Only)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Optional Query Parameters:","type":"text"}]},{"type":"paragraph","content":[{"text":"?date=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?scope=","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"count\": 6,\n \"data\": [\n {\n \"_id\": \"61057f3a1429a35336563240\",\n \"token_id\": \"61043b2bbcb6d95b55adc5fd\",\n \"scope\": \"api\",\n \"target\": \"/v1/logs/user/tokens\",\n \"user_id\": \"5e1cbf251c26d68f7ce6361e\",\n \"account\": \"org-opsera-dnd-acc0\",\n \"createdAt\": \"2021-07-31T16:50:02.242Z\",\n \"updatedAt\": \"2021-07-31T16:50:02.242Z\",\n \"__v\": 0\n },\n ]\n}","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[201.0]},"content":[{"type":"paragraph","content":[{"text":"/api/v1/logs/pipelines","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[69.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Gets the Pipeline 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.","type":"text"}]},{"type":"paragraph","content":[{"text":"If no date parameter is passed, all logs will be returned (up to a max of 1000 records).","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[86.0]},"content":[{"type":"paragraph","content":[{"text":"API Access","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Security Logs (Read Only)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[242.0]},"content":[{"type":"paragraph","content":[{"text":"Optional Query Parameters","type":"text"}]},{"type":"paragraph","content":[{"text":"?date=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?start=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]},{"text":" & ","type":"text"},{"text":"?end=YYYY-MM-DD","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?type=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?count=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"?range=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"*","type":"text"},{"text":"supported timescale characters","type":"text","marks":[{"type":"strong"}]},{"text":" =","type":"text"}]},{"type":"paragraph","content":[{"text":"s(seconds): 30 seconds = “30s”","type":"text"}]},{"type":"paragraph","content":[{"text":"m(minutes): 13 minutes = “13m”","type":"text"}]},{"type":"paragraph","content":[{"text":"h(hours): 1 hour = “1h”","type":"text"}]},{"type":"paragraph","content":[{"text":"d(days): 3 days = “3d”","type":"text"}]},{"type":"paragraph","content":[{"text":"w(weeks): 2 weeks = “2w”","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"count\": 223773,\n \"data\": [\n {\n \"_id\": \"627a9c44621d7e001d743568\",\n \"user_id\": \"60157c8c70628140f776e359\",\n \"pipeline_id\": \"611e7dca57f4eff66e9db084\",\n \"tool_identifier\": \"consumer.response\",\n \"step_id\": \"611508513ce36642d3180dc8\",\n \"step_index\": 2,\n \"step_name\": \"anchore\",\n \"step_configuration\": {\n \"tool\": \"event based automation\",\n \"topic\": \"opsera.pipeline.response\"\n },\n \"action\": \"start confirmation\",\n \"api_response\": {\n \"pipelineId\": \"611e7dca57f4eff66e9db084\",\n \"customerId\": \"60157c8c70628140f776e359\",\n \"stepId\": \"611508513ce36642d3180dc8\",\n \"message\": \"Anchore Scan Started Successfully\",\n \"status\": \"analyzing\",\n \"runCount\": 174,\n \"stepIdentifier\": \"anchore-integrator\"\n },\n \"message\": \"Anchore Scan Started Successfully\",\n \"status\": \"analyzing\",\n \"run_count\": 174,\n \"createdAt\": \"2022-05-10T17:09:24.080Z\",\n \"updatedAt\": \"2022-05-10T17:09:24.080Z\",\n \"__v\": 0\n }\n ]\n}","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"*Please note, if a customer is running in their own tenant, the API URL would be different. Please contact Opsera to get your unique API URL.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Data Model","type":"text"}]},{"type":"paragraph","content":[{"text":"Two data models exist for the Audit Logs: Actions and Tokens. Details on what the fields mean are listed below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":547,"id":"17dcf2a8-96b0-446b-93a1-b3bd80fb3d2d","collection":"contentId-1454244409","type":"file","height":238}},{"type":"caption","content":[{"text":"Actions Audit Log","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"{\n \"user_id\": Opsera User ID,\n \"user_email\": Email Address associated with Opsera Account,\n \"type\": Maps to the area of Opsera the record is from (see above table),\n \"action\": Action being logged (see above table),\n \"target_id\": Opsera ID of object aciton is taken on, maps to type,\n \"createdAt\": Date action occured,\n }","type":"text"}]},{"type":"rule"},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":463,"id":"565dcd5a-a3fe-493d-a367-be1f21804f81","collection":"contentId-1454244409","type":"file","height":225}},{"type":"caption","content":[{"text":"Access Token Audit Log","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"{\n \"token_id\": Opsera ID of token used,\n \"scope\": Scope of token,\n \"target\": Relative URL target of API call,\n \"user_id\": Opsera User ID,\n \"createdAt\": Date action occured,\n }","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported