|
1 | 1 | [comment]: # "Auto-generated SOAR connector documentation" |
2 | 2 | # Hashicorp Vault |
3 | 3 |
|
4 | | -Publisher: Splunk Community |
5 | | -Connector Version: 1\.1\.0 |
6 | | -Product Vendor: Dallan |
7 | | -Product Name: Hashicorp Vault |
8 | | -Product Version Supported (regex): "\.\*" |
9 | | -Minimum Product Version: 5\.0\.0 |
| 4 | +Publisher: Splunk Community |
| 5 | +Connector Version: 1\.1\.1 |
| 6 | +Product Vendor: Dallan |
| 7 | +Product Name: Hashicorp Vault |
| 8 | +Product Version Supported (regex): "\.\*" |
| 9 | +Minimum Product Version: 5\.0\.0 |
10 | 10 |
|
11 | 11 | This is an app that supports various interactions with the Hashicorp Vault REST API |
12 | 12 |
|
13 | 13 | [comment]: # " File: README.md" |
14 | | -[comment]: # "" |
15 | 14 | [comment]: # " Copyright (c) 2020-2022 Splunk Inc." |
16 | | -[comment]: # "" |
17 | | -[comment]: # " Licensed under the Apache License, Version 2.0 (the \"License\");" |
| 15 | +[comment]: # " Licensed under the Apache License, Version 2.0 (the 'License');" |
18 | 16 | [comment]: # " you may not use this file except in compliance with the License." |
19 | 17 | [comment]: # " You may obtain a copy of the License at" |
20 | 18 | [comment]: # "" |
21 | 19 | [comment]: # " http://www.apache.org/licenses/LICENSE-2.0" |
22 | | -[comment]: # "" |
23 | 20 | [comment]: # " Unless required by applicable law or agreed to in writing, software distributed under" |
24 | | -[comment]: # " the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND," |
| 21 | +[comment]: # " the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND," |
25 | 22 | [comment]: # " either express or implied. See the License for the specific language governing permissions" |
26 | 23 | [comment]: # " and limitations under the License." |
27 | 24 | [comment]: # "" |
| 25 | +## Port Information |
28 | 26 |
|
29 | | -**Port Information** |
30 | | -* The app uses HTTP/ HTTPS protocol for communicating with the Hashicorp Vault server. Below are the default ports used by the Splunk SOAR Connector. |
| 27 | +The app uses HTTP/ HTTPS protocol for communicating with the Hashicorp Vault server. Below are the |
| 28 | +default ports used by the Splunk SOAR Connector. |
| 29 | + |
| 30 | +| SERVICE NAME | TRANSPORT PROTOCOL | PORT | |
| 31 | +|--------------|--------------------|------| |
| 32 | +| http | tcp | 80 | |
| 33 | +| https | tcp | 443 | |
31 | 34 |
|
32 | | - SERVICE NAME | TRANSPORT PROTOCOL | PORT |
33 | | - ------------ | ------------------ | ---- |
34 | | - http | tcp | 80 |
35 | | - https | tcp | 443 |
36 | 35 |
|
37 | 36 | ### Configuration Variables |
38 | 37 | The below configuration variables are required for this Connector to operate. These variables are specified when configuring a Hashicorp Vault asset in SOAR. |
39 | 38 |
|
40 | 39 | VARIABLE | REQUIRED | TYPE | DESCRIPTION |
41 | 40 | -------- | -------- | ---- | ----------- |
42 | | -**verify\_server\_cert** | required | boolean | Verify server certificate |
| 41 | +**verify\_server\_cert** | optional | boolean | Verify server certificate |
43 | 42 | **vault\_url** | required | string | URL of the Hashicorp Vault instance |
44 | 43 | **vault\_mountpoint** | required | string | Vault mountpoint to connect with |
45 | | -**vault\_token** | required | password | Token used to authenticate requests to Hashicorp Vault |
| 44 | +**vault\_token** | required | password | Token used to authenticate requests to Hashicorp Vault when using token authentication |
46 | 45 | **vault\_namespace** | optional | string | Vault Namespace |
47 | 46 | **vault\_role\_id** | optional | password | Role ID if using AppRole authentication |
48 | 47 | **vault\_secret\_id** | optional | password | Secret ID if using AppRole authentication |
49 | 48 |
|
50 | | - |
51 | | -### Supported Actions |
52 | | -[test connectivity](#action-test-connectivity) - Validate the asset configuration for connectivity using supplied credentials |
53 | | -[set secret](#action-set-secret) - Set secret value at the specified path |
54 | | -[get secret](#action-get-secret) - Get secret value present at the specified path |
55 | | -[list secrets](#action-list-secrets) - List secret values present at the specified path |
| 49 | +### Supported Actions |
| 50 | +[test connectivity](#action-test-connectivity) - Validate the asset configuration for connectivity using supplied credentials |
| 51 | +[set secret](#action-set-secret) - Set secret value at the specified path |
| 52 | +[get secret](#action-get-secret) - Get secret value present at the specified path |
| 53 | +[list secrets](#action-list-secrets) - List secret values present at the specified path |
56 | 54 |
|
57 | 55 | ## action: 'test connectivity' |
58 | 56 | Validate the asset configuration for connectivity using supplied credentials |
59 | 57 |
|
60 | | -Type: **test** |
| 58 | +Type: **test** |
61 | 59 | Read only: **True** |
62 | 60 |
|
63 | 61 | #### Action Parameters |
64 | 62 | No parameters are required for this action |
65 | 63 |
|
66 | 64 | #### Action Output |
67 | | -No Output |
| 65 | +No Output |
68 | 66 |
|
69 | 67 | ## action: 'set secret' |
70 | 68 | Set secret value at the specified path |
71 | 69 |
|
72 | | -Type: **generic** |
| 70 | +Type: **generic** |
73 | 71 | Read only: **False** |
74 | 72 |
|
75 | 73 | #### Action Parameters |
76 | 74 | PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS |
77 | 75 | --------- | -------- | ----------- | ---- | -------- |
78 | | -**location** | required | Location to keep the secret value | string | `hashicorp vault location` |
79 | | -**update** | required | Update secret value if already exists | boolean | |
80 | | -**secret\_json** | required | JSON formatted object of dictionary to store at the given location | string | |
| 76 | +**location** | required | Location to keep the secret value | string | `hashicorp vault location` |
| 77 | +**update** | optional | Update secret value if already exists | boolean | |
| 78 | +**secret\_json** | required | JSON formatted object of dictionary to store at the given location | string | |
81 | 79 |
|
82 | 80 | #### Action Output |
83 | 81 | DATA PATH | TYPE | CONTAINS |
84 | 82 | --------- | ---- | -------- |
85 | | -action\_result\.parameter\.location | string | `hashicorp vault location` |
86 | | -action\_result\.parameter\.update | boolean | |
87 | | -action\_result\.parameter\.secret\_json | string | |
88 | | -action\_result\.data\.\*\.succeeded | boolean | |
89 | | -action\_result\.status | string | |
90 | | -action\_result\.message | string | |
91 | | -action\_result\.summary | string | |
92 | | -summary\.total\_objects | numeric | |
93 | | -summary\.total\_objects\_successful | numeric | |
| 83 | +action\_result\.parameter\.location | string | `hashicorp vault location` |
| 84 | +action\_result\.parameter\.secret\_json | string | |
| 85 | +action\_result\.parameter\.update | boolean | |
| 86 | +action\_result\.data\.\*\.succeeded | boolean | |
| 87 | +action\_result\.status | string | |
| 88 | +action\_result\.summary | string | |
| 89 | +action\_result\.message | string | |
| 90 | +summary\.total\_objects | numeric | |
| 91 | +summary\.total\_objects\_successful | numeric | |
94 | 92 |
|
95 | 93 | ## action: 'get secret' |
96 | 94 | Get secret value present at the specified path |
97 | 95 |
|
98 | | -Type: **investigate** |
| 96 | +Type: **investigate** |
99 | 97 | Read only: **True** |
100 | 98 |
|
101 | 99 | #### Action Parameters |
102 | 100 | PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS |
103 | 101 | --------- | -------- | ----------- | ---- | -------- |
104 | | -**location** | required | Location of the secret value | string | `hashicorp vault location` |
| 102 | +**location** | required | Location of the secret value | string | `hashicorp vault location` |
105 | 103 |
|
106 | 104 | #### Action Output |
107 | 105 | DATA PATH | TYPE | CONTAINS |
108 | 106 | --------- | ---- | -------- |
109 | | -action\_result\.parameter\.location | string | `hashicorp vault location` |
110 | | -action\_result\.data\.\*\.secret\_value | string | |
111 | | -action\_result\.data\.\*\.succeeded | boolean | |
112 | | -action\_result\.status | string | |
113 | | -action\_result\.message | string | |
114 | | -action\_result\.summary | string | |
115 | | -summary\.total\_objects | numeric | |
116 | | -summary\.total\_objects\_successful | numeric | |
| 107 | +action\_result\.parameter\.location | string | `hashicorp vault location` |
| 108 | +action\_result\.data\.\*\.secret\_value | string | |
| 109 | +action\_result\.data\.\*\.succeeded | boolean | |
| 110 | +action\_result\.status | string | |
| 111 | +action\_result\.summary | string | |
| 112 | +action\_result\.message | string | |
| 113 | +summary\.total\_objects | numeric | |
| 114 | +summary\.total\_objects\_successful | numeric | |
117 | 115 |
|
118 | 116 | ## action: 'list secrets' |
119 | 117 | List secret values present at the specified path |
120 | 118 |
|
121 | | -Type: **investigate** |
| 119 | +Type: **investigate** |
122 | 120 | Read only: **True** |
123 | 121 |
|
124 | 122 | #### Action Parameters |
125 | 123 | PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS |
126 | 124 | --------- | -------- | ----------- | ---- | -------- |
127 | | -**location** | required | Location of the secret values | string | `hashicorp vault location` |
| 125 | +**location** | required | Location of the secret values | string | `hashicorp vault location` |
128 | 126 |
|
129 | 127 | #### Action Output |
130 | 128 | DATA PATH | TYPE | CONTAINS |
131 | 129 | --------- | ---- | -------- |
132 | | -action\_result\.parameter\.location | string | `hashicorp vault location` |
133 | | -action\_result\.data\.\*\.secret\_values | string | |
134 | | -action\_result\.data\.\*\.succeeded | boolean | |
135 | | -action\_result\.status | string | |
136 | | -action\_result\.message | string | |
137 | | -action\_result\.summary | string | |
138 | | -summary\.total\_objects | numeric | |
139 | | -summary\.total\_objects\_successful | numeric | |
| 130 | +action\_result\.parameter\.location | string | `hashicorp vault location` |
| 131 | +action\_result\.data\.\*\.secret\_values | string | |
| 132 | +action\_result\.data\.\*\.succeeded | boolean | |
| 133 | +action\_result\.status | string | |
| 134 | +action\_result\.summary | string | |
| 135 | +action\_result\.message | string | |
| 136 | +summary\.total\_objects | numeric | |
| 137 | +summary\.total\_objects\_successful | numeric | |
0 commit comments