Commit graph

66 commits

Author SHA1 Message Date
Lisa Cawley
78e887884c
[DOCS] Move preconfigured Tines connector details (#166217)
Co-authored-by: Ying Mao <ying.mao@elastic.co>
2023-09-25 17:58:53 -07:00
Lisa Cawley
e74ec69a0f
[DOCS] Move preconfigured Torq connector details (#166218) 2023-09-25 08:55:25 -07:00
Lisa Cawley
82024c240a
[OAS] Add defaultModel to generative AI connector (#166394) 2023-09-20 11:39:08 -07:00
Lisa Cawley
ef020b293f
[DOCS] Add preconfigured webhook connector settings (#166289) 2023-09-14 11:26:21 -07:00
Lisa Cawley
91d0d7096a
[DOCS] Move preconfigured email connector details (#165181) 2023-09-14 07:59:53 -07:00
Lisa Cawley
0f1b5a23e1
[DOCS] Move preconfigured D3 Security connector details (#166112)
Co-authored-by: Ying Mao <ying.mao@elastic.co>
2023-09-12 10:17:53 -07:00
Lisa Cawley
127d4dfce7
[DOCS] Move preconfigured Microsoft Teams connector details (#166119) 2023-09-11 16:14:09 -07:00
Lisa Cawley
7267efec49
[DOCS] Move preconfigured xMatters connector details (#165923) 2023-09-11 14:25:16 -07:00
Lisa Cawley
977d7f8628
[DOCS] Move preconfigured PagerDuty connector details (#165361) 2023-09-06 14:39:40 -07:00
Lisa Cawley
9b963bfe33
[DOCS] Move preconfigured index connector details (#165277) 2023-09-05 18:32:50 -07:00
Xavier Mouligneau
cb9797500a
[RAM] update api key to become public (#164883)
## Summary

[Summarize your PR. If it involves visual changes include a screenshot
or gif.](https://github.com/elastic/enhancements/issues/17998)


### Checklist

- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-08-28 13:25:48 -04:00
Lisa Cawley
4686472f9e
[DOCS] Add Webhook connector SSL authentication configuration details (#163983) 2023-08-23 11:45:08 -07:00
Lisa Cawley
6cf859887d
[OAS] Add Webhook connector configuration details (#163899) 2023-08-22 10:27:35 -07:00
Lisa Cawley
c1d2834f1a
[OAS] Remove redundant connector properties (#163987) 2023-08-21 09:29:08 -07:00
Lisa Cawley
5c1d118c36
[OAS] Add is_system_action to connector responses (#163969) 2023-08-17 13:13:35 -07:00
Lisa Cawley
bc9d601feb
[OAS] Clarify rule action descriptions (#162199) 2023-08-08 07:31:46 -07:00
Janki Salvi
c0cb6133ea
[Cases] Update docs for remaining guardrails (#162492)
## Summary

Connected to https://github.com/elastic/kibana/issues/146945

This PR updates API docs for 

Description | Limit | Done? | Documented? | UI?
-- | -- | -- | -- | --
Total assignees per case | 10 |  | Yes | 
Maximum number of cases/user actions/comments returned from the API |
10.000 |  | Yes | N/A
Total number of cases by alert ID returned from the API | 10.000 |  |
Yes | N/A
Total number of tags returned from the API | 10.000 |  | Yes | N/A
Total number of reporters returned from the API | 10.000 |  | Yes | N/A

### Checklist

Delete any items that are not applicable to this PR.

- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials

### For maintainers

- [x] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-07-26 12:29:38 +02:00
Lisa Cawley
a811538ee8
[OAS] Add Elasticsearch query rule parameters (#162001) 2023-07-19 10:46:39 -07:00
Alexi Doak
622d994584
[ResponseOps][Alerting] Add missing rule.params descriptions for Stack rules (#161807)
Resolves https://github.com/elastic/kibana/issues/161710

## Summary

Related to this issue: https://github.com/elastic/kibana/issues/161126

Added missing descriptions for the index threshold rule params.


### Checklist

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: Ying Mao <ying.mao@elastic.co>
2023-07-19 08:15:17 -04:00
Lisa Cawley
3a0c90d934
[DOCS] Clarify API key authorization for alerting (#161717) 2023-07-17 09:41:23 -07:00
Antonio
f43601d294
[Cases] Validate page and perPage parameters in find APIs (#161111)
Connected to https://github.com/elastic/kibana/issues/146945

## Summary

| Description  | Limit | Done? | Documented?
| ------------- | ---- | :---: | ---- |
| Total number of cases/user actions/comments per page | 100 |
 | No | N/A |
| Maximum number of cases/user actions/comments returned from the API |
10.000 |  | No | N/A |

### Checklist

Delete any items that are not applicable to this PR.

- [x] Any text added follows [EUI's writing
guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses
sentence case text and includes [i18n
support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md)
- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

### Release Notes

Max value for perPage parameter in find Cases API is now 100.
Max value for perPage parameter in find User Actions API is now 100.
Max value for perPage parameter in find Comments API is now 100.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-07-05 13:33:09 +02:00
Lisa Cawley
8a1902c66e
[OAS] Add default spaces to case paths (#160831) 2023-06-29 08:41:58 -07:00
Lisa Cawley
418fbb1aa6
[Security solution] Generative AI Connector API specification (#158423)
Co-authored-by: Steph Milovic <stephanie.milovic@elastic.co>
2023-06-27 15:03:36 -07:00
Lisa Cawley
e38d08c91a
[DOCS] Fix create rule open API specification (#157950) 2023-06-26 07:39:11 -07:00
Janki Salvi
de3f8fca00
[Cases] Limit perPage param in findComments API (#160042)
## Summary

This PR limits `perPage` param to 100 in `findComments`  API.

### Checklist

- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-06-21 15:00:25 +02:00
Antonio
599e2311a6
[Cases] Limit category filter in find cases API (#159989)
## Summary

This PR limits the number of categories by which we can filter calls to
the find cases API.

The limit is now 100.

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-06-21 09:09:07 +02:00
Julian Gernun
53465943b0
[RAM] [Docs] Add rule type param references (#159186)
## Summary

Links param parameter OAS to alerting rules documentation

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-06-19 12:37:01 +02:00
Lisa Cawley
b6a2611361
[DOCS] Conditional actions in rule open API specifications (#157951) 2023-06-09 08:33:43 -07:00
Lisa Cawley
2795ac894b
[DOCS] Add revision to alerts schema (#157938) 2023-05-18 11:42:14 -07:00
Lisa Cawley
1cb0ee6d72
[DOCS] Add UUID to rule actions (#157942) 2023-05-17 18:43:20 -07:00
Lisa Cawley
60513d3fe9
[DOCS] Add api_key_created_by_user to alerting API specification (#158018) 2023-05-17 15:02:40 -07:00
Antonio
927743ae52
[Cases] Restrict the Find Comment API query params (#156863)
Fixes #155983

## Summary

This PR changes the accepted params for the Find Comments API to be only
`perPage`, `page` and `sort_order`.

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-05-16 09:25:54 -07:00
Antonio
2e0ba63e31
[Cases] Limit searchFields in the Find Case API query params (#156495)
Fixes #155978

## Summary

- Remove the `fields` parameter from the find cases API 
- Limit the `searchFields` parameter in the find cases API

One of the FTR tests was actually successfully calling the find_cases
API while passing the fields parameter but only certain combinations of
fields would actually work.

Passing single fields would not work.

I just removed the test as we won't support the `fields` param anymore.

---------

Co-authored-by: lcawl <lcawley@elastic.co>
2023-05-11 11:04:10 -04:00
Lisa Cawley
f7a3462808
[DOCS] Fix optional create connector id (#157031) 2023-05-09 07:20:30 -07:00
Lisa Cawley
d14ba925dd
[DOCS] Fix Slack connector open API specifications (#157026) 2023-05-08 11:50:32 -07:00
Julia
4dd6d1a277
[RAM] Docs for slack improvements (#153885)
## Summary

Docs for new Slack connector

### Preview


https://kibana_153885.docs-preview.app.elstc.co/guide/en/kibana/master/slack-action-type.html

---------

Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2023-05-05 09:32:45 +02:00
Mike Côté
5a4dd3fccd
Remove alerting_framework_heath from the alerting framework health API response (#154276)
Resolves https://github.com/elastic/kibana/issues/135035.

In this PR, I'm removing the deprecated attribute
`alerting_framework_heath` from the alerting framework health API.

## To verify

1. Start Kibana.
2. Call `/api/alerting/_health`.
3. Notice `alerting_framework_heath` is no longer part of the HTTP API
response.

---------

Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-04-20 07:16:27 -04:00
Lisa Cawley
782a3d5e42
[DOCS] Add responses components in connector open API specification (#153136) 2023-03-28 19:28:43 -07:00
Lisa Cawley
b75b272a88
[DOCS] Add deprecation details to case APIs (#152033) 2023-02-28 18:17:02 +01:00
Lisa Cawley
903173dff1
[DOCS] Add summary capabilities to the open API specification (#149998) 2023-02-08 08:30:14 -08:00
Lisa Cawley
83c382b088
[DOCS] Add specifications for deprecated connector APIs (#149637) 2023-02-02 07:22:32 -08:00
Lisa Cawley
59488afa5d
[DOCS] Add specifications for deprecated alert APIs (#149655) 2023-02-02 07:21:43 -08:00
Lisa Cawley
502fb009cf
[DOCS] Lint case API specifications (#149641) 2023-01-31 12:01:00 -08:00
Lisa Cawley
7421a9737d
[DOCS] Create open API specification for create rule (#149565) 2023-01-26 18:07:23 -08:00
Lisa Cawley
f78236a2e4
[DOCS] Create open API specification for run connector (#149274) 2023-01-26 08:53:47 -08:00
Jonathan Buttner
a78fece18b
[Cases] Adding _find API for user actions (#148861)
This PR adds a new find API for retrieving a subset of the user actions
for a case.

Issue: https://github.com/elastic/kibana/issues/134344

```
GET /api/cases/<case_id>/user_actions/_find
Query Paramaters
{
  types?: Array of "assignees" | "comment" | "connector" | "description" | "pushed" | "tags" | "title" | "status" | "settings" | "severity" | "create_case" | "delete_case" | "action" | "alert" | "user" | "attachment"
  sortOrder?: "asc" | "desc"
  page?: number as a string
  perPage?: number as a string
}
```

<details><summary>Example request and response</summary>

Request
```
curl --location --request GET 'http://localhost:5601/api/cases/8df5fe00-96b1-11ed-9341-471c9630b5ec/user_actions/_find?types=create_case&sortOrder=asc' \
--header 'kbn-xsrf: hello' \
--header 'Authorization: Basic ZWxhc3RpYzpjaGFuZ2VtZQ==' \
--data-raw ''
```


Response
```
{
    "userActions": [
        {
            "created_at": "2023-01-17T21:54:45.527Z",
            "created_by": {
                "username": "elastic",
                "full_name": null,
                "email": null,
                "profile_uid": "u_mGBROF_q5bmFCATbLXAcCwKa0k8JvONAwSruelyKA5E_0"
            },
            "owner": "cases",
            "action": "create",
            "payload": {
                "title": "Awesome case",
                "tags": [],
                "severity": "low",
                "description": "super",
                "assignees": [],
                "connector": {
                    "name": "none",
                    "type": ".none",
                    "fields": null,
                    "id": "none"
                },
                "settings": {
                    "syncAlerts": false
                },
                "owner": "cases",
                "status": "open"
            },
            "type": "create_case",
            "id": "8e121180-96b1-11ed-9341-471c9630b5ec",
            "case_id": "8df5fe00-96b1-11ed-9341-471c9630b5ec",
            "comment_id": null
        }
    ],
    "page": 1,
    "perPage": 20,
    "total": 1
}
```

</details>

## Notable Changes
- Created the new `_find` route
- Created a new `UserActionFinder` class and moved the find* methods
from the `index.ts` file into there as well as the new find logic
- Extracted the transform logic to its own file since its shared between
multiple files now
- Extracted the user action related integration test functions to the
`user_action.ts` utility file

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
Co-authored-by: lcawl <lcawley@elastic.co>
2023-01-23 13:25:41 -05:00
Lisa Cawley
fa68cb432b
[DOCS] Create OAS for get rule types and get alerting framework health (#148774) 2023-01-17 10:53:48 -07:00
Lisa Cawley
4f6d0dff28
[DOCS] Create open API specification for create/update connector (#148691) 2023-01-17 10:31:48 -07:00
Lisa Cawley
9e837b80dc
[DOCS] Add 401 responses to case API specifications (#148857) 2023-01-17 09:20:51 -07:00
Lisa Cawley
b174b1908f
[DOCS] Lint ML sync API specification (#148841) 2023-01-13 08:44:07 -08:00