:source: fortios_casb_user_activity.py :orphan: .. fortios_casb_user_activity: fortios_casb_user_activity -- Configure CASB user activity in Fortinet's FortiOS and FortiGate. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. versionadded:: 2.0.0 .. contents:: :local: :depth: 1 Synopsis -------- - This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify casb feature and user_activity category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0 Requirements ------------ The below requirements are needed on the host that executes this module. - ansible>=2.15 Tips ---- Using member operation to add an element to an existing object. FortiOS Version Compatibility ----------------------------- Supported Version Ranges: v7.4.1 -> v7.6.6 Parameters ---------- .. raw:: html Notes ----- .. note:: - Legacy fortiosapi has been deprecated, httpapi is the preferred way to run playbooks - The module supports check_mode. Examples -------- .. code-block:: yaml+jinja - name: Configure CASB user activity. fortinet.fortios.fortios_casb_user_activity: vdom: "{{ vdom }}" state: "present" access_token: "" casb_user_activity: application: " (source casb.saas-application.name)" casb_name: "" category: "activity-control" control_options: - name: "default_name_7" operations: - action: "append" case_sensitive: "enable" direction: "request" header_name: "" name: "default_name_13" search_key: "" search_pattern: "simple" target: "header" value_from_input: "enable" value_name_from_input: "" values: - value: "" status: "enable" description: "" match: - id: "24" rules: - body_type: "json" case_sensitive: "enable" domains: - domain: "" header_name: "" id: "31" jq: "" match_pattern: "simple" match_value: "" methods: - method: "" negate: "enable" type: "domains" strategy: "and" tenant_extraction: filters: - body_type: "json" direction: "request" header_name: "" id: "45" place: "path" jq: "" status: "disable" type: "json-query" match_strategy: "and" name: "default_name_51" status: "enable" type: "built-in" uuid: "" Return Values ------------- Common return values are documented: https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values, the following are the fields unique to this module: .. raw:: html
  • build - Build number of the fortigate image returned: always type: str sample: 1547
  • http_method - Last method used to provision the content into FortiGate returned: always type: str sample: PUT
  • http_status - Last result given by FortiGate on last operation applied returned: always type: str sample: 200
  • mkey - Master key (id) used in the last call to FortiGate returned: success type: str sample: id
  • name - Name of the table used to fulfill the request returned: always type: str sample: urlfilter
  • path - Path of the table used to fulfill the request returned: always type: str sample: webfilter
  • revision - Internal revision number returned: always type: str sample: 17.0.2.10658
  • serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
  • status - Indication of the operation's result returned: always type: str sample: success
  • vdom - Virtual domain used returned: always type: str sample: root
  • version - Version of the FortiGate returned: always type: str sample: v5.6.3
Status ------ - This module is not guaranteed to have a backwards compatible interface. Authors ------- - Link Zheng (@chillancezen) - Jie Xue (@JieX19) - Hongbin Lu (@fgtdev-hblu) - Frank Shen (@frankshen01) - Miguel Angel Munoz (@mamunozgonzalez) - Nicolas Thomas (@thomnico) .. hint:: If you notice any issues in this documentation, you can create a pull request to improve it.