FortiManager Policy

4 min

Resumo

Gerencia as configurações da política FortiManager FW usando a API jsonrpc

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
adom	string		O ADOM ao qual a configuração deve pertencer.
host	string		Endereço do FortiManager.
lock	bool		True bloqueia o ADOM, faz as atualizações de configuração necessárias, salva a configuração e desbloqueia o ADOM.
password	string		A senha associada à conta de nome de usuário.
port	interger		A porta TCP usada para conectar ao FortiManager se for diferente do padrão usado pelo método de transporte (http=80, https=443)..
provider	dict		Dicionário que atua como uma coleção de argumentos usados para definir as características de como se conectar ao dispositivo. Os argumentos hostname, username e password devem ser especificados no provedor ou no parâmetro local. Parâmetros locais têm precedência, por ex. hostname é preferível a provider["hostname"] quando ambos são especificados.
session_id	string		O session_id de uma sessão estabelecida e ativa.
state	string	present absent param_absent	O estado desejado do objeto especificado. Ausente excluirá o mapeamento do objeto, se existir. Param_absent removerá os parâmetros passados da configuração do objeto, se necessário e possível. Presente criará configuração para o mapeamento correlacionado ao fortigate especificado, se necessário.
use_ssl	bool		Determina se deve usar HTTPS(True) ou HTTP(False).
username	string		O nome de usuário usado para autenticar com o FortiManager.
validate_certs	bool		Determina se deve validar os certificados em um arquivo de certificado confiável (True) ou aceitar todos os certificados.
action	string	accept deny ipsec ssl-vpn	A ação que o dispositivo final deve executar quando a política for correspondida.
comment	string		Um comentário para adicionar ao VIP.
destination_address	list		Uma lista de destinos a serem usados para correspondência de política.
destination_intfc	list		Uma lista de destinos de interface a serem usados para correspondência de política.
direction	string	before after	A direção em que a política deve ser colocada em referência ao reference_policy.
global_label	string		Um rótulo de seção para agrupamento de políticas.
ip_pool	string	enable disable	Configurando o recurso IP Pool Nat para habilitar ou desabilitar.
label	string		Um rótulo para agrupamento de políticas.
log_traffic	string	disable all utm	Configurando Log Traffic para disable, all, ou utm(log security events).
log_traffic_start	string	enable disable	Configurando o Log Traffic Start para habilitar ou desabilitar.
match_filter	bool	true false	Determina se match_filters deve ser usado para recuperar políticas existentes. True usará match_filters para recuperar uma política correspondente. Falso não usará match_filters para recuperar uma política correspondente
match_filters	list	source_address source_intfc destination_address destination_intfc service	Este é um meio alternativo de corresponder a uma política existente quando não estiver usando policy_id ou policy_name. Os parâmetros de configuração para corresponder às políticas existentes para comparar os parâmetros do módulo com as configurações existentes. Todos os campos passados para a lista serão usados para recuperar uma correspondência exata das políticas existentes. Se várias políticas corresponderem aos parâmetros, o módulo falhará com a lista de políticas correspondentes. C(all) pode ser usado para corresponder a todos os parâmetros que são passados para o módulo
nat	string	enable disable	Configurando o NAT para habilitar ou desabilitar
nat_ip	list		O IP a ser usado para NAT quando habilitado. O primeiro IP da lista é o intervalo NAT inicial O segundo IP da lista é o intervalo NAT final
package	string		O pacote de políticas ao qual adicionar a política
permit_any_host	string	enable disable	Configurando o Permit Any Host para habilitar ou desabilitar.
policy_id	interger		O ID associado à Política.
policy_name	string		O nome da Política.
pool_name	string		O nome do pool de IP quando ativado.
reference_policy_id	string		O ID da política a ser usado como ponto de referência para posicionamento da política.
reference_policy_name	string		O nome da política a ser usado como ponto de referência para posicionamento da política.
schedule	list		A programação a ser usada para quando a política deve ser habilitada.
service	list		Uma lista de serviços usados para correspondência de política.
source_address	list		Uma lista de endereços de origem usados para correspondência de política.
source_intfc	list		A list of source interfaces used for policy matching
status	string	enable disable	O status desejado da política.

Exemplos

- name: Add Policy
  fortimgr_policy:
    host: "{{ host }}"
    username: "{{ user }}"
    password: "{{ password }}"
    adom: "prod"
    package: "prod"
    action: "accept"
    destination_address: "Internet"
    destination_intfc: "port2"
    ip_pool: "enable"
    logtraffic: "all"
    policy_name: "Permit_Outbound_Web"
    nat: "enable"
    pool_name: "Internet_PATs"
    schedule: "always"
    service: "Web_Svcs"
    source_address: "Corp_Users"
    source_intfc: "port1"
    status: "enable"
- name: Modify Policy
  fortimgr_policy:
    host: "{{ host }}"
    username: "{{ user }}"
    password: "{{ password }}"
    adom: "prod"
    package: "prod"
    policy_name: "Permit_Outbound_Web"
    service: "File_Transfer_Services"
- name: Move Policy
  fortimgr_policy:
    host: "{{ host }}"
    username: "{{ user }}"
    password: "{{ password }}"
    use_ssl: False
    adom: "lab"
    package: "prod"
    policy_name: "Permit_Outbound_Web"
    direction: "after"
    reference_policy_id: "1"
- name: Delete Policy
  fortimgr_policy:
    host: "{{ host }}"
    username: "{{ user }}"
    password: "{{ password }}"
    use_ssl: False
    adom: "lab"
    package: "prod"
    policy_name: "Permit_Outbound_Web"
    state: "absent"

Valores retornados

Chave	Tipo	Retornado quando	Descrição
existing	dict	Sempre	A configuração dynamic_mapping existente para o VIP (usa vip_name) antes da execução da tarefa.
config	dict	Sempre	A configuração que foi enviada para o FortiManager.
moved	dict	Sempre	O movimento da apólice, se especificado e necessário.
locked	bool	Quando é definido como True	O status do comando de bloqueio ADOM
saved	bool	Quando é definido como True	O status do comando ADOM save
unloked	bool	Quando é definido como True	O status do comando de desbloqueio ADOM