fortinet.fortimanager.fmgr_voip_profile module – Configure VoIP profiles.

Note

This module is part of the fortinet.fortimanager collection (version 2.7.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install fortinet.fortimanager.

To use it in a playbook, specify: fortinet.fortimanager.fmgr_voip_profile.

New in fortinet.fortimanager 1.0.0

Synopsis

  • This module is able to configure a FortiManager device.

  • Examples include all parameters and values which need to be adjusted to data sources before usage.

Parameters

Parameter

Comments

access_token

string

The token to access FortiManager without using username and password.

adom

string / required

The parameter (adom) in requested url.

bypass_validation

boolean

Only set to True when module schema diffs with FortiManager API structure, module continues to execute without validating parameters.

Choices:

  • false ← (default)

  • true

enable_log

boolean

Enable/Disable logging for task.

Choices:

  • false ← (default)

  • true

forticloud_access_token

string

Authenticate Ansible client with forticloud API access token.

proposed_method

string

The overridden method for the underlying Json RPC request.

Choices:

  • "update"

  • "set"

  • "add"

rc_failed

list / elements=integer

The rc codes list with which the conditions to fail will be overriden.

rc_succeeded

list / elements=integer

The rc codes list with which the conditions to succeed will be overriden.

state

string / required

The directive to create, update or delete an object.

Choices:

  • "present"

  • "absent"

voip_profile

dictionary

The top level parameters set.

comment

string

Comment.

feature-set

string

Deprecated, please rename it to feature_set. Flow or proxy inspection feature set.

Choices:

  • "flow"

  • "proxy"

  • "ips"

  • "voipd"

msrp

dictionary

Msrp.

log-violations

string

Deprecated, please rename it to log_violations. Enable/disable logging of MSRP violations.

Choices:

  • "disable"

  • "enable"

max-msg-size

integer

Deprecated, please rename it to max_msg_size. Maximum allowable MSRP message size

max-msg-size-action

string

Deprecated, please rename it to max_msg_size_action. Action for violation of max-msg-size.

Choices:

  • "pass"

  • "block"

  • "reset"

  • "monitor"

status

string

Enable/disable MSRP.

Choices:

  • "disable"

  • "enable"

name

string / required

Profile name.

sccp

dictionary

Sccp.

block-mcast

string

Deprecated, please rename it to block_mcast. Enable/disable block multicast RTP connections.

Choices:

  • "disable"

  • "enable"

log-call-summary

string

Deprecated, please rename it to log_call_summary. Enable/disable log summary of SCCP calls.

Choices:

  • "disable"

  • "enable"

log-violations

string

Deprecated, please rename it to log_violations. Enable/disable logging of SCCP violations.

Choices:

  • "disable"

  • "enable"

max-calls

integer

Deprecated, please rename it to max_calls. Maximum calls per minute per SCCP client

status

string

Enable/disable SCCP.

Choices:

  • "disable"

  • "enable"

verify-header

string

Deprecated, please rename it to verify_header. Enable/disable verify SCCP header content.

Choices:

  • "disable"

  • "enable"

sip

dictionary

Sip.

ack-rate

integer

Deprecated, please rename it to ack_rate. ACK request rate limit

ack-rate-track

string

Deprecated, please rename it to ack_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

block-ack

string

Deprecated, please rename it to block_ack. Enable/disable block ACK requests.

Choices:

  • "disable"

  • "enable"

block-bye

string

Deprecated, please rename it to block_bye. Enable/disable block BYE requests.

Choices:

  • "disable"

  • "enable"

block-cancel

string

Deprecated, please rename it to block_cancel. Enable/disable block CANCEL requests.

Choices:

  • "disable"

  • "enable"

block-geo-red-options

string

Deprecated, please rename it to block_geo_red_options. Enable/disable block OPTIONS requests, but OPTIONS requests…

Choices:

  • "disable"

  • "enable"

block-info

string

Deprecated, please rename it to block_info. Enable/disable block INFO requests.

Choices:

  • "disable"

  • "enable"

block-invite

string

Deprecated, please rename it to block_invite. Enable/disable block INVITE requests.

Choices:

  • "disable"

  • "enable"

block-long-lines

string

Deprecated, please rename it to block_long_lines. Enable/disable block requests with headers exceeding max-line-le…

Choices:

  • "disable"

  • "enable"

block-message

string

Deprecated, please rename it to block_message. Enable/disable block MESSAGE requests.

Choices:

  • "disable"

  • "enable"

block-notify

string

Deprecated, please rename it to block_notify. Enable/disable block NOTIFY requests.

Choices:

  • "disable"

  • "enable"

block-options

string

Deprecated, please rename it to block_options. Enable/disable block OPTIONS requests and no OPTIONS as notifying m…

Choices:

  • "disable"

  • "enable"

block-prack

string

Deprecated, please rename it to block_prack. Enable/disable block prack requests.

Choices:

  • "disable"

  • "enable"

block-publish

string

Deprecated, please rename it to block_publish. Enable/disable block PUBLISH requests.

Choices:

  • "disable"

  • "enable"

block-refer

string

Deprecated, please rename it to block_refer. Enable/disable block REFER requests.

Choices:

  • "disable"

  • "enable"

block-register

string

Deprecated, please rename it to block_register. Enable/disable block REGISTER requests.

Choices:

  • "disable"

  • "enable"

block-subscribe

string

Deprecated, please rename it to block_subscribe. Enable/disable block SUBSCRIBE requests.

Choices:

  • "disable"

  • "enable"

block-unknown

string

Deprecated, please rename it to block_unknown. Block unrecognized SIP requests

Choices:

  • "disable"

  • "enable"

block-update

string

Deprecated, please rename it to block_update. Enable/disable block UPDATE requests.

Choices:

  • "disable"

  • "enable"

bye-rate

integer

Deprecated, please rename it to bye_rate. BYE request rate limit

bye-rate-track

string

Deprecated, please rename it to bye_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

call-id-regex

string

Deprecated, please rename it to call_id_regex. Validate PCRE regular expression for Call-Id header value.

call-keepalive

integer

Deprecated, please rename it to call_keepalive. Continue tracking calls with no RTP for this many minutes.

cancel-rate

integer

Deprecated, please rename it to cancel_rate. CANCEL request rate limit

cancel-rate-track

string

Deprecated, please rename it to cancel_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

contact-fixup

string

Deprecated, please rename it to contact_fixup. Fixup contact anyway even if contacts IP

Choices:

  • "disable"

  • "enable"

content-type-regex

string

Deprecated, please rename it to content_type_regex. Validate PCRE regular expression for Content-Type header value.

hnt-restrict-source-ip

string

Deprecated, please rename it to hnt_restrict_source_ip. Enable/disable restrict RTP source IP to be the same as SI…

Choices:

  • "disable"

  • "enable"

hosted-nat-traversal

string

Deprecated, please rename it to hosted_nat_traversal. Hosted NAT Traversal

Choices:

  • "disable"

  • "enable"

info-rate

integer

Deprecated, please rename it to info_rate. INFO request rate limit

info-rate-track

string

Deprecated, please rename it to info_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

invite-rate

integer

Deprecated, please rename it to invite_rate. INVITE request rate limit

invite-rate-track

string

Deprecated, please rename it to invite_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

ips-rtp

string

Deprecated, please rename it to ips_rtp. Enable/disable allow IPS on RTP.

Choices:

  • "disable"

  • "enable"

log-call-summary

string

Deprecated, please rename it to log_call_summary. Enable/disable logging of SIP call summary.

Choices:

  • "disable"

  • "enable"

log-violations

string

Deprecated, please rename it to log_violations. Enable/disable logging of SIP violations.

Choices:

  • "disable"

  • "enable"

malformed-header-allow

string

Deprecated, please rename it to malformed_header_allow. Action for malformed Allow header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-call-id

string

Deprecated, please rename it to malformed_header_call_id. Action for malformed Call-ID header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-contact

string

Deprecated, please rename it to malformed_header_contact. Action for malformed Contact header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-content-length

string

Deprecated, please rename it to malformed_header_content_length. Action for malformed Content-Length header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-content-type

string

Deprecated, please rename it to malformed_header_content_type. Action for malformed Content-Type header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-cseq

string

Deprecated, please rename it to malformed_header_cseq. Action for malformed CSeq header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-expires

string

Deprecated, please rename it to malformed_header_expires. Action for malformed Expires header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-from

string

Deprecated, please rename it to malformed_header_from. Action for malformed From header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-max-forwards

string

Deprecated, please rename it to malformed_header_max_forwards. Action for malformed Max-Forwards header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-no-proxy-require

string

Deprecated, please rename it to malformed_header_no_proxy_require. Action for malformed SIP messages without Proxy…

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-no-require

string

Deprecated, please rename it to malformed_header_no_require. Action for malformed SIP messages without Require header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-p-asserted-identity

string

Deprecated, please rename it to malformed_header_p_asserted_identity. Action for malformed P-Asserted-Identity header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-rack

string

Deprecated, please rename it to malformed_header_rack. Action for malformed RAck header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-record-route

string

Deprecated, please rename it to malformed_header_record_route. Action for malformed Record-Route header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-route

string

Deprecated, please rename it to malformed_header_route. Action for malformed Route header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-rseq

string

Deprecated, please rename it to malformed_header_rseq. Action for malformed RSeq header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-a

string

Deprecated, please rename it to malformed_header_sdp_a. Action for malformed SDP a line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-b

string

Deprecated, please rename it to malformed_header_sdp_b. Action for malformed SDP b line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-c

string

Deprecated, please rename it to malformed_header_sdp_c. Action for malformed SDP c line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-i

string

Deprecated, please rename it to malformed_header_sdp_i. Action for malformed SDP i line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-k

string

Deprecated, please rename it to malformed_header_sdp_k. Action for malformed SDP k line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-m

string

Deprecated, please rename it to malformed_header_sdp_m. Action for malformed SDP m line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-o

string

Deprecated, please rename it to malformed_header_sdp_o. Action for malformed SDP o line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-r

string

Deprecated, please rename it to malformed_header_sdp_r. Action for malformed SDP r line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-s

string

Deprecated, please rename it to malformed_header_sdp_s. Action for malformed SDP s line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-t

string

Deprecated, please rename it to malformed_header_sdp_t. Action for malformed SDP t line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-v

string

Deprecated, please rename it to malformed_header_sdp_v. Action for malformed SDP v line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-sdp-z

string

Deprecated, please rename it to malformed_header_sdp_z. Action for malformed SDP z line.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-to

string

Deprecated, please rename it to malformed_header_to. Action for malformed To header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-header-via

string

Deprecated, please rename it to malformed_header_via. Action for malformed VIA header.

Choices:

  • "pass"

  • "discard"

  • "respond"

malformed-request-line

string

Deprecated, please rename it to malformed_request_line. Action for malformed request line.

Choices:

  • "pass"

  • "discard"

  • "respond"

max-body-length

integer

Deprecated, please rename it to max_body_length. Maximum SIP message body length

max-dialogs

integer

Deprecated, please rename it to max_dialogs. Maximum number of concurrent calls/dialogs

max-idle-dialogs

integer

Deprecated, please rename it to max_idle_dialogs. Maximum number established but idle dialogs to retain

max-line-length

integer

Deprecated, please rename it to max_line_length. Maximum SIP header line length

message-rate

integer

Deprecated, please rename it to message_rate. MESSAGE request rate limit

message-rate-track

string

Deprecated, please rename it to message_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

nat-port-range

string

Deprecated, please rename it to nat_port_range. RTP NAT port range.

nat-trace

string

Deprecated, please rename it to nat_trace. Enable/disable preservation of original IP in SDP i line.

Choices:

  • "disable"

  • "enable"

no-sdp-fixup

string

Deprecated, please rename it to no_sdp_fixup. Enable/disable no SDP fix-up.

Choices:

  • "disable"

  • "enable"

notify-rate

integer

Deprecated, please rename it to notify_rate. NOTIFY request rate limit

notify-rate-track

string

Deprecated, please rename it to notify_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

open-contact-pinhole

string

Deprecated, please rename it to open_contact_pinhole. Enable/disable open pinhole for non-REGISTER Contact port.

Choices:

  • "disable"

  • "enable"

open-record-route-pinhole

string

Deprecated, please rename it to open_record_route_pinhole. Enable/disable open pinhole for Record-Route port.

Choices:

  • "disable"

  • "enable"

open-register-pinhole

string

Deprecated, please rename it to open_register_pinhole. Enable/disable open pinhole for REGISTER Contact port.

Choices:

  • "disable"

  • "enable"

open-via-pinhole

string

Deprecated, please rename it to open_via_pinhole. Enable/disable open pinhole for Via port.

Choices:

  • "disable"

  • "enable"

options-rate

integer

Deprecated, please rename it to options_rate. OPTIONS request rate limit

options-rate-track

string

Deprecated, please rename it to options_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

prack-rate

integer

Deprecated, please rename it to prack_rate. PRACK request rate limit

prack-rate-track

string

Deprecated, please rename it to prack_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

preserve-override

string

Deprecated, please rename it to preserve_override. Override i line to preserve original IPS

Choices:

  • "disable"

  • "enable"

provisional-invite-expiry-time

integer

Deprecated, please rename it to provisional_invite_expiry_time. Expiry time for provisional INVITE

publish-rate

integer

Deprecated, please rename it to publish_rate. PUBLISH request rate limit

publish-rate-track

string

Deprecated, please rename it to publish_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

refer-rate

integer

Deprecated, please rename it to refer_rate. REFER request rate limit

refer-rate-track

string

Deprecated, please rename it to refer_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

register-contact-trace

string

Deprecated, please rename it to register_contact_trace. Enable/disable trace original IP/port within the contact h…

Choices:

  • "disable"

  • "enable"

register-rate

integer

Deprecated, please rename it to register_rate. REGISTER request rate limit

register-rate-track

string

Deprecated, please rename it to register_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

rfc2543-branch

string

Deprecated, please rename it to rfc2543_branch. Enable/disable support via branch compliant with RFC 2543.

Choices:

  • "disable"

  • "enable"

rtp

string

Enable/disable create pinholes for RTP traffic to traverse firewall.

Choices:

  • "disable"

  • "enable"

ssl-algorithm

string

Deprecated, please rename it to ssl_algorithm. Relative strength of encryption algorithms accepted in negotiation.

Choices:

  • "high"

  • "medium"

  • "low"

ssl-auth-client

string

Deprecated, please rename it to ssl_auth_client. Require a client certificate and authenticate it with the peer/pe…

ssl-auth-server

string

Deprecated, please rename it to ssl_auth_server. Authenticate the servers certificate with the peer/peergrp.

ssl-client-certificate

string

Deprecated, please rename it to ssl_client_certificate. Name of Certificate to offer to server if requested.

ssl-client-renegotiation

string

Deprecated, please rename it to ssl_client_renegotiation. Allow/block client renegotiation by server.

Choices:

  • "allow"

  • "deny"

  • "secure"

ssl-max-version

string

Deprecated, please rename it to ssl_max_version. Highest SSL/TLS version to negotiate.

Choices:

  • "ssl-3.0"

  • "tls-1.0"

  • "tls-1.1"

  • "tls-1.2"

  • "tls-1.3"

ssl-min-version

string

Deprecated, please rename it to ssl_min_version. Lowest SSL/TLS version to negotiate.

Choices:

  • "ssl-3.0"

  • "tls-1.0"

  • "tls-1.1"

  • "tls-1.2"

  • "tls-1.3"

ssl-mode

string

Deprecated, please rename it to ssl_mode. SSL/TLS mode for encryption & decryption of traffic.

Choices:

  • "off"

  • "full"

ssl-pfs

string

Deprecated, please rename it to ssl_pfs. SSL Perfect Forward Secrecy.

Choices:

  • "require"

  • "deny"

  • "allow"

ssl-send-empty-frags

string

Deprecated, please rename it to ssl_send_empty_frags. Send empty fragments to avoid attack on CBC IV

Choices:

  • "disable"

  • "enable"

ssl-server-certificate

string

Deprecated, please rename it to ssl_server_certificate. Name of Certificate return to the client in every SSL conn…

status

string

Enable/disable SIP.

Choices:

  • "disable"

  • "enable"

strict-register

string

Deprecated, please rename it to strict_register. Enable/disable only allow the registrar to connect.

Choices:

  • "disable"

  • "enable"

subscribe-rate

integer

Deprecated, please rename it to subscribe_rate. SUBSCRIBE request rate limit

subscribe-rate-track

string

Deprecated, please rename it to subscribe_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

unknown-header

string

Deprecated, please rename it to unknown_header. Action for unknown SIP header.

Choices:

  • "pass"

  • "discard"

  • "respond"

update-rate

integer

Deprecated, please rename it to update_rate. UPDATE request rate limit

update-rate-track

string

Deprecated, please rename it to update_rate_track. Track the packet protocol field.

Choices:

  • "none"

  • "src-ip"

  • "dest-ip"

workspace_locking_adom

string

The adom to lock for FortiManager running in workspace mode, the value can be global and others including root.

workspace_locking_timeout

integer

The maximum time in seconds to wait for other user to release the workspace lock.

Default: 300

Notes

Note

  • Starting in version 2.4.0, all input arguments are named using the underscore naming convention (snake_case). Please change the arguments such as “var-name” to “var_name”. Old argument names are still available yet you will receive deprecation warnings. You can ignore this warning by setting deprecation_warnings=False in ansible.cfg.

  • Running in workspace locking mode is supported in this FortiManager module, the top level parameters workspace_locking_adom and workspace_locking_timeout help do the work.

  • To create or update an object, use state present directive.

  • To delete an object, use state absent directive.

  • Normally, running one module can fail when a non-zero rc is returned. you can also override the conditions to fail or succeed with parameters rc_failed and rc_succeeded

Examples

- name: Example playbook (generated based on argument schema)
  hosts: fortimanagers
  connection: httpapi
  vars:
    ansible_httpapi_use_ssl: true
    ansible_httpapi_validate_certs: false
    ansible_httpapi_port: 443
  tasks:
    - name: Configure VoIP profiles.
      fortinet.fortimanager.fmgr_voip_profile:
        # bypass_validation: false
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        # rc_succeeded: [0, -2, -3, ...]
        # rc_failed: [-2, -3, ...]
        adom: <your own value>
        state: present # <value in [present, absent]>
        voip_profile:
          comment: <string>
          name: <string>
          sccp:
            block_mcast: <value in [disable, enable]>
            log_call_summary: <value in [disable, enable]>
            log_violations: <value in [disable, enable]>
            max_calls: <integer>
            status: <value in [disable, enable]>
            verify_header: <value in [disable, enable]>
          sip:
            ack_rate: <integer>
            block_ack: <value in [disable, enable]>
            block_bye: <value in [disable, enable]>
            block_cancel: <value in [disable, enable]>
            block_geo_red_options: <value in [disable, enable]>
            block_info: <value in [disable, enable]>
            block_invite: <value in [disable, enable]>
            block_long_lines: <value in [disable, enable]>
            block_message: <value in [disable, enable]>
            block_notify: <value in [disable, enable]>
            block_options: <value in [disable, enable]>
            block_prack: <value in [disable, enable]>
            block_publish: <value in [disable, enable]>
            block_refer: <value in [disable, enable]>
            block_register: <value in [disable, enable]>
            block_subscribe: <value in [disable, enable]>
            block_unknown: <value in [disable, enable]>
            block_update: <value in [disable, enable]>
            bye_rate: <integer>
            call_keepalive: <integer>
            cancel_rate: <integer>
            contact_fixup: <value in [disable, enable]>
            hnt_restrict_source_ip: <value in [disable, enable]>
            hosted_nat_traversal: <value in [disable, enable]>
            info_rate: <integer>
            invite_rate: <integer>
            ips_rtp: <value in [disable, enable]>
            log_call_summary: <value in [disable, enable]>
            log_violations: <value in [disable, enable]>
            malformed_header_allow: <value in [pass, discard, respond]>
            malformed_header_call_id: <value in [pass, discard, respond]>
            malformed_header_contact: <value in [pass, discard, respond]>
            malformed_header_content_length: <value in [pass, discard, respond]>
            malformed_header_content_type: <value in [pass, discard, respond]>
            malformed_header_cseq: <value in [pass, discard, respond]>
            malformed_header_expires: <value in [pass, discard, respond]>
            malformed_header_from: <value in [pass, discard, respond]>
            malformed_header_max_forwards: <value in [pass, discard, respond]>
            malformed_header_p_asserted_identity: <value in [pass, discard, respond]>
            malformed_header_rack: <value in [pass, discard, respond]>
            malformed_header_record_route: <value in [pass, discard, respond]>
            malformed_header_route: <value in [pass, discard, respond]>
            malformed_header_rseq: <value in [pass, discard, respond]>
            malformed_header_sdp_a: <value in [pass, discard, respond]>
            malformed_header_sdp_b: <value in [pass, discard, respond]>
            malformed_header_sdp_c: <value in [pass, discard, respond]>
            malformed_header_sdp_i: <value in [pass, discard, respond]>
            malformed_header_sdp_k: <value in [pass, discard, respond]>
            malformed_header_sdp_m: <value in [pass, discard, respond]>
            malformed_header_sdp_o: <value in [pass, discard, respond]>
            malformed_header_sdp_r: <value in [pass, discard, respond]>
            malformed_header_sdp_s: <value in [pass, discard, respond]>
            malformed_header_sdp_t: <value in [pass, discard, respond]>
            malformed_header_sdp_v: <value in [pass, discard, respond]>
            malformed_header_sdp_z: <value in [pass, discard, respond]>
            malformed_header_to: <value in [pass, discard, respond]>
            malformed_header_via: <value in [pass, discard, respond]>
            malformed_request_line: <value in [pass, discard, respond]>
            max_body_length: <integer>
            max_dialogs: <integer>
            max_idle_dialogs: <integer>
            max_line_length: <integer>
            message_rate: <integer>
            nat_port_range: <string>
            nat_trace: <value in [disable, enable]>
            no_sdp_fixup: <value in [disable, enable]>
            notify_rate: <integer>
            open_contact_pinhole: <value in [disable, enable]>
            open_record_route_pinhole: <value in [disable, enable]>
            open_register_pinhole: <value in [disable, enable]>
            open_via_pinhole: <value in [disable, enable]>
            options_rate: <integer>
            prack_rate: <integer>
            preserve_override: <value in [disable, enable]>
            provisional_invite_expiry_time: <integer>
            publish_rate: <integer>
            refer_rate: <integer>
            register_contact_trace: <value in [disable, enable]>
            register_rate: <integer>
            rfc2543_branch: <value in [disable, enable]>
            rtp: <value in [disable, enable]>
            ssl_algorithm: <value in [high, medium, low]>
            ssl_auth_client: <string>
            ssl_auth_server: <string>
            ssl_client_certificate: <string>
            ssl_client_renegotiation: <value in [allow, deny, secure]>
            ssl_max_version: <value in [ssl-3.0, tls-1.0, tls-1.1, ...]>
            ssl_min_version: <value in [ssl-3.0, tls-1.0, tls-1.1, ...]>
            ssl_mode: <value in [off, full]>
            ssl_pfs: <value in [require, deny, allow]>
            ssl_send_empty_frags: <value in [disable, enable]>
            ssl_server_certificate: <string>
            status: <value in [disable, enable]>
            strict_register: <value in [disable, enable]>
            subscribe_rate: <integer>
            unknown_header: <value in [pass, discard, respond]>
            update_rate: <integer>
            ack_rate_track: <value in [none, src-ip, dest-ip]>
            bye_rate_track: <value in [none, src-ip, dest-ip]>
            cancel_rate_track: <value in [none, src-ip, dest-ip]>
            info_rate_track: <value in [none, src-ip, dest-ip]>
            invite_rate_track: <value in [none, src-ip, dest-ip]>
            malformed_header_no_proxy_require: <value in [pass, discard, respond]>
            malformed_header_no_require: <value in [pass, discard, respond]>
            message_rate_track: <value in [none, src-ip, dest-ip]>
            notify_rate_track: <value in [none, src-ip, dest-ip]>
            options_rate_track: <value in [none, src-ip, dest-ip]>
            prack_rate_track: <value in [none, src-ip, dest-ip]>
            publish_rate_track: <value in [none, src-ip, dest-ip]>
            refer_rate_track: <value in [none, src-ip, dest-ip]>
            register_rate_track: <value in [none, src-ip, dest-ip]>
            subscribe_rate_track: <value in [none, src-ip, dest-ip]>
            update_rate_track: <value in [none, src-ip, dest-ip]>
            call_id_regex: <string>
            content_type_regex: <string>
          feature_set: <value in [flow, proxy, ips, ...]>
          msrp:
            log_violations: <value in [disable, enable]>
            max_msg_size: <integer>
            max_msg_size_action: <value in [pass, block, reset, ...]>
            status: <value in [disable, enable]>

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

meta

dictionary

The result of the request.

Returned: always

request_url

string

The full url requested.

Returned: always

Sample: "/sys/login/user"

response_code

integer

The status of api request.

Returned: always

Sample: 0

response_data

list / elements=string

The api response.

Returned: always

response_message

string

The descriptive message of the api response.

Returned: always

Sample: "OK."

system_information

dictionary

The information of the target system.

Returned: always

rc

integer

The status the request.

Returned: always

Sample: 0

version_check_warning

list / elements=string

Warning if the parameters used in the playbook are not supported by the current FortiManager version.

Returned: complex

Authors

  • Xinwei Du (@dux-fortinet)

  • Xing Li (@lix-fortinet)

  • Jie Xue (@JieX19)

  • Link Zheng (@chillancezen)

  • Frank Shen (@fshen01)

  • Hongbin Lu (@fgtdev-hblu)