| @@ 52-184 (lines=133) @@ | ||
| 49 | cmd.add_element("copy", audit_id) |
|
| 50 | return self._send_xml_command(cmd) |
|
| 51 | ||
| 52 | def create_audit( |
|
| 53 | self, |
|
| 54 | name: str, |
|
| 55 | policy_id: str, |
|
| 56 | target_id: str, |
|
| 57 | scanner_id: str, |
|
| 58 | *, |
|
| 59 | alterable: Optional[bool] = None, |
|
| 60 | hosts_ordering: Optional[HostsOrdering] = None, |
|
| 61 | schedule_id: Optional[str] = None, |
|
| 62 | alert_ids: Optional[List[str]] = None, |
|
| 63 | comment: Optional[str] = None, |
|
| 64 | schedule_periods: Optional[int] = None, |
|
| 65 | observers: Optional[List[str]] = None, |
|
| 66 | preferences: Optional[dict] = None, |
|
| 67 | ) -> Any: |
|
| 68 | """Create a new audit task |
|
| 69 | ||
| 70 | Arguments: |
|
| 71 | name: Name of the new audit |
|
| 72 | policy_id: UUID of policy to use by the audit |
|
| 73 | target_id: UUID of target to be scanned |
|
| 74 | scanner_id: UUID of scanner to use for scanning the target |
|
| 75 | comment: Comment for the audit |
|
| 76 | alterable: Whether the task should be alterable |
|
| 77 | alert_ids: List of UUIDs for alerts to be applied to the audit |
|
| 78 | hosts_ordering: The order hosts are scanned in |
|
| 79 | schedule_id: UUID of a schedule when the audit should be run. |
|
| 80 | schedule_periods: A limit to the number of times the audit will be |
|
| 81 | scheduled, or 0 for no limit |
|
| 82 | observers: List of names or ids of users which should be allowed to |
|
| 83 | observe this audit |
|
| 84 | preferences: Name/Value pairs of scanner preferences. |
|
| 85 | ||
| 86 | Returns: |
|
| 87 | The response. See :py:meth:`send_command` for details. |
|
| 88 | """ |
|
| 89 | ||
| 90 | if not name: |
|
| 91 | raise RequiredArgument( |
|
| 92 | function=self.create_audit.__name__, argument='name' |
|
| 93 | ) |
|
| 94 | if not policy_id: |
|
| 95 | raise RequiredArgument( |
|
| 96 | function=self.create_audit.__name__, argument='policy_id' |
|
| 97 | ) |
|
| 98 | ||
| 99 | if not target_id: |
|
| 100 | raise RequiredArgument( |
|
| 101 | function=self.create_audit.__name__, argument='target_id' |
|
| 102 | ) |
|
| 103 | ||
| 104 | if not scanner_id: |
|
| 105 | raise RequiredArgument( |
|
| 106 | function=self.create_audit.__name__, argument='scanner_id' |
|
| 107 | ) |
|
| 108 | ||
| 109 | # don't allow to create a container task with create_task |
|
| 110 | if target_id == '0': |
|
| 111 | raise InvalidArgument( |
|
| 112 | function=self.create_audit.__name__, argument='target_id' |
|
| 113 | ) |
|
| 114 | ||
| 115 | cmd = XmlCommand("create_task") |
|
| 116 | cmd.add_element("name", name) |
|
| 117 | cmd.add_element("usage_type", "audit") |
|
| 118 | cmd.add_element("config", attrs={"id": policy_id}) |
|
| 119 | cmd.add_element("target", attrs={"id": target_id}) |
|
| 120 | cmd.add_element("scanner", attrs={"id": scanner_id}) |
|
| 121 | ||
| 122 | if comment: |
|
| 123 | cmd.add_element("comment", comment) |
|
| 124 | ||
| 125 | if alterable is not None: |
|
| 126 | cmd.add_element("alterable", to_bool(alterable)) |
|
| 127 | ||
| 128 | if hosts_ordering: |
|
| 129 | if not isinstance(hosts_ordering, self.types.HostsOrdering): |
|
| 130 | raise InvalidArgumentType( |
|
| 131 | function=self.create_audit.__name__, |
|
| 132 | argument='hosts_ordering', |
|
| 133 | arg_type=HostsOrdering.__name__, |
|
| 134 | ) |
|
| 135 | cmd.add_element("hosts_ordering", hosts_ordering.value) |
|
| 136 | ||
| 137 | if alert_ids: |
|
| 138 | if is_list_like(alert_ids): |
|
| 139 | # parse all given alert id's |
|
| 140 | for alert in alert_ids: |
|
| 141 | cmd.add_element("alert", attrs={"id": str(alert)}) |
|
| 142 | ||
| 143 | if schedule_id: |
|
| 144 | cmd.add_element("schedule", attrs={"id": schedule_id}) |
|
| 145 | ||
| 146 | if schedule_periods is not None: |
|
| 147 | if ( |
|
| 148 | not isinstance(schedule_periods, Integral) |
|
| 149 | or schedule_periods < 0 |
|
| 150 | ): |
|
| 151 | raise InvalidArgument( |
|
| 152 | "schedule_periods must be an integer greater or equal " |
|
| 153 | "than 0" |
|
| 154 | ) |
|
| 155 | cmd.add_element("schedule_periods", str(schedule_periods)) |
|
| 156 | ||
| 157 | if observers is not None: |
|
| 158 | if not is_list_like(observers): |
|
| 159 | raise InvalidArgumentType( |
|
| 160 | function=self.create_audit.__name__, |
|
| 161 | argument='observers', |
|
| 162 | arg_type='list', |
|
| 163 | ) |
|
| 164 | ||
| 165 | # gvmd splits by comma and space |
|
| 166 | # gvmd tries to lookup each value as user name and afterwards as |
|
| 167 | # user id. So both user name and user id are possible |
|
| 168 | cmd.add_element("observers", to_comma_list(observers)) |
|
| 169 | ||
| 170 | if preferences is not None: |
|
| 171 | if not isinstance(preferences, Mapping): |
|
| 172 | raise InvalidArgumentType( |
|
| 173 | function=self.create_audit.__name__, |
|
| 174 | argument='preferences', |
|
| 175 | arg_type=Mapping.__name__, |
|
| 176 | ) |
|
| 177 | ||
| 178 | _xmlprefs = cmd.add_element("preferences") |
|
| 179 | for pref_name, pref_value in preferences.items(): |
|
| 180 | _xmlpref = _xmlprefs.add_element("preference") |
|
| 181 | _xmlpref.add_element("scanner_name", pref_name) |
|
| 182 | _xmlpref.add_element("value", str(pref_value)) |
|
| 183 | ||
| 184 | return self._send_xml_command(cmd) |
|
| 185 | ||
| 186 | def delete_audit( |
|
| 187 | self, audit_id: str, *, ultimate: Optional[bool] = False |
|
| @@ 81-192 (lines=112) @@ | ||
| 78 | ||
| 79 | return self._send_xml_command(cmd) |
|
| 80 | ||
| 81 | def create_task( |
|
| 82 | self, |
|
| 83 | name: str, |
|
| 84 | config_id: str, |
|
| 85 | target_id: str, |
|
| 86 | scanner_id: str, |
|
| 87 | *, |
|
| 88 | alterable: Optional[bool] = None, |
|
| 89 | hosts_ordering: Optional[HostsOrdering] = None, |
|
| 90 | schedule_id: Optional[str] = None, |
|
| 91 | alert_ids: Optional[List[str]] = None, |
|
| 92 | comment: Optional[str] = None, |
|
| 93 | schedule_periods: Optional[int] = None, |
|
| 94 | observers: Optional[List[str]] = None, |
|
| 95 | preferences: Optional[dict] = None, |
|
| 96 | ) -> Any: |
|
| 97 | if not name: |
|
| 98 | raise RequiredArgument( |
|
| 99 | function=self.create_task.__name__, argument='name' |
|
| 100 | ) |
|
| 101 | ||
| 102 | if not config_id: |
|
| 103 | raise RequiredArgument( |
|
| 104 | function=self.create_task.__name__, argument='config_id' |
|
| 105 | ) |
|
| 106 | ||
| 107 | if not target_id: |
|
| 108 | raise RequiredArgument( |
|
| 109 | function=self.create_task.__name__, argument='target_id' |
|
| 110 | ) |
|
| 111 | ||
| 112 | if not scanner_id: |
|
| 113 | raise RequiredArgument( |
|
| 114 | function=self.create_task.__name__, argument='scanner_id' |
|
| 115 | ) |
|
| 116 | ||
| 117 | # don't allow to create a container task with create_task |
|
| 118 | if target_id == '0': |
|
| 119 | raise InvalidArgument( |
|
| 120 | function=self.create_task.__name__, argument='target_id' |
|
| 121 | ) |
|
| 122 | ||
| 123 | cmd = XmlCommand("create_task") |
|
| 124 | cmd.add_element("name", name) |
|
| 125 | cmd.add_element("usage_type", "scan") |
|
| 126 | cmd.add_element("config", attrs={"id": config_id}) |
|
| 127 | cmd.add_element("target", attrs={"id": target_id}) |
|
| 128 | cmd.add_element("scanner", attrs={"id": scanner_id}) |
|
| 129 | ||
| 130 | if comment: |
|
| 131 | cmd.add_element("comment", comment) |
|
| 132 | ||
| 133 | if alterable is not None: |
|
| 134 | cmd.add_element("alterable", to_bool(alterable)) |
|
| 135 | ||
| 136 | if hosts_ordering: |
|
| 137 | if not isinstance(hosts_ordering, self.types.HostsOrdering): |
|
| 138 | raise InvalidArgumentType( |
|
| 139 | function=self.create_task.__name__, |
|
| 140 | argument='hosts_ordering', |
|
| 141 | arg_type=HostsOrdering.__name__, |
|
| 142 | ) |
|
| 143 | cmd.add_element("hosts_ordering", hosts_ordering.value) |
|
| 144 | ||
| 145 | if alert_ids: |
|
| 146 | if is_list_like(alert_ids): |
|
| 147 | # parse all given alert id's |
|
| 148 | for alert in alert_ids: |
|
| 149 | cmd.add_element("alert", attrs={"id": str(alert)}) |
|
| 150 | ||
| 151 | if schedule_id: |
|
| 152 | cmd.add_element("schedule", attrs={"id": schedule_id}) |
|
| 153 | ||
| 154 | if schedule_periods is not None: |
|
| 155 | if ( |
|
| 156 | not isinstance(schedule_periods, Integral) |
|
| 157 | or schedule_periods < 0 |
|
| 158 | ): |
|
| 159 | raise InvalidArgument( |
|
| 160 | "schedule_periods must be an integer greater or equal " |
|
| 161 | "than 0" |
|
| 162 | ) |
|
| 163 | cmd.add_element("schedule_periods", str(schedule_periods)) |
|
| 164 | ||
| 165 | if observers is not None: |
|
| 166 | if not is_list_like(observers): |
|
| 167 | raise InvalidArgumentType( |
|
| 168 | function=self.create_task.__name__, |
|
| 169 | argument='observers', |
|
| 170 | arg_type='list', |
|
| 171 | ) |
|
| 172 | ||
| 173 | # gvmd splits by comma and space |
|
| 174 | # gvmd tries to lookup each value as user name and afterwards as |
|
| 175 | # user id. So both user name and user id are possible |
|
| 176 | cmd.add_element("observers", to_comma_list(observers)) |
|
| 177 | ||
| 178 | if preferences is not None: |
|
| 179 | if not isinstance(preferences, Mapping): |
|
| 180 | raise InvalidArgumentType( |
|
| 181 | function=self.create_task.__name__, |
|
| 182 | argument='preferences', |
|
| 183 | arg_type=Mapping.__name__, |
|
| 184 | ) |
|
| 185 | ||
| 186 | _xmlprefs = cmd.add_element("preferences") |
|
| 187 | for pref_name, pref_value in preferences.items(): |
|
| 188 | _xmlpref = _xmlprefs.add_element("preference") |
|
| 189 | _xmlpref.add_element("scanner_name", pref_name) |
|
| 190 | _xmlpref.add_element("value", str(pref_value)) |
|
| 191 | ||
| 192 | return self._send_xml_command(cmd) |
|
| 193 | ||
| 194 | def delete_task( |
|
| 195 | self, task_id: str, *, ultimate: Optional[bool] = False |
|